Poly Formula

Browser formula racing with a PS1 / low-poly look. The webcam is the controller: hold your hands like a wheel, and we also read head pose.

webcam  →  MediaPipe (head + hands)  →  MobX store  →  HUD now, car later

The camera loop does not go through React. It writes numbers into a store once per frame. Only the debug HUD observes that store. Three.js can read the same values from its own animation loop.

• Vite + React + Three.js — small web stack, fast to iterate on at a hackathon
• MediaPipe Face + Hand Landmarker — geometric head pose from a few landmarks, plus both wrists
• MobX — tracking updates every frame without re-rendering the whole app
• Store only useful numbers — pose, wrists, wheel angle. Not the full landmark mesh
• Driver picker — Tekken-style horizontal select of the 22 2026 F1 drivers, each with a bundled 5×5 head atlas under public/sprites/drivers/. Selected sheet drives webcam head tracking. Bake/rebuild with npm run generate:atlases (fal GPT Image 2.5 Flare; FAL_KEY in .env).
• Convex (optional) — anonymous lap times + leaderboard. Nickname only; no login. Without a URL the board stays on this device.
• Driver sprite — 5×5 atlas. Nose vs eyes/mouth picks yaw/pitch, then snaps to a cell. Overlay is counter-mirrored so left/right match
• Wheel sprite — two palm centers set position, tilt, and size so the grips sit in your hands

Real circuits come in as data files, researched separately (possibly by other agents) and consumed by the game as-is.

• docs/track-format.md — the shared standard: coordinate system, arc-length convention, JSON schema, acceptance checklist. Any track research must deliver this format.
• docs/scenery-format.md — companion standard for the surroundings: grandstands, pits, forest, the old banking, as footprints in the same frame.
• docs/research/monza-scenery-prompt.md — ready-to-share prompt for researching Monza's real surroundings (OSM footprints, aerial verification).
• docs/research/monza-barriers-prompt.md — ready-to-share prompt for researching the barriers and fencing (guardrails, tyre walls, debris fences, gravel traps) that line the track.
• docs/research/monza-speeds-prompt.md — ready-to-share prompt for researching real F1 Monza speed targets (entry/apex/exit, brake points, dense speed-vs-distance profile for lap-time realism).
• docs/research/monza-racingline-prompt.md — ready-to-share prompt for researching the real F1 Monza racing line (lateral offsets + world points to replace the geometric elastic-band line).
• Track files live in src/tracks/<slug>.json, scenery in src/tracks/<slug>.scenery.json, barriers in src/tracks/<slug>.barriers.json, research notes in docs/research/.
• src/game/trackPath.ts loads a track file and answers geometry questions (sample at arc length, nearest point, next corner); src/game/trackModel.ts builds the meshes from it.

Landing is a sharp pre-race entry screen: pick a 2026 driver, set a nickname, Start, and open the Leaderboard. After start, the existing hand-wheel / READY overlay and HUD take over.

Drivable low-poly F1 car on the real 1:1 Monza layout, built at runtime from src/tracks/monza.json (OSM-sourced, 5793 m): arcade physics, chase camera, HUD with minimap, lap clock, and corner callouts. Keyboard (WASD/arrows) drives, R resets you onto the track; holding the hand wheel takes over steering with a gentle auto-throttle.

npm install
npm run dev

Allow the camera when the browser asks.

Finish a flying lap (first start/finish crossing starts the clock; the next crossing posts the time). Open Leaderboard on the entry screen or the in-race chip.

Laps sync to Convex when VITE_CONVEX_URL is set. Leave it empty and the board still works — it just stays in localStorage.

npx convex dev

That command creates/links a Convex project, pushes convex/schema.ts + convex/laps.ts, and writes the public client URL to .env.local:

VITE_CONVEX_URL=https://<your-deployment>.convex.cloud

Restart npm run dev after the URL lands. Do not commit .env.local. There is no auth and no extra secrets — the URL is the public Convex client endpoint.