Real-time quiz games that bring people together. Built on Cloudflare's edge.
Timoot turns any gathering into an interactive quiz experience. Whether you're running a team all-hands, teaching a class, or just hanging out with friends — Timoot makes it easy to create and host live trivia.
How it works:
- Host throws the quiz up on a shared screen
- Players join from their phones via PIN or QR code
- Everyone competes in real-time with instant scoring
Every game runs on its own Durable Object, keeping state synced across all players via WebSockets. Zero lag, global scale.
- AI-Powered Quiz Generation — Describe your topic, get a quiz instantly
- Real-time Multiplayer — WebSocket-powered gameplay with sub-second updates
- Two-Screen Experience — Big screen for the host, phones for players
- Instant Join — PIN code or QR scan, no app download needed
- Speed Scoring — Faster correct answers = more points
- Quiz Editor — Build and customize your own quizzes
- Edge-Native — Runs entirely on Cloudflare Workers and Durable Objects
| Layer | Tools |
|---|---|
| Frontend | React, TypeScript, Tailwind CSS |
| Data Fetching | TanStack React Query, Hono RPC |
| Client State | Zustand |
| Animations | Framer Motion |
| Backend | Cloudflare Workers, Hono |
| Realtime | Cloudflare Durable Objects, WebSockets |
| AI | Cloudflare AI Gateway, Vercel AI SDK |
| Storage | Durable Objects SQLite, KV |
| Build | Vite, Bun, @cloudflare/vite-plugin |
| Testing | Vitest, Playwright, Storybook |
| Quality | ESLint, Prettier, Knip |
- Bun — fast JS runtime and package manager
- A Cloudflare account (free tier works)
# Clone the repo
git clone https://github.com/TimoWilhelm/timoot.git
cd timoot
# Install dependencies
bun install
# Log into Cloudflare
bunx wrangler loginCopy .env.example to .env.local and fill in the required values:
cp .env.example .env.localFor production, configure runtime variables in your Cloudflare Dashboard under Workers & Pages → Settings → Variables and any build-time variables in your CI/CD system (e.g. GitHub Actions).
Ship it to Cloudflare's edge in one command:
bun run deployMIT