MazeEngine

Practice 3D space calculations and algorithms for generating and solving mazes.

& & dat.GUI

Quick Start

npm install
npm run dev

Open the app in your browser (Vite URL shown in terminal).

Scripts

• npm run dev: Start local dev server.
• npm run build: Type-check + production build.
• npm run preview: Preview built output from dist.
• npm run lint: Run filename + ESLint checks.
• npm run test: Run lint then build (project quality gate).
• npm run format: Format project with Prettier.

Browser Compatibility Policy

MazeEngine targets modern browsers with native PointerEvent support.

• Supported baseline: current stable Chrome, Edge, Firefox, and Safari.
• Mobile baseline: Safari on iOS/iPadOS 13.4+ and Chrome on Android (current stable).
• Legacy browsers without PointerEvent are out of scope.
• Toolbar/popup interactions are implemented with pointer events only (no legacy touchstart + mousedown fallback).

Documentation

• Contributing Guide
• Architecture Overview
• How to Add a Generator
• Common Maze Rules
• Onboarding Guide

Project Focus Areas

• Maze generation algorithms (src/generator)
• Maze solving algorithms (src/solve)
• Sidebar popup workflows (src/sidebar/popup)
• 3D rendering and app orchestration (src/app, src/maze)