Polar Games

Hold to crouch. Release to jump. Land it clean. · 1.0.0

Downhill Dash

A downhill mountain bike game: hold to crouch and release to jump, hold in the air to backflip, tap for air tricks and land with both wheels lined up for a speed boost. The Tour has 24 tracks in 4 worlds, with 3 stars per track, an Endless mode and a shop of bike colors, outfits and dust trails, and it runs with no account or server.

Version 1.0.0 Edition HTML5 static edition

This guide works without internet. Images, styles and scripts are already inside this file.

Contents
  1. Overview
  2. Install the ready-to-play game
  3. Requirements
  4. Controls and how the game works
  5. Interface
  6. Settings and language
  7. File map
  8. Customize
  9. Languages
  10. Saved progress
  11. Install Node.js and use the source
  12. Updates and cache
  13. Troubleshooting
  14. Frequently asked questions
  15. Support and licenses
  16. For AI assistants

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.

  1. Extract the whole ZIP on your computer.
  2. Upload the contents of game/ to a folder on static hosting, using FTP or your host's file manager.
  3. Open that folder's URL in a modern browser. The game uses relative paths and can be installed in a subfolder.
  4. Tap, click or press a key to start; browsers require a user gesture before playing audio. Test on the intended devices.
Warning The ready-to-play game needs no Node.js, PHP or database on your web host. Opening 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.

Title screen and main menu
Title screen and main menu

Marks on the screenshot

  1. Tour: opens the map of the worlds and their tracks
  2. Endless: a never-ending run with a best score
  3. Shop: bike colors, outfits and dust trails bought with gears
  4. Sound and Settings (music and effects volume, vibration, less motion, language)
World map with the six tracks, their stars and the Play button
World map with the six tracks, their stars and the Play button

Marks on the screenshot

  1. Back to the title screen and the gears you have
  2. Stars collected out of the total
  3. The selected track (tap a track to select it, tap again or press Play to start)
  4. Arrows: the next or the previous world
Gameplay: distance, speed, gears, score and the track progress bar
Gameplay: distance, speed, gears, score and the track progress bar

Marks on the screenshot

  1. Distance, speed and gears of this run
  2. Progress to the finish gate
  3. Score and the golden gears found on this track
  4. Pause, sound and settings
Shop: bike colors, outfits and dust trails
Shop: bike colors, outfits and dust trails

Marks on the screenshot

  1. Tabs: bike colors, outfits and trails
  2. Preview of the bike and rider with the selected items
  3. Items: owned, equipped or with their price in gears
Track clear: stars, score, the three goals and the gears earned
Track clear: stars, score, the three goals and the gears earned

Marks on the screenshot

  1. Stars earned on this track
  2. The three goals and the result of each one
  3. Map, retry the track, or the next track
Settings panel
Settings panel

Marks on the screenshot

  1. Music and effects volume
  2. Vibration and less motion (fewer screen effects)
  3. 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.

  1. Install Node.js LTS 26.13 or newer from nodejs.org (Windows and macOS: the installer; Linux: your package manager or the official binaries).
  2. Open a new terminal (Windows: PowerShell or Command Prompt) and check the versions with node -v and npm -v.
  3. Go to the extracted source/ folder, the one with package.json, for example with cd path/to/source.
  4. Run npm ci (it checks package-lock.json; the project has no dependencies), then npm test.
  5. Run npm run dev and open http://localhost:5281/ to play the source. Add ?devtest to the address to unlock every track for testing.
  6. Run npm run build: the ready-to-host copy is written to source/dist/. Upload the contents of dist/ exactly like game/.
npm ci
npm test
npm run dev
npm run build
Warning Common errors: 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, including game/src/ and game/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?
Check the item's license terms on its CodeCanyon page before reselling, redistributing or reusing it in another product.
Does the game need a server or database?
No. The ready-to-play game/ folder is static files; progress is saved in the player's browser.
Can I change the rider, the tracks or the shop?
Yes. Bike colors, outfits and dust trails (with their prices) are in 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/ (or dist/) 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.