vers

A browser idle game on a microservice backend: a deterministic simulation runs on the client, and the server verifies its results by replay.

Documentation • Architecture • Agent Guidelines

---

Quick start

bun install                       # whole workspace
bun run stack start               # full backend via docker compose
bun run dev:app-web               # web app dev server
bun run stack stop                # tear the backend down

Checks

bun run typecheck
bun run test                      # postgres suites need: bun run pg:test-container:start
bun run lint
bun run format
bun run e2e                       # playwright; first run: bun playwright install

Layout and conventions

• docs/architecture/overview.md maps the architecture and every workspace project.
• AGENTS.md holds the engineering conventions. It is generated from agents/shared.md and agents/project.md — edit the partials, never the file itself.
• Deploys run through bun run deploy — see docs/architecture/deployment.md.