ARTIFEX
Live site: https://artifex-zeta-five.vercel.app · participants: /play · leaderboard: /leaderboard
The event website for ARTIFEX, Techvidya's 10-minute poster and flyer design competition:
- registration;
- a server-timed shared round;
- private uploads with receipts;
- manual or Gemini AI judging (cancellable);
- a published leaderboard and projector board.
Stack: Next.js 15 · Supabase (Postgres + RLS, Auth, Storage, Edge Function) · Gemini API · Tailwind v4 · Vitest.
Run it locally
Needs Node 22, Docker and the Supabase CLI.
npm install
supabase start # local Postgres, Auth, Storage
supabase db reset # apply migrations
supabase functions serve # participant-signup (keep running)
# .env.local: create it with the variables in docs/TRD.md › Environment variables (values from `supabase status`, plus GEMINI_API_KEY)
npm run dev # http://127.0.0.1:3000
npm run create-staff -- --email [email protected] --role admin
Live admin login: ADMIN_EMAIL and ADMIN_PASSWORD in .env.local. To change the password, edit ADMIN_PASSWORD and run npm run admin:sync. It updates the account on the live Supabase project (needs PROD_SUPABASE_URL and PROD_SUPABASE_SERVICE_ROLE_KEY in .env.local).
Pages:
/: landing/rules/play: participants/admin: staff/leaderboard/screen: projector
Test
npm test # unit tests
npm run test:integration # anonymous-attacker checks against TEST_SUPABASE_URL
npm run bot-test -- --bots 20 # full event with ≥ 20 bots (app must be running)
AI_JUDGE_FAKE=1 npm run dev # optional: free dry run of AI judging without Gemini
npm run build && npm run check:secrets # production build + bundle secret scan
Docs
