Throttle Bike
Browser motorbike combat racer. Race on open highways, punch and kick rivals off their bikes, play from a link in 5 seconds.
Play at throttlebike.com. The repo and code still use the short name throttle.
Play
The hosted build is on Vercel at www.throttlebike.com (throttlebike.com redirects there). Open it on a phone, then add it to the home screen. After the first visit it keeps working offline. GitHub Pages is not used.
Run it
npm install
npm run dev # local dev server with hot reload
npm run check # typecheck and tests
npm run build # hosted PWA build in dist/
npm run build:single # one self-contained HTML file in dist-single/ for test links
Add ?debug to the URL to expose window.__game and window.__host for testing.
Controls
| Action | Keyboard | Phone | Gamepad |
|---|
| Steer | Left, Right (or A, D) | Hold the left pad, slide further to turn harder | Left stick or d-pad |
| Throttle | Up (or W) | Automatic | Right trigger |
| Brake | Down (or S) | BRAKE | Left trigger |
| Punch | J (or Z) | PUNCH | X |
| Kick | K (or X) | KICK | A or B |
| Swing weapon | L (or C) | Weapon button, shown when you hold one | Y |
| Pause | P or Esc | Pause button, top center | Start |
| Mute | M | Settings | |
| Confirm on menus | Enter or Space | Tap | A |
The game
- Career: 5 levels (Rookie, Street, Pro, Outlaw, Legend). Finish in the top 3 on all 4 tracks to unlock the next level.
- Tracks: Sunset Coast, Red Mesa, Pine Pass, Neon Night. Each is generated from a seed, so it is the same on every device.
- Garage: 5 bikes and 3 upgrades (engine, tyres, armour) with 3 levels each, paid for with race cash.
- Weapons: some riders carry a club (6 swings) or a chain (8 swings, longer reach). Knock them out to take it.
- Police: from level 2. If they catch you crashed or crawling, you are busted: the race ends and you pay a fine.
- Saves: progress stays on the device. Settings has a save code to move it to another device.
Working on the code
Start with AGENTS.md. It has the setup, the rules and the task workflow for people and coding agents.
Status
- Phase 1, feel prototype: done, playtest gate passed.
- Phase 2, full single player game: core features done (P2-01 to P2-11). Music is in (P2-17). Comfort settings are in (P2-16). The hosted build is on Vercel (P2-14). The production site reports play to Umami (P2-13). Dev and localhost do not. Next: phone performance and balance.
- Phase 3 and 4: drafted in docs/TASKS.md.
Size: about 78 KB gzipped including React. 29 tests, including a bot that finishes a race on every track.
