# antovu/mavigator architecture

> Architecture diagram of the GitHub repository antovu/mavigator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antovu/mavigator
- Repository: https://github.com/antovu/mavigator

## Overview

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: [`src/hooks/use-place-route.ts`](https://github.com/antovu/mavigator/blob/main/src/hooks/use-place-route.ts) (Place route hook), [`src/app/map/index.tsx`](https://github.com/antovu/mavigator/blob/main/src/app/map/index.tsx) (Campus map), [`src/routing/route.ts`](https://github.com/antovu/mavigator/blob/main/src/routing/route.ts) (Route planner), [`src/components/map/map-search.tsx`](https://github.com/antovu/mavigator/blob/main/src/components/map/map-search.tsx) (Place search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_map["Campus map<br/>[index.tsx]"]
  node_search["Place search<br/>[map-search.tsx]"]
  node_route_screen["Route screen<br/>[route-screen.tsx]"]
  node_indoor["Indoor navigation<br/>[indoor.tsx]"]
  node_parking["Parking view<br/>[index.tsx]"]
  node_parking_drawer["Lot recommendations<br/>[parking-drawer.tsx]"]
  node_schedule_ui["Schedule screen<br/>[index.tsx]"]
end

subgraph group_places["Campus places"]
  node_place_data[("Campus places<br/>[campus-pois.ts]")]
  node_building_lookup["Building lookup<br/>[buildings.ts]"]
  node_map_data[("Campus map data<br/>[campus-lots.ts]")]
  node_indoor_data[("Indoor floor plans<br/>[campus-indoor.ts]")]
end

subgraph group_navigation["Navigation"]
  node_place_route["Place route hook<br/>[use-place-route.ts]"]
  node_routing_hook["Route orchestration<br/>[use-place-route.ts]"]
  node_route_engine["Route planner<br/>[route.ts]"]
  node_amenities["Amenity finder<br/>[amenities.ts]"]
end

subgraph group_personal["Personal planning"]
  node_schedule["Class schedule"]
  node_settings["Settings<br/>[index.tsx]"]
  node_permit_rules["Parking permits<br/>[parking-permits.ts]"]
end

subgraph group_storage["Saved preferences"]
  node_saved_state[("Saved settings")]
end

node_student(("Student"))

node_student -->|"explores campus"| node_map
node_student -->|"searches places"| node_search
node_search -.->|"requests destination"| node_place_route
node_student -->|"opens directions"| node_route_screen
node_route_screen -->|"resolves route"| node_place_route
node_place_route -->|"plans path"| node_route_engine
node_place_route -->|"finds amenity"| node_amenities
node_amenities -->|"routes to target"| node_route_engine
node_place_route -->|"looks up destination"| node_building_lookup
node_student -->|"opens floor route"| node_indoor
node_student -->|"checks parking"| node_parking
node_parking -->|"shows recommendations"| node_parking_drawer
node_parking_drawer -->|"checks eligibility"| node_permit_rules
node_student -->|"manages classes"| node_schedule_ui
node_schedule_ui -->|"reads schedule"| node_schedule
node_schedule -->|"persists schedule"| node_saved_state
node_student -->|"changes preferences"| node_settings
node_settings -.->|"saves preferences"| node_saved_state
node_map -->|"renders places"| node_place_data
node_map -->|"renders lots"| node_map_data
node_indoor -->|"loads floor plans"| node_indoor_data
node_route_engine -.->|"uses campus graph"| node_map_data

click node_map "https://github.com/antovu/mavigator/blob/main/src/app/map/index.tsx"
click node_search "https://github.com/antovu/mavigator/blob/main/src/components/map/map-search.tsx"
click node_place_route "https://github.com/antovu/mavigator/blob/main/src/hooks/use-place-route.ts"
click node_route_screen "https://github.com/antovu/mavigator/blob/main/src/components/routing/route-screen.tsx"
click node_indoor "https://github.com/antovu/mavigator/blob/main/src/app/map/indoor.tsx"
click node_parking "https://github.com/antovu/mavigator/blob/main/src/app/parking/index.tsx"
click node_parking_drawer "https://github.com/antovu/mavigator/blob/main/src/components/parking/parking-drawer.tsx"
click node_schedule "https://github.com/antovu/mavigator/blob/main/src/context/schedule-context.tsx"
click node_schedule_ui "https://github.com/antovu/mavigator/blob/main/src/app/schedule/index.tsx"
click node_settings "https://github.com/antovu/mavigator/blob/main/src/app/settings/index.tsx"
click node_place_data "https://github.com/antovu/mavigator/blob/main/src/data/campus-pois.ts"
click node_building_lookup "https://github.com/antovu/mavigator/blob/main/src/data/buildings.ts"
click node_map_data "https://github.com/antovu/mavigator/blob/main/src/data/campus-lots.ts"
click node_indoor_data "https://github.com/antovu/mavigator/blob/main/src/data/campus-indoor.ts"
click node_routing_hook "https://github.com/antovu/mavigator/blob/main/src/hooks/use-place-route.ts"
click node_route_engine "https://github.com/antovu/mavigator/blob/main/src/routing/route.ts"
click node_amenities "https://github.com/antovu/mavigator/blob/main/src/routing/amenities.ts"
click node_permit_rules "https://github.com/antovu/mavigator/blob/main/src/constants/parking-permits.ts"
click node_saved_state "https://github.com/antovu/mavigator/blob/main/src/state/key-value-storage.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_map,node_search,node_route_screen,node_indoor,node_parking,node_parking_drawer,node_schedule_ui toneBlue
class node_place_data,node_building_lookup,node_map_data,node_indoor_data toneAmber
class node_place_route,node_routing_hook,node_route_engine,node_amenities toneMint
class node_schedule,node_settings,node_permit_rules toneRose
class node_saved_state,node_student toneIndigo
```

## Components

### Student experience

- [Campus map](https://github.com/antovu/mavigator/blob/main/src/app/map/index.tsx): `src/app/map/index.tsx`
- [Place search](https://github.com/antovu/mavigator/blob/main/src/components/map/map-search.tsx): `src/components/map/map-search.tsx`
- [Route screen](https://github.com/antovu/mavigator/blob/main/src/components/routing/route-screen.tsx): `src/components/routing/route-screen.tsx`
- [Indoor navigation](https://github.com/antovu/mavigator/blob/main/src/app/map/indoor.tsx): `src/app/map/indoor.tsx`
- [Parking view](https://github.com/antovu/mavigator/blob/main/src/app/parking/index.tsx): `src/app/parking/index.tsx`
- [Lot recommendations](https://github.com/antovu/mavigator/blob/main/src/components/parking/parking-drawer.tsx): `src/components/parking/parking-drawer.tsx`
- [Schedule screen](https://github.com/antovu/mavigator/blob/main/src/app/schedule/index.tsx): `src/app/schedule/index.tsx`

### Campus places

- [Campus places](https://github.com/antovu/mavigator/blob/main/src/data/campus-pois.ts): `src/data/campus-pois.ts`
- [Building lookup](https://github.com/antovu/mavigator/blob/main/src/data/buildings.ts): `src/data/buildings.ts`
- [Campus map data](https://github.com/antovu/mavigator/blob/main/src/data/campus-lots.ts): `src/data/campus-lots.ts`
- [Indoor floor plans](https://github.com/antovu/mavigator/blob/main/src/data/campus-indoor.ts): `src/data/campus-indoor.ts`

### Navigation

- [Place route hook](https://github.com/antovu/mavigator/blob/main/src/hooks/use-place-route.ts): `src/hooks/use-place-route.ts`
- [Route orchestration](https://github.com/antovu/mavigator/blob/main/src/hooks/use-place-route.ts): `src/hooks/use-place-route.ts`
- [Route planner](https://github.com/antovu/mavigator/blob/main/src/routing/route.ts): `src/routing/route.ts`
- [Amenity finder](https://github.com/antovu/mavigator/blob/main/src/routing/amenities.ts): `src/routing/amenities.ts`

### Personal planning

- [Class schedule](https://github.com/antovu/mavigator/blob/main/src/context/schedule-context.tsx): `src/context/schedule-context.tsx`
- [Settings](https://github.com/antovu/mavigator/blob/main/src/app/settings/index.tsx): `src/app/settings/index.tsx`
- [Parking permits](https://github.com/antovu/mavigator/blob/main/src/constants/parking-permits.ts): `src/constants/parking-permits.ts`

### Saved preferences

- [Saved settings](https://github.com/antovu/mavigator/blob/main/src/state/key-value-storage.ts): `src/state/key-value-storage.ts`

### Other components

- **Student**

## Connections

- 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 (evidence: `src/components/routing/route-screen.tsx`)
- Place route hook → Route planner: plans path (evidence: `src/hooks/use-place-route.ts`)
- Place route hook → Amenity finder: finds amenity (evidence: `src/hooks/use-place-route.ts`)
- Amenity finder → Route planner: routes to target (evidence: `src/routing/amenities.ts`)
- Place route hook → Building lookup: looks up destination (evidence: `src/hooks/use-place-route.ts`)
- Student → Indoor navigation: opens floor route
- Student → Parking view: checks parking
- Parking view → Lot recommendations: shows recommendations (evidence: `src/app/parking/index.tsx`)
- Lot recommendations → Parking permits: checks eligibility (evidence: `src/components/parking/parking-drawer.tsx`)
- Student → Schedule screen: manages classes
- Schedule screen → Class schedule: reads schedule (evidence: `src/app/schedule/index.tsx`)
- Class schedule → Saved settings: persists schedule (evidence: `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
