Polar Games

Grow the squad. Pick the right gate. Crush the King. · 1.0.0

Bean Squad Rush

A crowd runner game with jelly beans: drag to steer your squad through math gates, recruit grey beans, beat bigger crowds and dodge obstacles across 5 colorful cities with 50 levels, 3 stars per level, upgrades and a shop. 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

Bean Squad Rush is a crowd runner drawn on a 2D canvas with its own small 3D projection, for landscape and portrait screens. You lead a squad of jelly beans down winding streets: math gates (+, ×, −, ÷) change the crowd, some gates change value over time, swap sides or slide, and grey beans standing on the track join the squad when you touch them. Red crowds wait on the road and the bigger crowd wins the fight; giants count as 10 beans. Obstacles include spinning bars, hammers, saws, spikes, walls, cannons, falling floors, narrow bridges, ramps and conveyors. Each level ends on a rainbow staircase with multipliers, a giant ball to push as far as possible or a fight against the King. There are 5 cities (Sunny City, Desert Town, Jungle City, Candy City and Neon City) with 10 levels each: level 5 is a bonus level and level 10 is the King.

This edition has no multiplayer, online ranking, ads or in-app purchases. Progress, stars, coins, upgrades 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

Drag left and right anywhere on the screen to steer the squad (on the keyboard: Left and Right arrows or A and D). The squad runs forward by itself. Choose each gate by its math, not by its color: every gate looks the same, so read the numbers. Touch grey beans to recruit them, grab coins and the level's key, and keep away from obstacles. Space or Enter presses the main button of the open screen, Esc or P pauses and M mutes the sound.

When the squad meets a red crowd, both counts show at the top of the screen (blue VS red) and beans fight one for one: the bigger crowd wins. Obstacles knock beans away; the Shield upgrade lets some of them resist. At the finish, the stairs take a few beans per step and the last step reached sets the coin multiplier; the giant ball rolls farther with more beans and marks your best distance; the King loses health with every bean that hits him and stomps a shockwave that throws beans away.

Stars: the first for reaching the end, the second for reaching the end with the level's bean goal, the third for grabbing the key (on bonus levels: collecting 80% of the coins). Levels open in order, and a new city opens with enough stars after its King is beaten (18, 40, 64 and 90 stars). At the end of a level a pointer runs over a multiplier bar: tap to stop it and multiply the coins. Three keys open a treasure chest with coins or a new costume. Coins buy upgrades (starting crowd, income, shield, gate bonus) and shop items, and a daily reward pays more each day of a 7-day streak.

5 Interface

Six real captures from the shipped build, with numbered marks for the elements mentioned in this guide.

Title screen with the upgrades
Title screen with the upgrades

Marks on the screenshot

  1. Play: opens the map of the current city
  2. Shop: costumes, hats and trails bought with coins
  3. Upgrades: starting crowd, income, shield and gate bonus, with their price
  4. Sound and Settings (music and effects volume, drag speed, vibration, less motion, language)
City map with the ten levels, their stars and the Play button
City map with the ten levels, their stars and the Play button

Marks on the screenshot

  1. Back to the title screen and the coins you have
  2. Stars collected in this city out of 30
  3. The selected level (tap a level to select it, tap again or press Play to start)
  4. Play the selected level
Gameplay: the squad, a pair of gates and the HUD
Gameplay: the squad, a pair of gates and the HUD

Marks on the screenshot

  1. Pause
  2. Level number and progress to the finish
  3. Coins
  4. Keys (three keys open a chest)
Shop: costumes, hats and trails
Shop: costumes, hats and trails

Marks on the screenshot

  1. Tabs: costumes, hats and trails
  2. Preview of the bean with the selected items
  3. Items: owned, equipped or with their price in coins
Level complete: stars, goals, the multiplier bar and the coins earned
Level complete: stars, goals, the multiplier bar and the coins earned

Marks on the screenshot

  1. Stars earned on this level
  2. Multiplier bar: tap to stop the pointer and multiply the coins
  3. Upgrades and shop, right between levels
  4. Retry the level or play the next one
Settings panel
Settings panel

Marks on the screenshot

  1. Music and effects volume
  2. Drag speed, 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 level. It has separate volumes for music and effects, the drag speed, 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 Worlds and levels: the 5 cities, the finale of each level and the seed and bean goal of the 50 levels.
source/src/world.js The level generator: track sections, gates, enemy crowds, obstacles and finales, and when each one first appears.
source/src/shop.js Hats and trails with their prices, and the map button positions of each city (costumes are in source/src/sprites.js).
source/src/sim.js · render.js · core.js The game: simulation (sim.js), drawing (render.js), themes, sound and save data (core.js).
source/src/i18n.js Interface texts live in source/src/i18n.js: one object per language with the same keys.

8 Customize

Most numbers are easy to find: level sections, their first level and how often they appear in CH inside source/src/world.js; seeds and bean goals in LEVELS and finales in FINS (source/src/tour.js); upgrade prices in UPS and daily rewards in DAILY (source/src/hud.js); costumes in COSTUMES (source/src/sprites.js); hats and trails in source/src/shop.js; city colors in THEMES and BLD (source/src/core.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 object per language with the same keys.

10 Saved progress

Progress, stars, coins, keys, upgrades, shop items and settings are saved automatically to the browser's local storage under the key bean-squad-rush.template.save.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 ?debug to the address to unlock every city and level 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 levels, the cities or the shop?
Yes. Levels are in source/src/tour.js and source/src/world.js, costumes in source/src/sprites.js, hats and trails in source/src/shop.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 key, the relative paths and the translated texts unless the buyer asks for a change. New text keys go in every language object of source/src/i18n.js.
  • Do not assume an account system, a server, ads or payments. This edition has none, and the code is the source of truth.