F1 Prediction 🏎️
A fun, friendly Formula 1 prediction game built for competing with friends — not a gambling or betting platform.
Predict race podiums, sprint results, and season-long championships, earn points based on accuracy, and climb the leaderboard. The goal is simple: bragging rights among friends who love F1.
Live app: f1-prediction.vercel.app
Purpose
F1 Prediction is a hobby project that turns every Grand Prix weekend into a friendly competition. Players forecast race outcomes, sprint results, and championship winners; the app scores predictions against the official results and tracks who's the sharpest tipster across the season. It exists to make watching F1 with friends more engaging — no money, no stakes, just bragging rights.
Features
- Race Predictions — Top 10 finishers, fastest lap, pole position, and fastest pit stop for each Grand Prix.
- Sprint Predictions — Top 8 finishers for sprint weekends.
- Championship Predictions — Pre-season picks for the World Drivers' Champion (WDC) and World Constructors' Champion (WCC).
- Points & Scoring — Accuracy-based scoring with bonuses for perfect podiums and perfect top 10/8 predictions.
- Leaderboard — Live ranking of all participants with detailed and per-race views.
- Achievements — Unlockable milestones based on prediction performance.
- Dashboard — A bento-grid home page with points, upcoming race countdown, recent predictions, leaderboard snapshot, and achievements.
- Bilingual UI — English and Spanish, switchable at runtime.
- Admin Panel — Enter race results manually, trigger scoring, and recalculate achievements.
Tech Stack
| Layer | Technology |
|---|
| Framework | Next.js (App Router, React Server Components) |
| Language | TypeScript |
| Styling | Tailwind CSS |
| Auth & Database | Supabase (Postgres with RLS) |
| Race Results | Entered manually by an admin (the meeting_key and source columns are retained as a hook for a future results provider) |
| Hosting | Vercel |
| Icons | Lucide React |
The codebase is an npm-workspaces monorepo: the Next.js app lives in apps/web, and all framework-agnostic business logic (scoring, achievements, types, translations) lives in packages/shared so it can be reused by the upcoming React Native mobile app. It follows a strict layered architecture: pages and API routes delegate to shared pure functions (scoring, utilities) and service functions (Supabase I/O), with all UI text routed through a bilingual i18n system.
Getting Started
git clone https://github.com/fedesanchezvidarte/f1-prediction.git
cd f1-prediction
npm install
Create apps/web/.env.local (copy from apps/web/.env.example) with your Supabase project's publishable values:
NEXT_PUBLIC_SUPABASE_URL=https://<your-project-ref>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<your-anon-key>
Both values are in your Supabase dashboard under Settings → API. They are publishable (safe for the browser); data access is protected by Row Level Security.
Then run from the repo root:
npm run dev # dev server at http://localhost:3000
npm test # Jest test suite
npm run lint # ESLint
npm run typecheck # TypeScript
Documentation
For an in-depth look at the architecture, data model, and features, see the DeepWiki documentation.
Disclaimer
This application is a hobby project made purely for fun among friends. It is not intended for gambling, betting, or any form of monetary exchange. No real money is involved — just friendly competition and love for the sport.
