🚀 Citrus Runner – Built with Phaser, React, and Vite

• 📺 Demo
• 🎮 Game Features
• 🛠️ Tech Stack
• 🚧 How to Run Locally
• 💡 Future Improvements
• 🧾 License
• ✨ Acknowledgments
• 🙋‍♂️ Author

An endless runner game inspired by Subway Surfers and Jetpack Joyride, featuring power-ups, structured token patterns, and polished jump physics. Built as part of a hackathon project to demonstrate modular game architecture using modern JavaScript tooling and ability to use AI.

📺 Demo

Try the game live here: https://runner.kokeh.dev

🎮 Game Features

• ✅ Smooth jump mechanics with consistent gravity suspension
• ✅ Structured token spawning system inspired by Subway Surfers
• ✅ Powerups:
  • Magnet: Attracts nearby tokens
  • Double Coins: Doubles token value
• ✅ Obstacle factory supporting varied group and single obstacles
• ✅ Modular and scalable codebase (React + Phaser + Vite)
• ✅ Pause/Resume system controlled via UI
• ✅ Google Sign-in integration (via Bedrock Passport)

---

🛠️ Tech Stack

---

🚧 How to Run Locally

• Clone the repo

git clone https://github.com/itskokeh/citrus-runner.git
cd citrus-runner

• Install dependencies

pnpm install

• Run the game

pnpm dev

• Build for production

pnpm build

---

💡 Future Improvements

• Add leaderboard and scoring system
• Mobile responsiveness and touch gesture support
• Sound effects and background music
• Daily missions or goals

---

🧾 License

This project is open source under the MIT License.

---

✨ Acknowledgments

• Phaser documentation and examples
• Subway Surfers for inspiration
• Bedrock Passport for seamless auth
• Hackathon organizers and mentors

---

🙋‍♂️ Author

Okechukwu Okeke
GitHub: @itskokeh
Email: kokeh@proton.me
Port Harcourt, Nigeria

---