FLUX — Gravity-Flip Neon Runner

# FLIP. FLOW. FLY.

**FLUX** is a fast-paced, one-button arcade runner where a single press flips your entire world upside down. One tap sends you from floor to ceiling. One mistimed flip ends your run. One near-miss builds your combo. One more run becomes fifty.

Built as a single self-contained HTML file — no downloads, no plugins, no loading screens. Open it in any browser and play immediately.

---

## CORE GAMEPLAY

One button. That's all you need.

Press **SPACE** (or tap anywhere) to reverse gravity. Your glowing orb launches from the floor to the ceiling, arcing through a neon corridor of spikes, walls, moving blocks, and narrow corridors. The world scrolls faster with every meter. The music intensifies. The obstacles get denser. The near-misses get closer.

- **Near-miss combo system** — thread the needle past obstacles for stacking score multipliers. Build a 30x combo and watch the screen ignite.

- **Beat Match** — collect orbs exactly on the musical downbeat for a 1.5x score bonus and a satisfying chime. The rhythm becomes your weapon.

- **4 power-ups** — Shield (absorb one hit), Magnet (vacuum orbs), Slow-Mo (halve world speed), 2X Score (double all points).

---

## GAME MODES

| Mode | Description | Unlock |

|------|-------------|--------|

| **Endless** | The core experience. Survive as long as possible. Score climbs with distance, orbs, and combos. | Available from start |

| **Bolt Mode** | Control TWO orbs simultaneously — one on the floor, one on the ceiling. Both flip together. Either dies, game over. Doubles the cognitive load, doubles the skill expression. | Complete tutorial |

| **Daily Challenge** | Same seeded obstacle layout for all players each day. Compete locally for the best daily score. | Complete tutorial |

| **Zen Mode** | No death. No pressure. Just flow and collect. The perfect warm-up or cooldown. | Reach 500m total distance |

| **Tutorial** | 4-step guided intro teaches flipping, collecting, dodging, and near-missing in under 60 seconds. | Available from start |

---

## ENDLESS EVOLUTION — 4 BIOMES

Every 1000 meters transports you to a new biome with unique visuals, physics, obstacles, and power-ups:

**Neon City (0m)** — The default experience. Cyan and magenta glow on deep blue. Standard gravity, standard speed. Spikes, walls, moving blocks, corridors.

**Crystal Caves (1000m)** — Icy blue palette with crystalline obstacles. Wider ice spikes, taller crystal walls. New power-up: **Ice Skate**.

**Inferno (2000m)** — Red and orange heat. Heavier gravity (1.3x) for more urgent flips. Timed fire jets that cycle on and off. Rising lava waves from the floor. New power-up: **Fireproof** (immune to fire obstacles).

**Cosmos (3000m+)** — Deep purple cosmic void. Floaty low-gravity (0.55x) physics. Drifting asteroids. Pulsing gravity wells that pull you in. New power-up: **Gravity Anchor** (restores normal gravity temporarily).

---

## BOSS WAVES

Every 2000 meters, the game enters a **Boss Wave** — a 12-second gauntlet of rapid-fire obstacles with no orbs or power-ups. Pure survival. Clear it for a massive score bonus that scales with each wave cleared.

---

## COSMIC COMPOSER — MUSIC SYSTEM

All music is now **AI-composed**: 10 original loop-friendly tracks generated offline with ACE-Step 1.5, embedded directly in the HTML. The soundtrack adapts to your run: menu, per-biome gameplay themes, a boss-wave theme, and a game-over cue. A dynamic "intense" layer folds in as your combo and speed climb. Three styles are selectable in settings:

- **Synthwave** (138 BPM) — Driving neon arcade energy (menu + Neon City).

- **Chiptune** (160 BPM) — Fast NES-style square-wave arcade energy (chiptune).

- **Lo-Fi** (80 BPM) — Chill jazzy 7th-chord beats for relaxed runs.

Switch styles live in the settings menu. The music's intensity layers dynamically — the lead melody fades in as your speed and combo climb, and an octave layer joins at high intensity.

---

## FEATURES

- 🎮 **One-button gameplay** — SPACE, tap, or gamepad A to flip

- 🎵 **10 AI-composed original tracks** — menu, 4 biome themes, boss wave, game over, chiptune, lo-fi, and an intensity layer (ACE-Step 1.5)

- ⚡ **Near-miss combo system** with dynamic multipliers up to 30x+

- 🛡️ **7 power-up types** including biome-exclusive abilities

- 🌍 **4 biomes** with unique palettes, physics, and obstacle sets

- 💥 **Boss Waves** every 2000m for bonus score

- 🎼 **Beat Match** — collect orbs on the beat for 1.5x bonus

- 🎯 **Bolt Mode** — dual-orb simultaneous control

- 📅 **Daily Challenge** — seeded RNG, same layout for all players

- 🧘 **Zen Mode** — deathless flow state

- 🏆 **30 achievements** to chase

- 🌈 **9 unlockable skins** including rainbow and Bolt-exclusive

- 🎚️ **4 difficulty levels** — Easy / Normal / Hard / Insane

- ♿ **Accessibility** — color-blind palette, reduced motion, screen shake toggle

- 📱 **Keyboard, mouse, touch, and gamepad** support

- 💾 **localStorage persistence** — scores, unlocks, settings

- 📦 **Single HTML file** — no dependencies, no assets, instant load

---

## CONTROLS

| Input | Action |

|-------|--------|

| SPACE / W / S / ↑ / ↓ | Flip gravity |

| Mouse click / Tap | Flip gravity (touch/mouse) |

| Gamepad A | Flip gravity |

| ESC / P / Start | Pause |

| ↑↓ | Menu navigation |

| ←→ | Settings adjustment |

---

## TECHNICAL

- **Engine:** Pure vanilla JavaScript. Zero libraries. Zero frameworks.

- **Rendering:** Canvas 2D with shadow blur glow effects + 5 AI-painted 1280×720 biome/menu backgrounds (Z-Image-Turbo, embedded base64)

- **Audio:** Web Audio API with lookahead scheduler (Chris Wilson pattern)

- **Physics:** Fixed-rate per-frame integration with dt clamping

- **Performance:** Object pooling for particles, cached gradients, cached bounds

- **File size:** ~9MB single HTML file (embedded art + 10 AI music tracks)

- **Compatibility:** Chrome, Firefox, Edge, Safari. Desktop and mobile.