How antovu/mavigator works
Mavigator is a mobile-first campus map and navigation web app. Students explore/search campus places, select a destination and starting point, then receive outdoor or floor-by-floor indoor directions; the parking view recommends permitted lots for a class, and schedule/profile settings personalize these flows. The graph combines documented product stages with sampled route-planning and persistence internals. Some screen and subsystem wiring is documented only in the README or SOURCE INDEX, so unsampled connections are omitted rather than inferred.
Main entry points: use-place-route.ts Place route hook · index.tsx Campus map · route.ts Route planner · map-search.tsx Place search
Components 20
Student experience
- Campus map
src/app/map/index.tsx - Place search
src/components/map/map-search.tsx - Route screen
src/components/routing/route-screen.tsx - Indoor navigation
src/app/map/indoor.tsx - Parking view
src/app/parking/index.tsx - Lot recommendations
src/components/parking/parking-drawer.tsx - Schedule screen
src/app/schedule/index.tsx
Campus places
- Campus places
src/data/campus-pois.ts - Building lookup
src/data/buildings.ts - Campus map data
src/data/campus-lots.ts - Indoor floor plans
src/data/campus-indoor.ts
Navigation
- Place route hook
src/hooks/use-place-route.ts - Route orchestration
src/hooks/use-place-route.ts - Route planner
src/routing/route.ts - Amenity finder
src/routing/amenities.ts
Personal planning
- Class schedule
src/context/schedule-context.tsx - Settings
src/app/settings/index.tsx - Parking permits
src/constants/parking-permits.ts
Saved preferences
- Saved settings
src/state/key-value-storage.ts
Other components
- Student
Connections 22
- Student → Campus map: explores campus
- Student → Place search: searches places
- Place search → Place route hook: requests destination
- Student → Route screen: opens directions
- Route screen → Place route hook: resolves route
src/components/routing/route-screen.tsx - Place route hook → Route planner: plans path
src/hooks/use-place-route.ts - Place route hook → Amenity finder: finds amenity
src/hooks/use-place-route.ts - Amenity finder → Route planner: routes to target
src/routing/amenities.ts - Place route hook → Building lookup: looks up destination
src/hooks/use-place-route.ts - Student → Indoor navigation: opens floor route
- Student → Parking view: checks parking
- Parking view → Lot recommendations: shows recommendations
src/app/parking/index.tsx - Lot recommendations → Parking permits: checks eligibility
src/components/parking/parking-drawer.tsx - Student → Schedule screen: manages classes
- Schedule screen → Class schedule: reads schedule
src/app/schedule/index.tsx - Class schedule → Saved settings: persists schedule
src/context/schedule-context.tsx - Student → Settings: changes preferences
- Settings → Saved settings: saves preferences
- Campus map → Campus places: renders places
- Campus map → Campus map data: renders lots
- Indoor navigation → Indoor floor plans: loads floor plans
- Route planner → Campus map data: uses campus graph