How karlcyrus/navsu-augmented-reality-navigation-system works
NAvSU is a Unity Android campus-navigation app. A user finds and selects a destination, then the app localizes with GPS and Lightship WPS, computes a shortest route over the campus graph, and presents live AR, minimap, and navigation-card guidance. The README describes these relationships, but no source excerpts were provided; several documented capabilities therefore use their exact asset directory as the path, and the separate admin dashboard is shown only as a documented optional integration.
Main entry points: NavigationController.cs Navigation controller · DestinationButton.cs Destination selection · CampusBuildingImages Building directory · CategoryScreenManager.cs Category browsing
Components 19
Destination Discovery
- Category browsing
Assets/CategoryScreenManager.cs - Destination search
Assets/SearchFilter.cs - Destination selection
Assets/DestinationButton.cs - Building directory
Assets/CampusBuildingImages
Route Navigation
- Navigation controller
Assets/NavigationController.cs - WPS warmup
Assets/ARWarmupManager.cs - AR route markers
Assets/ArrowPrefab
Live Guidance
- Navigation card
Assets/NavigationTopCardUI.cs - Live minimap
Assets/MinimapController.cs - AR guide companion
Assets
Campus Data
- Navigation graph
- Office mappings
Assets/Resources/office_mapping.json - Building descriptions
Assets/Resources/building_descriptions.json - Minimap data
Assets/Resources/minimap_data.json
Other components
- Campus user
- Device GPS
- Lightship WPS
- Campus data API
- Admin dashboard
Connections 19
- Campus user → Category browsing: browses
- Campus user → Destination search: searches
- Campus user → Destination selection: selects
- Category browsing → Destination selection: offers
- Destination search → Destination selection: finds
- Destination selection → Navigation controller: starts
- Navigation controller → WPS warmup: primes localization
- Navigation controller → Device GPS: reads position
- Navigation controller → Lightship WPS: checks localization
- Navigation controller → Navigation graph: loads graph
- Navigation controller → AR route markers: spawns markers
- Navigation controller → Navigation card: feeds guidance
- Navigation controller → Live minimap: feeds path
- Live minimap → Minimap data: uses map data
- Building directory → Building descriptions: presents details
- Building directory → Office mappings: uses mappings
- Navigation controller → AR guide companion: accompanies user
- Admin dashboard → Campus data API: manages data
- Navigation controller → Campus data API: syncs data