Skip to content

zer0dayf/neon-runner-2084

Repository files navigation

🎮 Neon Runner 2084

Neon Runner 2084 Platform Status

A synthwave-themed 3D tunnel runner game built with React, Three.js, and Capacitor.

Report Bug


🌟 Features (v3.1.0)

  • 🎯 5 Unique Stages - Progressive difficulty with distinct obstacle types.
  • ♾️ Infinite Mode - Endless challenge with high score tracking.
  • 🎨 Synthwave Aesthetics - Neon colors, retro sun, and 80s vibes.
  • 📳 Native Haptics - Deep Android device haptic integration for crashes and satisfying level progression.
  • 📱 Mobile Ready - Swipe and tap controls for touch devices, with a GPU-accelerated smooth UI.
  • ⌨️ Keyboard Support - Arrow keys and WASD for desktop.
  • 🎵 Immersive Audio - Zero-latency Web Audio API-driven retro soundtrack and SFX.
  • 💾 Progress Saving - Track your high scores and "Best Distance" milestones.

🎮 Gameplay

Navigate your neon sphere through a twisting cyberpunk tunnel, dodging obstacles as you race toward the synthwave sun. Master the controls, avoid the hazards, and achieve the highest score!

Obstacle Types

Type Description
🟥 Block Static cube obstacles
🟡 Ring Torus gates with safe passage zones
🟣 Spinner Rotating bar obstacles
🔴 Double Spinner Cross-shaped rotating hazards

Controls

Platform Controls
Desktop Arrow Keys / A-D
Mobile (Swipe) Drag left/right
Mobile (Tap) Tap left/right side of screen

🛠️ Tech Stack

Technology Purpose
React 19 UI Framework
Three.js 3D Rendering
@react-three/fiber React Three.js Renderer
@react-three/drei Three.js Helpers
@react-three/postprocessing Visual Effects
Vite Build Tool
Capacitor Android Packaging & Haptics
TailwindCSS UI Styling

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/zer0dayf/neon-runner-2084.git
cd neon-runner-2084

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

Build & Deploy for Android

npm run build
npx cap sync android
cd android && ./gradlew bundleRelease

📁 Project Structure

neon-runner-2084/
├── App.tsx              # Main app component & state management
├── components/
│   ├── GameScene.tsx    # 3D scene orchestrator
│   ├── Track.tsx        # Game logic & player controls
│   ├── UIOverlay.tsx    # All UI screens & HUD
│   ├── WorldComponents.tsx # Decorative 3D objects
│   ├── Effects.tsx      # Post-processing effects
│   └── AudioManager.tsx # Sound management
├── constants.ts         # Game constants & track curve
├── types.ts             # TypeScript interfaces
├── android/             # Capacitor Android project
└── public/              # Audio assets

🎯 Roadmap

  • iOS support via Capacitor
  • Leaderboard system
  • Additional game modes
  • Power-ups and collectibles
  • Custom player skins

📄 License

Proprietary Software - All Rights Reserved

The source code and all assets (audio, visuals, code structure) of Neon Runner 2084 are strictly proprietary and intended for commercial use by the author. No reproduction, modification, copying, or redistribution is permitted. Please review the LICENSE file for more details.


👤 Author

zer0dayf (Efe)


Made with 💜 and lots of neon lights

Race through the neon-lit tunnels of 2084!

About

Retro-runner themed, mobile/web based infinite runner platform game.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors