Leaderboard
Guess the Year leaderboard
The V4 leaderboard keeps the product surface ready for public rankings while staying lightweight today. Your local best score appears beside simulated daily, weekly, all-time, and streak boards when backend APIs are not configured.
A future Cloudflare Worker can replace the fallback data with D1 or KV backed rankings. The planned score payload only needs nickname, score, average error, streak, mode, date, and question count, and it does not require login or sensitive personal data.
Leaderboard Fallback
Today's top scores and long-term rivals
This panel is ready for a Cloudflare API, but it keeps working with local mock data when D1 or KV are not configured. The submission shape stays nickname, score, averageError, streak, mode, and date.
Rankings
Ava
daily · 2026-06-17 · avg error 1.1
You
daily · 2026-06-17 · avg error 0
Today's Top Scores
Current day snapshot
Weekly Best
Seven-day performance
Best Streaks
Repeated daily play
Submit a local score
This is a mock submission surface that mirrors the later API contract. No login. No email. No sensitive data.
How scoring works
The API contract stays narrow so the leaderboard can later move to Cloudflare D1 or KV without adding login. A valid submission must fit the five-question score range, include a YYYY-MM-DD date, and use a nickname that fits within the moderation limits. If the API is unavailable, the page falls back to local mock rows.
Today's Top Scores
Daily leaderboard preview for the current challenge.
Weekly Best
A rolling weekly board for repeat players and category explorers.
Best Streaks
A future board for players who return day after day.
Backend API reservation
submitScore
POST /api/submit-score
getDailyLeaderboard
GET /api/leaderboard/daily?date=YYYY-MM-DD
getWeeklyLeaderboard
GET /api/leaderboard/weekly
submitQuestion
POST /api/submit-question
getPendingQuestions
GET /api/questions/pending
Fallback behavior is required: if environment variables, D1, or KV are missing, the page stays usable with local mock rankings and the browser's local best score.
How scoring works
Each question is worth up to 100 points. Exact years score 100, near guesses still earn partial credit, and a five-question round totals up to 500. Public submission APIs should reject impossible scores, unknown modes, malformed dates, and results that do not represent a five-question game.
FAQ
Common questions
Does the leaderboard require login?
No. The current product uses local fallback rows and can later accept nickname, score, date, and mode only.
What happens when backend APIs are not configured?
The page keeps working with local best score and mock daily, weekly, and streak tables.
What anti-abuse checks are planned?
The planned API validates score range, date, mode, year range, question count, and suspicious duplicate submissions.