AEXORA Subway

A browser-based Subway Surfers-style endless runner built with Three.js. Plays on any device with WebGL support (desktop, mobile, tablet). Deploy to Coolify via the CI/CD pipeline.

Features

Core Subway Surfers mechanics

• Lane-switching (left/center/right) on a 3-lane track
• Jump and slide to avoid barriers
• Coin collection with multiplier ramps
• Speed that increases with distance
• Obstacle avoidance (barriers + barrels)

Unique twists

• Board Customizer — paint your hoverboard directly on canvas with a neon brush, custom colors, and brush sizes. Your design rides with you.
• Powerups — Magnet (pulls coins) and Invincibility (glowing trail through obstacles)
• Neon aesthetic — cyberpunk tunnel with cityscape background and glowing rails
• Works on every device — Three.js WebGL, keyboard on desktop, touch swipe on mobile/tablet

Controls

Action	Desktop	Mobile
Move L	← / A	Swipe left
Move R	→ / D	Swipe right
Jump	↑ / Space	Swipe up
Slide	↓ / S	Swipe down

Tech stack

Layer	Tech
Engine	Three.js r164 (WebGL)
Language	Vanilla JS (ES modules)
Serve	nginx:alpine on port 8080
Deploy	Coolify (Forgejo registry)
CI	Jenkins → image build → push

Deployment

See JENKINSFILE and docker-compose.yml — follows the Estate CI/CD pattern: Jenkins builds the image → pushes to internal Forgejo registry → preloads onto Coolify host → Coolify serves via CUSTOM_IMAGE/CUSTOM_TAG.