How irshadm/volta-android works
Volta is an Android companion for MG electric cars, with no Volta server. The main journey is to sign in to MG i-SMART, view vehicle status, and plan a route with charging and meal stops; live trips can re-plan when behind schedule. The app also supports remote controls, energy tracking, smart pre-cool, Android Auto, and a widget. The graph separates the user-facing app, vehicle and persistence layer, trip planning, and background services. Relationships are limited to README statements and the shown excerpts or source-index references; many UI and service internals were not sampled.
Main entry points: IsmartRepository.kt Vehicle repository · TripRepository.kt Live trip repository · SettingsRepository.kt Settings repository · HomeScreen.kt Dashboard and controls
Components 30
App experience
- Sign-in and setup
feature/onboarding/src/main/kotlin/dev/irshadm/volta/feature/onboarding/signin/SignInScreen.kt - Dashboard and controls
app/src/main/kotlin/dev/irshadm/volta/ui/home/HomeScreen.kt - Energy tracking
app/src/main/kotlin/dev/irshadm/volta/ui/energy/EnergyScreen.kt - Settings
app/src/main/kotlin/dev/irshadm/volta/ui/settings/SettingsScreen.kt - Android Auto
app/src/main/kotlin/dev/irshadm/volta/car/VoltaCarAppService.kt - Home widget
app/src/main/kotlin/dev/irshadm/volta/widget/VoltaWidget.kt - Trip planning UI
app/src/main/kotlin/dev/irshadm/volta/ui/plan/PlanScreen.kt - Design system
core/designsystem/src/main/kotlin/dev/irshadm/volta/core/designsystem/VoltaIcons.kt
Vehicle and data
- Vehicle repository
app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt - MG i-SMART client
core/ismart/src/main/kotlin/dev/irshadm/volta/core/ismart/MgIsmartClient.kt - Settings repository
app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt - Battery readings
app/src/main/kotlin/dev/irshadm/volta/data/SocRepository.kt - Local database
app/src/main/kotlin/dev/irshadm/volta/data/db/AppDatabase.kt - Vehicle status model
core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleStatus.kt - Trip settings model
core/model/src/main/kotlin/dev/irshadm/volta/core/model/TripSettings.kt - Vehicle profile model
core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleProfile.kt
Trip planning
- Route and energy planner
core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/TripPlanner.kt - Meal-stop planner
core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/MealPlanner.kt - Live trip repository
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Phone location
app/src/main/kotlin/dev/irshadm/volta/data/trip/LocationProvider.kt - Maps client
app/src/main/kotlin/dev/irshadm/volta/data/maps/GoogleMapsClient.kt - Route geometry
core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/Geo.kt
Background features
- Car check worker
app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt - Alerts and notifications
app/src/main/kotlin/dev/irshadm/volta/service/Notifications.kt - Smart pre-cool
app/src/main/kotlin/dev/irshadm/volta/service/smart/SmartPrecool.kt - Cabin cooling model
app/src/main/kotlin/dev/irshadm/volta/service/smart/Cooling.kt - Spin home charger
app/src/main/kotlin/dev/irshadm/volta/data/charger/SpinCharger.kt
Other components
- MG EV owner
- MG i-SMART
- Google Maps Platform
Connections 35
- MG EV owner → Sign-in and setup: signs in
README.md - MG EV owner → Dashboard and controls: checks car
README.md - MG EV owner → Trip planning UI: plans trip
README.md - MG EV owner → Energy tracking: tracks charging
README.md - Sign-in and setup → Vehicle repository: connects account
README.md - Sign-in and setup → Maps client: checks key
README.md - Dashboard and controls → Vehicle repository: shows status and sends commands
README.md - Settings → Settings repository: saves preferences
- Vehicle repository → MG i-SMART client: uses client
app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt - MG i-SMART client → MG i-SMART: reads and commands
README.md - Vehicle repository → Settings repository: uses settings
app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt - Vehicle repository → Battery readings: records readings
app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt - Vehicle repository → Local database: logs charge data
- Vehicle repository → Vehicle status model: produces status
app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt - Settings repository → Trip settings model: provides preferences
app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt - Settings repository → Vehicle profile model: provides profile
app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt - Trip planning UI → Live trip repository: requests plans
- Live trip repository → Vehicle repository: reads car status
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Live trip repository → Settings repository: reads trip settings
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Live trip repository → Phone location: reads location
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Live trip repository → Route and energy planner: replans route
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Live trip repository → Maps client: requests map data
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Route and energy planner → Meal-stop planner: plans meal stops
core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/MealPlanner.kt - Maps client → Google Maps Platform: requests routes and places
README.md - Maps client → Route geometry: uses geometry
app/src/main/kotlin/dev/irshadm/volta/data/maps/GoogleMapsClient.kt - Android Auto → Car check worker: checks after leaving car
app/src/main/kotlin/dev/irshadm/volta/car/VoltaCarAppService.kt - Car check worker → Vehicle repository: checks vehicle
app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt - Car check worker → Alerts and notifications: raises alerts
app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt - Live trip repository → Alerts and notifications: alerts on trip changes
app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt - Smart pre-cool → Cabin cooling model: models cooling
app/src/main/kotlin/dev/irshadm/volta/service/smart/SmartPrecool.kt - Dashboard and controls → Spin home charger: controls charger
README.md - MG EV owner → Smart pre-cool: reviews suggestion
README.md - MG EV owner → Android Auto: uses in car
README.md - MG EV owner → Home widget: checks widget
README.md - Dashboard and controls → Design system: renders with