Features
- Endless mode – play as long as your board allows; level up every few hundred points
- Daily Challenge – one seeded board per day, everyone gets the same opening pieces, separate daily best
- 5 themes that unlock by score – Neon Night → Ocean Classic (2,500) → Colorful Wood (6,000) → Lava Ruby (12,000) → Galaxy (20,000). They switch mid-game with a big unlock banner; pin a favourite in Settings
- Highscore & stats – best score, average, lines, max combo, last 10 games (stored locally)
- Revive – first one free, extras cost coins; blasts 3 rows + 3 columns and deals fresh pieces
- Combos – consecutive line clears multiply your score (a combo survives a single miss); the combo number is stamped on every block about to pop, the score changes colour with your combo tier and the board gets a rainbow frame during a streak
- Praise banners – Cool! / Great! / Amazing! / Unbelievable! / Combo Master / 2 Colors Gone! / ALL CLEAR ×combo
- Effects – particles, screen shake, line flashes, combo rings, floating scores, confetti, start-of-game ripple, twinkling empty slots
- Sound & haptics – fully procedural WebAudio sounds (no audio files), vibration on mobile
- Smooth drag & drop – pointer events, lift-above-finger on touch, snap preview that shows which lines will clear
- Auto-save – close the tab and continue later from the main menu
- Loading screen, pause menu, settings (sound, vibration, placement preview, effect quality – Auto adapts to the phone's real frame rate)
- PWA – manifest, icons, offline service worker, installable on iOS / Android / desktop
Run locally
Any static file server works (ES modules need http://, not file://):
npx serve .
# or
python3 -m http.server 8000
Deploy to Vercel
- Push this repository to GitHub (already done if you are reading this there).
- Go to vercel.com/new, import Blockblasters.
- Framework preset: Other. Leave build command and output directory empty.
- Deploy. That's it —
vercel.json already sets clean URLs and cache headers.
Or from the CLI:
npm i -g vercel
vercel --prod
Project structure
index.html app shell + all screens
css/style.css design system, HUD, overlays, animations
js/main.js bootstrap, game flow, screens, autosave
js/game.js pure rules: board, pieces, scoring, combos, revive, serialize
js/shapes.js piece catalogue
js/themes.js themes, palettes, unlock thresholds
js/render.js canvas renderer, sprites, drag & drop, animations
js/fx.js particles, confetti, floating text, shake, rings
js/audio.js procedural sound engine
js/storage.js localStorage (profile, settings, saved game)
js/ui.js DOM helpers, HUD tweens, toasts
assets/ logo, favicon, PWA icons, OG image
manifest.webmanifest PWA manifest
sw.js offline service worker (network-first)
vercel.json headers + clean URLs
Scoring
| Action | Points |
|---|
| Place a piece | 1 per cell |
| Clear n lines at once | (80·n + 40·n·(n−1)) × combo |
| ALL CLEAR (empty board) | +500 × combo (min ×2) |
Coins: +1 per line, +combo count when combo ≥ 2, +3 when a clear is only 1–2 colours, +25 for an all clear, +10 per level-up. A revive costs 100 coins after the free one (max 5 per game).
License
MIT
