A chill one-tap arcade flyer — tap to fly, dodge the jars, grab the leaves.
| Action | Desktop | Mobile |
|---|---|---|
| Flap | Space / ↑ / W | Tap anywhere |
| Navigate menus | Mouse / Tab | Tap |
Flap through the gaps between glass jars. Score points, collect coins, chain combos, and survive as long as you can. The world evolves as you score higher — from Meadow to Cosmic and beyond.
- 🎯 One-tap gameplay — Simple to pick up, hard to put down
- 🌍 8 evolving worlds — Meadow → Sunset → Night → Arctic → Volcanic → Cosmic → Celestial → Neon
- 🐦 24 unlockable skins — From Bud to Void, common to mythic rarity
- ✨ 15 trail effects — Puff, spark, flame, rainbow, nebula, and more
- 💎 Power-up pickups — Magnet, Double Score, Slow Motion, Shield, Ghost Mode
- 🔥 FRENZY mode — Chain 3 perfect passes for 2× points
- ⚡ Clutch escapes — Near-death saves with bonus score
- 🎵 Synthesized audio — Zero audio files, all generated with Web Audio API
- 🎹 Dynamic music — Layers build with intensity as you score higher
- 🏆 Local leaderboard — Compete for the top spot
- 🛡️ Revive system — Spend coins to continue after death
| World | Score | Vibe |
|---|---|---|
| 🌿 Meadow | 0 | Bright skies, green pipes |
| 🌅 Sunset | 25 | Warm oranges, golden hour |
| 🌙 Night | 50 | Deep indigo, glowing pipes |
| ❄️ Arctic | 80 | Icy blues, frozen landscape |
| 🌋 Volcanic | 120 | Red-hot lava, dangerous |
| 🌌 Cosmic | 180 | Purple nebula, starfield |
| ✨ Celestial | 250 | Golden heavens |
| 💜 Neon | 350 | Electric pink, maximum difficulty |
# Clone the repo
git clone https://github.com/DLinacre/KushCloud.git
cd KushCloud
# Install & run
npm install --legacy-peer-deps
npm run devThen open http://localhost:5000 in your browser.
| Tech | Purpose |
|---|---|
| React 19 | UI framework |
| TypeScript | Type safety |
| Canvas 2D | 60fps game rendering |
| Web Audio API | Synthesized music & SFX |
| Tailwind CSS 4 | UI styling |
| Vite | Build tool |
Score = Base Points × Combo Multiplier × Frenzy Multiplier
┌─────────────────────────────────────────────────┐
│ Combo: 1× → 2× (4 passes) → 3× (8) → ...10× │
│ Frenzy: 2× (3 perfect passes in a row, 6 sec) │
│ Clutch: +3× (extremely tight escape) │
│ Near Miss: +1× (close call bonus) │
│ Perfect Pass: +2× (centre of the gap) │
└─────────────────────────────────────────────────┘
src/
├── components/ # React components (GameCanvas, KushLogo)
├── game/ # Core game engine & logic
│ ├── engine.ts # Main game loop, physics, rendering
│ ├── audio.ts # Web Audio synthesized music & SFX
│ ├── data.ts # Skins, trails, worlds, power-ups
│ ├── powerups.ts # Power-up activation & modifiers
│ ├── storage.ts # localStorage save/load
│ ├── leaderboard.ts # Local leaderboard
│ └── runProcessing.ts # Score validation & dedup
├── screens/ # UI screens (Menu, Play, Shop, etc.)
└── ui.tsx # Shared UI components
npm run dev # Start dev server
npm run build # Production build
npm run test # Run tests
npm run test:coverage # Test coverage report
npm run typecheck # TypeScript check
npm run lint # ESLint check
npm run lint:fix # Auto-fix lint issuesMIT License — See LICENSE
The cloud leaderboard has been broken since v1.1.6 for two account-level reasons. The code is already fixed — both steps below are settings, not code.
Every workflow on this account fails instantly (even a 2-line test job) with no logs — that is GitHub blocking Actions at the account level, almost always a billing/entitlement issue on the account.
- Go to github.com/settings/billing (or Settings → Billing and plans).
- Fix any failed payment / settle the plan, or switch to the Free plan.
- Then trigger a deploy: Actions → "Deploy Web to GitHub Pages" → Run workflow (or push any commit — the game auto-redeploys).
Verify: the live game loads at dlinacre.github.io/KushCloud with real gameplay (the current live build is stale/broken from the blocked deploys).
The Firebase Realtime Database currently returns Permission denied (401)
for both reads and writes — the security rules were never published, so the
database is deny-all. The correct rules are in the repo:
docs/firebase-database.rules.json.
- Open console.firebase.google.com → project
kushcloud-25cd5. - Build → Realtime Database → Rules tab.
- Replace everything with the contents of
docs/firebase-database.rules.json→ Publish. - Verify:
curl "https://kushcloud-25cd5-default-rtdb.europe-west1.firebasedatabase.app/leaderboards/all.json?orderBy=%22score%22&limitToLast=5"should return{}or entries — notPermission denied.
Then play one run on two devices — scores appear within ~15 seconds (the leaderboard now auto-refreshes every 15s while open).