A high-performance, modular, and immersive web-based puzzle adventure built for the modern browser.
-
Procedural Maze Generation
Every sector is unique. Leveraging the Recursive Backtracking algorithm to ensure complex, perfectly solvable mazes every session. -
Dynamic Star Progression
A competitive 3-star rating system based on speed and efficiency. Race against the decaying time-bar to secure a perfect rating. -
Persistent Progress
Your journey is saved. Unlock new sectors as you progress and return to your highest level anytime via local data persistence. -
Arcade-Style Fluidity
Silky-smooth movement using linear interpolation (lerp) and a high-performancerequestAnimationFramerender loop at 60fps. -
Immersive Glassmorphism UI
A professional "Sector Control" interface featuring backdrop blurs, glowing HUD elements, and animated floating modals. -
Intelligent Path Highlighting
An adaptive energy trail that tracks your progress through the maze and intelligently erases itself during backtracks. -
Keyboard & Touch Optimized
Seamless control via WASD, Arrow Keys, or On-screen Joypad for high-speed navigation on any device. -
Accessibility & UX
ARIA-compliant structures, high-contrast visual cues, and focus-managed menus ensure a seamless experience for all players.
| Layer | Technology |
|---|---|
| Engine | Vanilla TypeScript |
| Rendering | HTML5 Canvas API (2D Context) |
| Styling | Tailwind CSS v3 |
| Build Tool | Vite |
| Persistence | Browser LocalStorage API |
| Testing | Jest + ts-jest |
| Animations | CSS Keyframes + Canvas Lerp |
| Deployment | Vercel (Edge Network) |
| CI/CD | Vercel (Auto-deployment) |
-
Clone the repository:
git clone https://github.com/your-username/maze-runner.git cd maze-runner -
Install dependencies:
npm install
-
Development Mode: Launch the Vite development server with Hot Module Replacement (HMR):
npm run dev
-
Run Unit Tests: Verify core logic (Maze Gen, Player Physics, Storage):
npm test -
Production Build: Generate an optimized, minified bundle:
npm run build
Maze Runner is built with a strictly decoupled architecture for long-term maintainability and performance, optimized for high-speed delivery via Vercel's Global Edge Network:
GameEngine: The central orchestrator managing state transitions, input handling, and the core game loop.Renderer: A pure drawing layer that handles all Canvas operations, lighting effects, and path logic with zero side effects.Maze: A standalone logic class for procedural generation and efficient grid validation.Storage: A modular interface for managing persistent player data, unlocking sectors, and tracking star ratings.UI Components: Modular classes (HUD,Menu,Modal) that manage the DOM-based interface independently from the game canvas.
This application was architected and developed using OpenCode and Antigravity, leveraging advanced agentic coding workflows to ensure clean architecture, professional UI design, and rigorous git discipline.
"Engineering is the art of making the complex feel simple."
Distributed under the MIT License. See LICENSE for the full text.
⚡ Find the exit. Beat the clock. Master the maze.