Sommelier Arena
A real-time blind wine tasting quiz — Kahoot-style, €0/month to host, zero cold starts.
How it works
A host creates a tasting with one or more wines. Each wine gets five questions (color, region, grape variety, vintage year, wine name). Participants join via a 4-digit code on their phone, answer live as the host controls the pace, and compete on a leaderboard.
Everything runs on Cloudflare: the frontend is a static Astro site on Cloudflare Pages; the game backend is a PartyKit Durable Object (Cloudflare Workers); session lists are stored in browser localStorage.
Core concepts
- Session — a single game instance, identified by a randomly generated 4-digit numeric code (e.g.
4821). - Round — one wine. Each round has exactly 5 questions played back-to-back. The leaderboard is shown after all 5 questions, before the next wine begins.
- Question — one of the 5 fixed-category questions for a wine:
color,region,grape_variety,vintage_year,wine_name. The host pre-fills the correct answer and 3 distractors.
Key rules
| Rule | Value |
|---|---|
| Max players | 10 (lobby rejects extra joins) |
| Questions per wine | 5 (fixed categories) |
| Timer per question | Configurable 15–120 s (default 60 s) |
| Scoring | 100 pts correct · 0 pts wrong/unanswered |
| Answer changing | Allowed until host reveals — no first-tap lock |
| Mid-session joins | Not allowed once first round starts |
| Persistence | DO storage (SQLite) in production; in-memory in local dev |
What's new in v0.4.0
- Stack upgrade — Astro 6, React 19, TypeScript 6, Tailwind CSS v4 (CSS-first config), Node.js ≥22.12
- Wine Answers Collection — curated answer suggestions in the session creation form, powered by a dedicated Cloudflare KV Worker
- Admin dashboard at
/admin— manage the curated answer lists
Who are you?
| I am… | Start here |
|---|---|
| A developer setting up locally | Quick Start |
| A developer understanding the system | Architecture · Tech Stack |
| A product person / user | Features · Gameplay Workflow |
| An admin managing answer data | Admin Dashboard |
| Deploying to Cloudflare | Deployment Guide |
| An automation agent / AI | For Developers |
Quick reference
| Doc | What it covers |
|---|---|
| Quick Start | Run locally in under 2 minutes |
| Architecture | Repo layout, runtime communication, DO lifecycle |
| Tech Stack | Stack choices and design principles |
| Gameplay Workflow | Phase machine, event flow, answer/scoring rules |
| Event Reference | All WebSocket message types (client ↔ server) |
| Host & Participant Identity | TANNIC-FALCON-style IDs, session dashboard, rejoin for host and participant |
| Data Persistence | DO storage keys, KV schema, what survives a restart |
| Deployment Guide | Cloudflare Pages + PartyKit + Wrangler deploy |
| Configuration & Environments | Env vars, local vs prod, nginx explanation, testing preview |
| Admin Dashboard | Manage wine answer suggestions |