Contents
1 Overview
Downhill Dash is a downhill mountain bike game drawn on a 2D canvas, for landscape and portrait screens. The full-suspension bike is physics based, and the rider has spring legs and arms and crashes like a ragdoll. The Tour has 4 worlds with 6 tracks each (Pine Forest, Red Desert, Canyon and Night Forest): Red Desert has less tire grip and tumbleweeds, Canyon has gaps to jump and Night Forest is dark, with a handlebar light. Endless mode is a never-ending trail that cycles through the 4 worlds, with a best score. Gears collected on the trails buy 8 bike colors, 8 rider outfits and 4 dust trails in the shop.
This edition has no multiplayer, online ranking, ads or in-app purchases. Progress, stars, gears and shop items are saved locally in the player's browser only.
This download includes the ready-to-host game, the full editable source (plain HTML, CSS and JavaScript), this guide and the third-party license notices.
START-HERE.txt
DOCUMENTATION.html
CHANGELOG.txt
documentation/index.html
game/
source/
THIRD-PARTY-LICENSES/
2 Install the ready-to-play game
Only the game/ folder needs to be uploaded to play.
- Extract the whole ZIP on your computer.
- Upload the contents of
game/to a folder on static hosting, using FTP or your host's file manager. - Open that folder's URL in a modern browser. The game uses relative paths and can be installed in a subfolder.
- Tap, click or press a key to start; browsers require a user gesture before playing audio. Test on the intended devices.
index.html straight from the disk (file://) is not supported: use a web address or the local server described below.
3 Requirements
- Any static web host able to serve plain files over HTTPS.
- A current desktop or mobile browser with JavaScript enabled.
- Node.js 26.13 or newer, only if you want to run the tests, the local server or the build command from
source/.
No database, backend language or compile step is required to host the ready-to-play game/ folder.
Test on the exact devices and browsers your players will use before launch, especially for touch input.
4 Controls and how the game works
On the ground, hold the screen (or press Space, Up arrow, W, Z, X or Enter) to crouch and release it to jump. Release right at the ramp lip for a POP: a higher jump with a bonus. In the air, hold to backflip and tap for an air trick (no hander, superman, can-can, tailwhip or nac-nac). Tap just before landing and you jump as soon as the wheels touch. On the keyboard, the Left and Right arrows (or A and D) lean the rider (manual, nose manual, frontflip) and Down (or S) does an air trick.
Land with both wheels lined up with the ground for a perfect landing: it gives a speed boost, points and combo. A crooked landing is a crash, and so are hitting a log or the face of a rock, falling into a canyon gap or looping out. The crash panel shows how you crashed, the distance, the gears, your best combo, best air and best trick. Points come from flips, tricks, air time, drops, canyon gaps, manuals, wooden bridges (north shore), near misses and tumbleweeds, multiplied by the combo. Gears are collected on the trails and banked at the end of every run; some tracks also hide 3 golden gears. On the keyboard, Esc or P pauses and M mutes the sound.
A track is cleared at the finish. Stars: the first for reaching the finish, the second for reaching the track's score goal, the third for the track's challenge (collect the 3 golden gears, make a number of perfect landings, flips or air tricks, finish with no sketchy landing, or reach a combo). Stars unlock the next worlds (10, 24 and 40 stars), and each new star also gives gears. The champion screen opens after every cleared track.
5 Interface
Six real captures from the shipped build, with numbered marks for the elements mentioned in this guide.
Marks on the screenshot
- Tour: opens the map of the worlds and their tracks
- Endless: a never-ending run with a best score
- Shop: bike colors, outfits and dust trails bought with gears
- Sound and Settings (music and effects volume, vibration, less motion, language)
Marks on the screenshot
- Back to the title screen and the gears you have
- Stars collected out of the total
- The selected track (tap a track to select it, tap again or press Play to start)
- Arrows: the next or the previous world
Marks on the screenshot
- Distance, speed and gears of this run
- Progress to the finish gate
- Score and the golden gears found on this track
- Pause, sound and settings
Marks on the screenshot
- Tabs: bike colors, outfits and trails
- Preview of the bike and rider with the selected items
- Items: owned, equipped or with their price in gears
Marks on the screenshot
- Stars earned on this track
- The three goals and the result of each one
- Map, retry the track, or the next track
Marks on the screenshot
- Music and effects volume
- Vibration and less motion (fewer screen effects)
- Interface language, switched instantly without reloading
6 Settings and language
Settings opens from the gear button on the title screen and from the pause menu during a run. It has separate volumes for music and effects, vibration (on phones that support it), less motion (turns off screen shake and most effects; it also follows the system's reduced-motion setting) and the language. Changes are saved at once.
The interface ships in 14 languages: English, Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese. The first visit follows the browser language.
7 File map
| Path | What it is |
|---|---|
game/index.html
|
Entry point; upload it together with the rest of game/. |
game/assets/
|
Art, music, sound effects and the font used by the game. |
source/src/tour.js
|
Tour data: the 4 worlds and their 6 tracks (seed, length, difficulty, section mix, score goal and star challenge). |
source/src/shop.js
|
Shop items: bike colors, rider outfits and dust trails with their colors and prices. |
source/src/game-1.js … game-4.js
|
The game code: classic scripts loaded in order by source/src/main.js (game-1.js to game-4.js, sharing their names). |
source/src/i18n.js
|
Interface texts live in source/src/i18n.js: one list of keys and, for each of the 14 languages, the texts in the same order. |
8 Customize
Most numbers are easy to find: physics and scoring in source/src/game-1.js (search for const G_ for gravity, VMAX for top speed, KS for the suspension spring and TRICKS for the air tricks), tracks in source/src/tour.js (each track sets its length, difficulty, section mix, score goal and challenge) and shop items in source/src/shop.js. Edit, then run npm run build (or copy the changed files) to update game/.
// source/src/game-1.js (search for: const G_)
const G_ = 1500,
STEP = 1 / 300,
COMBO_T = 3.2;
const VMAX = 800; // top speed (KS = 235 is the suspension spring).
Replace art or sounds with files of the same name and similar proportions. Keep the bundled font license notice if you keep using the bundled font.
9 Languages
The interface ships in 14 languages: English, Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese. The first visit follows the browser language.
Interface texts live in source/src/i18n.js: one list of keys and, for each of the 14 languages, the texts in the same order.
10 Saved progress
Tour progress, stars, gears and shop items are saved automatically to the browser's local storage under the key downhill-dash.template.save.v1, settings under downhill-dash.template.settings.v1 and the Endless best score under downhill-dash.template.best.v1, specific to that browser and site address.
- Clearing the browser's site data for the game's address deletes this save.
- There is no cloud save or account; progress does not transfer between devices or browsers.
Uploading a new build over an existing install keeps the saved progress, because the save keys stay the same.
11 Install Node.js and use the source
Only if you want to run the tests, play the source on your computer or rebuild game/. The game itself needs no Node.js.
- Install Node.js LTS 26.13 or newer from nodejs.org (Windows and macOS: the installer; Linux: your package manager or the official binaries).
- Open a new terminal (Windows: PowerShell or Command Prompt) and check the versions with
node -vandnpm -v. - Go to the extracted
source/folder, the one withpackage.json, for example withcd path/to/source. - Run
npm ci(it checkspackage-lock.json; the project has no dependencies), thennpm test. - Run
npm run devand open http://localhost:5281/ to play the source. Add?devtestto the address to unlock every track for testing. - Run
npm run build: the ready-to-host copy is written tosource/dist/. Upload the contents ofdist/exactly likegame/.
npm ci
npm test
npm run dev
npm run build
node or npm not found (reinstall Node.js and open a new terminal so the PATH is updated); on Windows, npm.ps1 cannot be loaded (use Command Prompt or run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned in PowerShell); EBADENGINE or a version message (install the current LTS); ENOENT (you are not in the folder with package.json).
12 Updates and cache
Uploading a new build over an existing install keeps the saved progress, because the save keys stay the same.
Re-upload the full contents of game/ (or dist/ after a build), overwriting the previous files.
An old version shown in a browser tab after updating is almost always a caching issue, not a failed upload.
Clearing the cache without losing progress
Progress is stored in this browser, not on the server. Clearing cached images and files, or doing a hard reload, keeps your progress.
Computer: press Ctrl+F5 on Windows and Linux, or Cmd+Shift+R on macOS. Phone: in the browser settings, choose the option to clear cached images and files.
Do not choose cookies and site data, or clear site data, for the game's address. That deletes the local save.
13 Troubleshooting
- Blank page: check the browser console for a failed file, and confirm every file from
game/was uploaded, includinggame/src/andgame/assets/. - No sound: audio starts only after a tap, click or key, by browser policy; check the music and effects volumes in Settings and the sound button.
- Touch feels off: confirm the page is not zoomed and that no parent page or container blocks touch events when the game is embedded.
Audio needs at least one user gesture (tap, click or key press) before it can play; this is a browser requirement, not a bug in the game.
14 Frequently asked questions
Can I resell this template as-is?
Does the game need a server or database?
game/ folder is static files; progress is saved in the player's browser.Can I change the rider, the tracks or the shop?
source/src/shop.js, tracks and stars in source/src/tour.js, texts in source/src/i18n.js and the art in source/assets/img/. npm test checks the data and the texts after a change.15 Support and licenses
The font license is included in THIRD-PARTY-LICENSES/ and in licenses/ inside game/ and source/.
For product support, write to the address below.
Support request
When you write to support, include the browser and device, the game version, the page address, the steps that caused the problem, a screenshot and the first error shown in the browser console. Never send passwords, payment details or secret keys.
For AI assistants
- Read the installation and customize sections before changing anything. Upload only
game/(ordist/) to a host;source/is the editable project. - Preserve progress: keep the save keys, the relative paths and the translated texts unless the buyer asks for a change. New text keys go at the end of the list, in all 14 languages.
- Do not assume an account system, a server, ads or payments. This edition has none, and the code is the source of truth.