Rushline

A browser-native 3D precision time-trial racer inspired by Trackmania. Chase medals, beat your ghost, and stick loops on nine hand-built tracks — or run Rush Cup. Desktop, touch, and gamepad.

Live stack: React 19 · TanStack Start · Three.js r185 · Zustand · Tailwind v4 · Web Audio

Feature map

The TM-depth set now on this build. Help (menu, pause, or Settings) opens the same catalog plus the live control sheet.

Feature	What it is
Rewind	Hold Backspace or LB + Y to scrub the last few seconds. The race clock and ghost compare walk backward with you. Allowed in time trial and Rush Cup. Does not wipe a standing personal best — only a finish after rewind can replace it. Toggle Enable Rewind in Settings (on by default on desktop).
Surfaces	Plastic, dirt, ice, and tech change grip — not just paint. The HUD chip names the ribbon under the car.
Cameras	C cycles Chase → Far → Hood → Cabin. All four stay usable at speed.
Checkpoint respawn	R (or Y) returns you to the last checkpoint. Hold R / Y, or press Delete, to restart from lights-out.
Ghost share	Export a last-run or PB tape as JSON from Results or Tracks, then import a friend's file as a rival. Local download / pick-a-file only. A rival never overwrites your PB, last run, Rush Cup, or Garage paint.
Author ghosts	Every stock circuit ships an author-line ghost paced to the Author medal. A personal-best or imported rival replaces it. The rival hides through lights-out, fades when you overlap, and toasts PASSED / OVERTAKEN when the lead flips.
Editor 1.1	Edit ribbon on Custom — control points, click-to-place checkpoints and boost pads, undo/redo, snap-to-grid, flatten, and a ribbon flythrough. Save stays on this device (rushline-custom-v1); Export / Import is JSON. Time trial only.
Hotseat	Two players on one device. P1 drives, then P2 races P1's ghost on the same circuit. A local scoreboard compares the times.
Validated	Finish without rewind and results shows a soft Validated badge. Rewind still counts for PB and medals. Local only — not online anti-cheat.
Stock laps	Settings can set time-trial and hotseat laps on the stock nine to 1 / 2 / 3 (or Track for each circuit's authored count). Medals scale with the lap count. Custom and Rush Cup keep their own laps.
Replay viewer	Watch replay from Results follows last run, the shipped author ghost, a PB, an imported rival, or a hotseat tape. Pause / play, scrub, then Done. Photo mode stays a still.
Photo mode	Freeze a still with the HUD hidden. Open from the camera button, Pause, Results, F, or LB + View.
Rush Cup	Clear Gold (or better) on all nine tracks in order, then Author Cup unlocks on the same nine. Progress lives in localStorage under rushline-cup-v1.
Garage	Six liveries: Ivory, Violet, Sun, Frost, Carbon, Hazard. Cosmetic paint persists in rushline-v1 and rushline-settings-v1.

Help lists the keyboard, touch, and gamepad bindings that are actually live. Settings has a Slow / Normal / Fast steering preset for keyboard and pad (Track Assist scales are unchanged).

Tracks

Track	Vibe	Length	Signature
Green Circuit	Stadium plastic	~1064 m	Banked stadium oval, boost pads, tight chicane · 2 laps
Ridge Drop	Canyon dirt	~1213 m	Paved start, dirt canyon, downhill jump
Night Helix	Night tech	~727 m	Full loop, sticky metal helix, night lights
White Pass	Alpine ice	~948 m	Switchbacks, packed ice, long descent
Arc Yard	Works tech	~952 m	Metal docks, gantry climb, freight drop
Red Mesa	Desert dirt	~1118 m	Dirt climb, plastic table, dirt edge drop
Black Hollow	Forest dirt	~819 m	Moonlit dirt pines, then a tech clearing sprint
Ember Caldera	Lava dusk	~1011 m	Ash rim, lava-glass hairpins, crater drop
Storm Dock	Rain city	~901 m	Wet streets, ice plaza, tech pier sprint
Custom	Your ribbon	editor	Closed Catmull-Rom loop you place yourself

Each stock track has author / gold / silver / bronze times, checkpoints, boost pads, and a shipped author ghost. Custom lives at the bottom of Tracks — Edit ribbon opens Editor 1.1 (control points, click-to-place checkpoints and boost pads, undo/redo, snap-to-grid, flatten, and a ribbon flythrough). Drive it in time trial. Rush Cup stays the stock nine.

Surfaces change how the car grips. Plastic (Circuit, Mesa table, Storm streets) is the stadium baseline — slide-friendly but readable. Dirt (Ridge, Mesa climb/drop, Hollow pines, Ember ash) enters a slide earlier and pulls accel. Ice (White Pass, Storm plaza) is the slipperiest: weak brakes, early slide, a high hiss. Tech (Helix, Yard, Hollow clearing, Storm pier) sticks later and stops harder.

A personal-best ghost is saved with the time and replaces the author line. If that ghost is missing or too thin, the last finished run is used instead. An imported rival also replaces the author line. Results can Retry vs last run to race that lap even when a stronger PB ghost exists. Best / last / medal times sit on each track card. The rival hides through lights-out so it does not sit on your grid car, fades when you overlap, and toasts PASSED / OVERTAKEN when the live split flips.

Ghost share files live in localStorage under rushline-ghost-share-v1. Clear the rival from Tracks when you want the usual ghost back.

Photo mode

Freeze a still with the HUD hidden.

This is the beginning of the README. Read the rest at the original. Read the full README ↗