Vroomy

A multiplayer typing-race game. Quotes come from the separate quotes-crawler project through a shared Postgres.

Run locally

Needs Bun, Go and a Postgres with the crawler's quotes table.

cd backend/api && cp .env.example .env && go run .   # :8080
cd backend/ws  && cp .env.example .env && go run .   # :8081
cd frontend    && bun install && bun --bun run dev   # :3000

Logging in needs the OIDC_*, PUBLIC_URL and SESSION_SECRET vars in frontend/.env; everything else works as a guest.

Tests: go test ./... in backend/api and backend/ws. Browser tests of the main flows (solo, quick match, friends room, rejoining, ghosts): bun run test:e2e in frontend, with the backends running; they use your installed Chrome.

Deploy

docker compose up -d with the variables listed at the top of docker-compose.yml.

Layout

• frontend/ — TanStack Start app
• backend/api/ — Go REST API (README)
• backend/ws/ — Go WebSocket race server (README)