No description

Find a file

Gabriel Franco a7cc3e7d8c feat(backend): add private rooms with create/join and match repeat Implements PROTOCOL.md's private-room flow: room:create/room:join with a collision-checked numeric code, up to a 5-match repeating series per room via game/session.js, random-theme selection that excludes the previous match's theme, and room:closed for matchLimit or quit (rooms never touch matchmaking's ban store). themeMode: 'chosen' gets a narrow resolveChosenTheme() stand-in pending #7's real theme-voting flow. Also adds a minimal opponentName lookup to registry.js (registerSocket's new optional name arg + getPlayerName) since room:joined needs it, mirroring the same addition landing on #5's branch.		2026-09-10 12:16:13 -03:00
backend	feat(backend): add private rooms with create/join and match repeat	2026-09-10 12:16:13 -03:00
frontend	feat(frontend): add in-match timer HUD with countdown and time warning	2026-09-10 12:03:42 -03:00
.gitignore	refactor(frontend): move to frontend/, port to Vite + TypeScript	2026-09-10 10:37:44 -03:00
AGENTS.md	docs: rename trunk branch references from master to main	2026-09-10 10:41:42 -03:00
README.md	feat(backend): scaffold matchmaking server project	2026-09-10 10:37:52 -03:00

README.md

Theme Guess

A browser game about syntax-highlighting themes. A snippet of code is rendered with every token type (keywords, strings, functions, variables, comments, ...) in a neutral color. You click a token, every token of that same kind lights up together, and you pick a color for it — repeat until the whole file is themed. Reveal shows how close your from-scratch palette landed to a real theme (Gruvbox, Tokyo Night, VS Code Dark+, GitHub Dark, Dracula, Catppuccin), token kind by token kind.

The project is moving from a single-player-only page toward supporting multiplayer matchmaking (race another player to the closest match on the same theme/snippet). This repo is split into a frontend game client and a backend matchmaking/realtime server so that work can land independently.

Layout

frontend/   Canvas game client: Vite + TypeScript, no UI framework.
backend/    Matchmaking + realtime session server: Node, HTTP + WebSocket.

Each package has its own package.json, dependencies, and scripts — see frontend/README.md-equivalent notes below and backend/src/*/README.md for what's reserved but not implemented yet.

Running the frontend

cd frontend
npm install
npm run dev       # Vite dev server with HMR
npm run build     # type-check + production bundle to dist/
npm run typecheck # tsc --noEmit only

Running the backend

cd backend
npm install
npm start         # node src/index.js
npm run dev       # same, with --watch

Boots a plain HTTP server (with a /health check) and attaches a WebSocket server to it. Matchmaking and room/session logic are not implemented yet — see backend/src/matchmaking/README.md and backend/src/rooms/README.md.

Status

Single-player game: playable. Multiplayer: backend is a bare HTTP+WS scaffold with no matchmaking logic yet; frontend has no multiplayer UI yet. See AGENTS.md for architecture notes and contribution conventions.