Polymatch is a multiplayer web application (pool/prediction game) to predict the FIFA World Cup 2026 (USA · Canada · Mexico). Participants predict scores for all 104 matches, build their knockout bracket, and compete for the top ranking.

Designed for playing with friends, with a transparent scoring system and a football-inspired design centered on the tournament experience.

• Match predictions for all 104 matches (12 groups of 4 + knockout stages).
• Knockout bracket generated from your predictions (Round of 32 → Final).
• Individual awards: Top Scorer, Top Assist, Best Player, Best Goalkeeper, Champion and Runner-up.
• Live leaderboard with transparent scoring system visible to users.
• Official calendar with venues, times and timezones.
• Authentication with username and password (NextAuth).
• Admin panel for tournament results and awards.
• SEO optimized (OpenGraph, sitemap, robots, JSON-LD SportsEvent).
• Dark-first design inspired by the 2026 World Cup visual identity.

• Node.js 20+
• PostgreSQL 17 running locally or remotely
• npm (or pnpm / yarn / bun)

# 1. Clone the repository
git clone https://github.com/DavidSepulvedaCh/Polymatch.git
cd Polymatch

# 2. Install dependencies (triggers prisma generate in postinstall)
npm install

# 3. Copy environment variables and adjust them
cp .env.example .env

# 4. Apply migrations
npm run db:migrate

# 5. Populate with official FIFA data (teams, groups, schedule)
npm run db:seed

# 6. Start the dev server
npm run dev

Open http://localhost:3000 to see the application.

See .env.example as a template.

src/
├── app/                   # Routes (App Router)
│   ├── admin/             # Admin panel
│   ├── api/               # Route handlers (NextAuth, etc.)
│   ├── fixtures/          # Match schedule
│   ├── predictions/       # User predictions and bracket
│   ├── ranking/           # Leaderboard
│   ├── login/ · register/ # Authentication
│   ├── settings/          # User preferences
│   ├── opengraph-image.tsx  # Dynamic OG image
│   ├── icon.png · apple-icon.png
│   ├── robots.ts · sitemap.ts
│   └── layout.tsx · page.tsx
├── components/            # Reusable UI components
├── lib/                   # Utilities (prisma, session, datetime, ...)
└── types/                 # Shared types

prisma/
├── schema.prisma          # Data model
├── migrations/            # Versioned migrations
├── seed.ts                # Seed script
└── fifa-data.ts           # Official FIFA 2026 data

The application is optimized for Vercel, but runs on any Node.js-compatible platform.

1. Provision a PostgreSQL database (Neon, Supabase, Railway, etc.).
2. Configure DATABASE_URL and NEXT_PUBLIC_SITE_URL in the production environment.
3. Run prisma migrate deploy as a pre-build step.
4. npm run build && npm start.

This is a personal project, but suggestions and bug reports are welcome via Issues or Pull Requests.

Distributed under the MIT license. See LICENSE for more information.