Friends betting pool for FIFA World Cup 2026 — predict scores, track live results, climb the ranking, and compete for the prize pool.
→ Open the app · Rules & scoring · Report a bug
A fullstack World Cup 2026 betting pool app for friends. Mobile-first, real-time scoring, admin-managed.
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router, RSC, Server Actions, Turbopack) |
| UI | Tailwind CSS 4, Oswald + Inter fonts |
| Auth | NextAuth v5 (Credentials, JWT) |
| Database | PostgreSQL 17 (Neon serverless) |
| ORM | Prisma 6 with @prisma/adapter-neon (WebSocket) |
| Validation | Zod 4 |
| Runtime | Node.js 20+ |
- User registration with admin approval (payment-gated)
- Match betting — predict scores for all 104 World Cup matches
- Automated scoring — exact score (10pts), correct winner + 1 score (7pts), correct winner (5pts), correct draw (5pts), 1 score correct (2pts)
- Phase multipliers — knockout rounds multiply points (1.25× to 3×)
- Live ranking with tiebreakers and position change tracking
- Prize distribution — 1st (60%), 2nd (25%), 3rd (15%) of the pool
- API sync — football-data.org integration for automatic score updates
- Knockout bracket — interactive mata-mata tree with live team resolution
- Knockout hints — shows possible teams for undecided bracket matches
- Admin dashboard — approve users, enter/sync results, view ranking + prizes
- Responsive — mobile bottom nav + desktop sidebar
- FIFA 2026 branding — diagonal background split with official World Cup pattern
- Analytics — Vercel Analytics + SpeedInsights
- Node.js 20+
- A Neon PostgreSQL database (free tier works)
Create a .env file:
DATABASE_URL="postgresql://user:pass@host/db?sslmode=require&pgbouncer=true"
AUTH_SECRET="your-secret-here"
AUTH_URL="http://localhost:3000"
ADMIN_PASSWORD="your-strong-admin-password"
NEXT_PUBLIC_PIX_KEY="your-pix-key"
NEXT_PUBLIC_ENTRY_FEE="50.00"
FOOTBALL_DATA_API_KEY="your-football-data-org-key"
CRON_SECRET="your-cron-secret"
NEXT_PUBLIC_VAPID_PUBLIC_KEY="your-vapid-public-key"
VAPID_PRIVATE_KEY="your-vapid-private-key"
VAPID_SUBJECT="mailto:admin@example.com"Generate VAPID keys with: npx web-push generate-vapid-keys
npm install
npm run db:push # push schema to database
npm run db:seed # seed matches + admin user
npm run dev # start dev server (http://localhost:3000)| Command | Description |
|---|---|
npm run dev |
Start dev server with Turbopack |
npm run lint |
Run ESLint |
npm test |
Run all unit tests |
npm run build |
Production build |
npm run start |
Start production server |
npm run db:push |
Push Prisma schema to DB |
npm run db:seed |
Seed 104 matches + admin user |
npm run db:reset |
Reset DB + reseed |
Production runs on Vercel with Neon PostgreSQL. Background jobs (live score sync, finished results, daily reminders) run on GitHub Actions to stay within Vercel's free tier.
app/
├── (main)/ # Authenticated shell (dashboard, matches, ranking, bracket, stats…)
├── admin/ # Admin panel (users, results)
├── actions/ # Server Actions (auth, bets, admin, profile)
├── api/ # Route handlers (cron, matches, auth, push)
└── login|register|pending|rejected/ # Auth lifecycle pages
components/
├── ui/ # Primitives (Button, Input, Badge)
├── bracket/ # Knockout bracket tree
├── stats/ # Charts and standings
└── *.tsx # Feature components (match cards, ranking, forms)
lib/
├── jobs/ # Background job runners (sync scores, reminders)
├── auth*.ts # NextAuth config and guards
├── match-*.ts # Live scores, sync, goals
├── knockout-*.ts # Bracket resolution and hints
├── scoring.ts # Points calculation
├── ranking.ts # Leaderboard and tiebreakers
└── prisma.ts # Database client (Neon)
prisma/
├── schema.prisma # Database schema
├── seed.ts # Seed matches + admin user
├── migrations/ # Formal Prisma migrations
└── scripts/ # One-off DDL / data patch scripts (legacy)
scripts/
├── run-tests.ts # Test runner (used by npm test)
├── sync-*.ts # GitHub Actions cron entrypoints
├── deadline-reminder.ts
├── recalculate-match-points.ts
└── dev/ # Local dev utilities (test-db, test-api)
tests/ # Unit tests (*.test.ts)
| Result | Points |
|---|---|
| Exact score | 10 |
| Correct winner + 1 correct score | 7 |
| Correct winner only | 5 |
| Correct draw (different score) | 5 |
| 1 score correct (wrong winner) | 2 |
| Wrong / didn't bet | 0 |
Points are multiplied by phase: Group (1×), R32 (1.25×), Round of 16 (1.5×), Quarters (2×), Semis (2.5×), Final (3×).
| Place | Share |
|---|---|
| 1st | 60% |
| 2nd | 25% |
| 3rd | 15% |
Pool = number of approved participants × entry fee (default R$50).
This project is licensed under the MIT License.