FART-F1
Mobile-first fantasy F1 draft pool for 4 players. Each race weekend you draft 5 drivers; lowest cumulative finishing positions wins the season (golf-style scoring).
Stack
Next.js 16 (App Router) · TypeScript · Tailwind v4 · Vitest · Supabase (Postgres + Realtime) · Vercel.
Local dev
npm install
cp .env.local.example .env.local # then paste your Supabase values
npm run dev
.env.local needs:
NEXT_PUBLIC_SUPABASE_URL= # Project URL from Supabase → Settings → API
NEXT_PUBLIC_SUPABASE_ANON_KEY= # anon public key (JWT, ~200+ chars)
SUPABASE_SERVICE_ROLE_KEY= # service_role key (JWT, ~200+ chars) — server only
SUPABASE_DB_URL= # Postgres connection string for migrations + sync script
F1_SEASON=2024
One-time setup
npm run db:apply # creates tables + seeds the 4 players via SUPABASE_DB_URL
npm run sync:season # fetches Jolpica + OpenF1 for every round of F1_SEASON, upserts to DB
db:apply is idempotent (CREATE IF NOT EXISTS, ON CONFLICT DO NOTHING). sync:season runs through round 24, breaking on the first empty round.
Syncing results
Results are synced manually — there is no scheduled or automatic sync. The commissioner hits the Sync button on /admin (which POSTs to /api/sync) to refresh a round. OpenF1 keeps a session on its paid real-time tier until ~30 min after it ends, so syncing within that window stores the provisional finishing order; syncing again once Jolpica's official classification posts (penalties applied) overwrites it.
How it works
- Pick your name (
/) — tap a player; the choice persists in localStorage.
- Admin (
/admin, commissioner only) — Sync a round, set draft order, open the draft, undo, close & score.
- Draft (
/draft) — straight 1-2-3-4 order for 5 rounds. Picks broadcast live to all devices via Supabase Realtime. Anyone can pick on behalf of an absent player; the actor is stamped separately.
- Standings (
/standings) — cumulative golf scoring across every race marked complete.
Scoring
A driver scores their finishing position (winner = 1, 20th = 20). A player's weekly total is the sum of their 5 drivers. Season total adds across weeks. Lower is better.
Scripts
| Script | What it does |
|---|
npm run dev | Next dev server on http://localhost:3000 |
npm run build | Production build + typecheck |
npm test | Vitest run (pure parser / scoring / draft engine tests) |
npm run db:apply | Apply migration + seed via direct Postgres |
npm run sync:season | Backfill a full F1 season via Jolpica + OpenF1 |
Deploying
See Vercel + env-var steps in MORNING.md for the current bootstrap state.
Architecture boundaries
src/lib/f1/parse.ts, src/lib/scoring/score.ts, src/lib/draft/engine.ts are pure (no I/O) and carry the unit tests.src/lib/f1/sync.ts and src/lib/draft/service.ts own all DB / realtime I/O.src/components/* are presentational; src/app/**/page.tsx wires data + context.
