Wayfinding Alpha

Premium 3D indoor wayfinding & directory web app.

Tech Stack

• React 19 + TypeScript + Vite
• React Three Fiber + Drei (3D rendering)
• TailwindCSS v4 (styling)
• Zustand (state management)
• Mapbox GL JS (outdoor maps)
• ngraph.path (NBA* pathfinding)

Getting Started

npm install
npm run dev

Open http://localhost:5173

Project Structure

src/
  components/
    canvas/     # R3F 3D components
    ui/         # HTML/Tailwind overlay components
  logic/        # Pure math/algorithms
  store/        # Zustand state stores
  types/        # TypeScript interfaces
  data/         # Mock venue JSON data
  hooks/        # Custom React hooks
.context/       # Agent context files (8 docs)
infra/          # GCP setup scripts