How kurtisho/optirun-android works
OptiRun is an Android running-planner app. A runner chooses a start location and weather, terrain, and distance preferences; the app then finds suitable forecast windows and a suggested loop, presenting both on a results screen. The graph preserves the separate place-search, location, weather, route, and domain-scoring stages. Connections are cited where the supplied excerpts or source index establish them; external service links are dashed because no host or network-call implementation was shown.
Main entry points: ResultsViewModel.kt Plan orchestration · ResultsScreen.kt Plan presentation · OrsApi.kt ORS adapter · model Planning data models
Components 20
App experience
- App entry
app/src/main/java/com/kurtis/optirun/MainActivity.kt - Navigation
app/src/main/java/com/kurtis/optirun/ui/Navigation.kt - Run preferences
app/src/main/java/com/kurtis/optirun/ui/home/HomeScreen.kt - Plan presentation
app/src/main/java/com/kurtis/optirun/ui/results/ResultsScreen.kt - Route map
app/src/main/java/com/kurtis/optirun/ui/results/RouteMap.kt
Start selection
- Place search state
app/src/main/java/com/kurtis/optirun/ui/home/HomeViewModel.kt - Current location
app/src/main/java/com/kurtis/optirun/data/location/LocationProvider.kt
Data services
- Place lookup
app/src/main/java/com/kurtis/optirun/data/route/PlaceRepository.kt - ORS adapter
app/src/main/java/com/kurtis/optirun/data/route/OrsApi.kt - Loop generation
app/src/main/java/com/kurtis/optirun/data/route/RouteRepository.kt - Forecast mapping
app/src/main/java/com/kurtis/optirun/data/weather/WeatherRepo.kt - Forecast adapter
app/src/main/java/com/kurtis/optirun/data/weather/OpenMeteoApi.kt
Run planning
- Plan orchestration
app/src/main/java/com/kurtis/optirun/ui/results/ResultsViewModel.kt - Weather window scoring
app/src/main/java/com/kurtis/optirun/domain/usecase/WindowMatcher.kt - Terrain matching
app/src/main/java/com/kurtis/optirun/domain/usecase/TerrainClassifier.kt - Elevation calculations
app/src/main/java/com/kurtis/optirun/domain/usecase/ElevationMath.kt - Planning data models
app/src/main/java/com/kurtis/optirun/domain/model
Other components
- Runner
- OpenRouteService
- Open-Meteo
Connections 26
- Runner → App entry: opens app
- App entry → Navigation: starts navigation
- Navigation → Run preferences: routes to
app/src/main/java/com/kurtis/optirun/ui/Navigation.kt - Navigation → Plan presentation: routes to
app/src/main/java/com/kurtis/optirun/ui/Navigation.kt - Runner → Run preferences: sets preferences
app/src/main/java/com/kurtis/optirun/ui/home/HomeScreen.kt - Run preferences → Place search state: searches places
app/src/main/java/com/kurtis/optirun/ui/home/HomeScreen.kt - Place search state → Place lookup: requests suggestions
app/src/main/java/com/kurtis/optirun/ui/home/HomeViewModel.kt - Place search state → Current location: requests location
app/src/main/java/com/kurtis/optirun/ui/home/HomeViewModel.kt - Place lookup → ORS adapter: geocodes query
app/src/main/java/com/kurtis/optirun/data/route/PlaceRepository.kt - ORS adapter → OpenRouteService: calls geocoding
- Plan orchestration → Current location: gets location
app/src/main/java/com/kurtis/optirun/ui/results/ResultsViewModel.kt - Plan orchestration → Forecast mapping: fetches forecast
app/src/main/java/com/kurtis/optirun/ui/results/ResultsViewModel.kt - Plan orchestration → Loop generation: requests loops
app/src/main/java/com/kurtis/optirun/ui/results/ResultsViewModel.kt - Forecast mapping → Forecast adapter: requests hourly data
app/src/main/java/com/kurtis/optirun/data/weather/WeatherRepo.kt - Forecast adapter → Open-Meteo: fetches forecast
- Loop generation → ORS adapter: requests round trips
app/src/main/java/com/kurtis/optirun/data/route/RouteRepository.kt - ORS adapter → OpenRouteService: requests routes
- Loop generation → Elevation calculations: computes ascent
app/src/main/java/com/kurtis/optirun/data/route/RouteRepository.kt - Plan orchestration → Weather window scoring: scores windows
app/src/main/java/com/kurtis/optirun/ui/results/ResultsViewModel.kt - Plan orchestration → Terrain matching: selects terrain
app/src/main/java/com/kurtis/optirun/ui/results/ResultsViewModel.kt - Plan orchestration → Plan presentation: supplies plan state
app/src/main/java/com/kurtis/optirun/ui/results/ResultsScreen.kt - Plan presentation → Route map: renders route
app/src/main/java/com/kurtis/optirun/ui/results/ResultsScreen.kt - Weather window scoring → Planning data models: uses weather and preferences
app/src/main/java/com/kurtis/optirun/domain/usecase/WindowMatcher.kt - Terrain matching → Planning data models: classifies route
app/src/main/java/com/kurtis/optirun/domain/usecase/TerrainClassifier.kt - Plan presentation → Planning data models: displays plan data
app/src/main/java/com/kurtis/optirun/ui/results/ResultsScreen.kt - Route map → Planning data models: draws route path
app/src/main/java/com/kurtis/optirun/ui/results/RouteMap.kt