Pit Lane Hub

Formula 1 calendar, results, standings, live timing, driver and team pages, and championship history. Live site: f1-xi-weld.vercel.app.

Unofficial fan site. Not affiliated with Formula 1, the FIA or any team.

Stack

• Next.js 16 (App Router), React 19, CSS Modules
• Auth.js v5 with the Prisma adapter (verified password accounts and Resend magic links)
• PostgreSQL via Prisma
• Polar for the optional Pit Lane Pro subscription
• Vitest for unit tests, Playwright for smoke tests

Setup

Requirements: Node.js 20 or newer, npm, and PostgreSQL if you need accounts. The F1 pages work without a database.

git clone https://github.com/justAbdulaziz10/Pit-Lane-Hub.git
cd Pit-Lane-Hub
npm ci                         # also runs `prisma generate`
cp .env.example .env.local     # then fill in the values
npx prisma migrate deploy      # apply the schema (accounts and subscriptions only)
npm run dev                    # http://localhost:3000

Environment variables

Every variable is documented in .env.example.

Variable	Needed for
POSTGRES_PRISMA_URL, POSTGRES_URL_NON_POOLING	Database (pooled runtime URL, direct URL for migrations)
AUTH_SECRET	Auth.js sessions; any value works for a local build
NEXT_PUBLIC_SITE_URL	Absolute links in emails and Polar return URLs
AUTH_TRUST_HOST	Only when running next start outside Vercel
AUTH_RESEND_KEY, EMAIL_FROM	Magic links and verification emails
POLAR_ACCESS_TOKEN, POLAR_PRODUCT_ID, POLAR_SERVER, POLAR_WEBHOOK_SECRET	Pit Lane Pro checkout, customer portal and webhook
UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN	Optional shared rate limits (auth:* uses the Postgres RateLimit table when Upstash is not configured)
OPENF1_USERNAME, OPENF1_PASSWORD	Optional authenticated OpenF1 access

Checkout returns 503 until the Polar token and product ID are set. The webhook rejects requests when POLAR_WEBHOOK_SECRET is missing. Its endpoint is <site>/api/polar/webhook, subscribed to subscription.* events.

Deploy

• Upstash is optional. When it is not configured, auth:* rate limits use the Postgres RateLimit table.
• Before npx prisma migrate deploy, run psql -f scripts/check-email-duplicates.sql against the target database.
• Set POLAR_SERVER and POLAR_WEBHOOK_SECRET for Polar checkout and webhooks.
• EMAIL_FROM must use a domain verified with Resend. Set NEXT_PUBLIC_SITE_URL to the public site origin for verification emails and Polar return links.
• English routes stay unprefixed; Arabic pages use /ar (for example, /ar/login and /ar/support).

Scripts

Command	What it does
npm run dev	Development server
npm run lint	ESLint
npm test	Vitest unit tests (no network; upstream APIs are mocked)
AUTH_SECRET=dummy npm run build	Production build (data pages render at request time, so the build does not call the F1 APIs)
npm start	Serve the production build
npm run test:e2e	Playwright smoke tests against a production build on port 3000
node scripts/update-f1-snapshots.mjs drivers	Refresh the bundled all-time driver list (about 10 Jolpica requests)
node scripts/update-f1-snapshots.mjs champions	Refresh the bundled champions history (about 145 Jolpica requests)

The smoke tests check page shells, headings and status codes. Data assertions are skipped when an upstream API is unavailable. Install the browser once with npx playwright install chromium.

Data sources

Source	Used for	Limits
Jolpica F1 (Ergast-compatible)	Calendar, results, qualifying, standings, career statistics, history since 1950	About 4 requests per second and 500 per hour; at most 100 rows per page
OpenF1	Sessions, meetings, drivers, live timing, tyre stints, pit stops, race control	Public rate limits; some in-session data may require authenticated access

All requests go through src/lib/f1/http.js, which caches responses with unstable_cache (5 minutes for live data, up to a day for historical data) and keeps the last good value when an upstream call fails. If an API stays down, the route's error page offers a retry instead of showing empty data. Snapshots in src/lib/f1/data/ hold past champions and the all-time driver list, so history and compare pages don't spend the Jolpica hourly quota; newer seasons are added live.

Project layout

src/
  app/            routes (calendar, standings, live, drivers, driver/[number], teams, team/[id],
                  race/[key], tracks, history, compare, support, login, signup, profile, api/)
  components/     shared UI (header, footer, driver cards, local time, circuit panel)
  lib/f1/         data layer: Jolpica and OpenF1 clients, season, results, standings, history
  lib/            validation, rate limiting, Polar client, JSON-LD, site config
  auth.js         Auth.js configuration
prisma/           schema and migrations
tests/            Vitest unit tests
e2e/              Playwright smoke tests
scripts/          snapshot refresh script

Support

The site is free. Tips go through Buy Me a Coffee; Pit Lane Pro is a monthly Polar subscription that adds a supporter badge to your profile.

License

MIT. See LICENSE.