# 🌀 GRAVITY FLIPPER

> A high-speed quantum inversion reflex runner built with pure vanilla HTML5 Canvas and Web Audio API.

---

## 🎮 How to Play

### Option 1: Direct File
Open [index.html](file:///Users/zameer/Documents/antigravity/games/gravity-flipper/index.html) directly in any modern browser.

### Option 2: From the Arcade Hub
Open the master [Arcade Hub](../../index.html) and click **"LAUNCH GAME"** on the Gravity Flipper card.

---

## ⌨️ Controls

| Action | Keyboard | Mouse / Touch |
| :--- | :--- | :--- |
| **Flip Gravity** | `Space`, `↑`, `↓`, `W`, `S` | **Click or Tap anywhere** |
| **Air Flip Rescue** | Press flip while airborne (1 charge) | Tap while airborne |
| **Pause / Resume** | `P`, `Esc` | Click Pause button |
| **Mute Audio** | `M` | Click Sound button |
| **Quick Restart** | `R` (on Game Over) | Click Retry Run |

---

## 🌟 Game Mechanics & Features

- **Quantum Inversion**: Flip gravity instantly between the floor and the ceiling.
- **Air Flip Charge**: You have 1 emergency mid-air flip charge to save yourself from mistimed leaps. Landing on any surface or collecting a Graviton Orb recharges it instantly.
- **Floating Energy Platforms**: Land on the top or bottom of floating platforms to navigate dangerous spike clusters.
- **Graviton Orbs (◆)**: Collect floating orbs to increase your score multiplier (up to **x8**) and recharge your air flip.
- **Warp Gates (🌀)**: High-speed portals that propel you forward, granting +600 points and warping space-time.
- **Dynamic Sectors**: Advance through sectors as your distance climbs:
  - **Sector 01**: Cyber Nexus (Cyan / Violet)
  - **Sector 02**: Plasma Core (Magenta / Yellow)
  - **Sector 03**: Solar Matrix (Amber / Orange)
  - **Sector 04**: Quantum Void (Emerald / Cyan)
  - **Sector 05**: Hyper Nebula (Electric Purple / Pink)
- **Procedural Synthesizer**: Built-in 4-on-the-floor synth drums, rolling bassline, crystal arpeggios, and responsive SFX (zero external audio files).
- **Persistent High Score**: Best scores are recorded automatically in `localStorage`.