# irshadm/volta-android architecture

> Architecture diagram of the GitHub repository irshadm/volta-android, 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/irshadm/volta-android
- Repository: https://github.com/irshadm/volta-android

## Overview

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: [`app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt`](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt) (Vehicle repository), [`app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt) (Live trip repository), [`app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt`](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt) (Settings repository), [`app/src/main/kotlin/dev/irshadm/volta/ui/home/HomeScreen.kt`](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/home/HomeScreen.kt) (Dashboard and controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_onboarding["Sign-in and setup<br/>[SignInScreen.kt]"]
  node_dashboard["Dashboard and controls<br/>[HomeScreen.kt]"]
  node_energy["Energy tracking<br/>[EnergyScreen.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
  node_androidauto["Android Auto"]
  node_widget["Home widget<br/>[VoltaWidget.kt]"]
  node_tripui["Trip planning UI<br/>[PlanScreen.kt]"]
  node_design["Design system<br/>[VoltaIcons.kt]"]
end

subgraph group_vehicle["Vehicle and data"]
  node_ismartrepo["Vehicle repository"]
  node_ismartclient["MG i-SMART client<br/>[MgIsmartClient.kt]"]
  node_settingsrepo["Settings repository"]
  node_socrepo["Battery readings<br/>[SocRepository.kt]"]
  node_database[("Local database<br/>[AppDatabase.kt]")]
  node_vehiclemodel["Vehicle status model<br/>[VehicleStatus.kt]"]
  node_tripsettings["Trip settings model<br/>[TripSettings.kt]"]
  node_profile["Vehicle profile model<br/>[VehicleProfile.kt]"]
end

subgraph group_journey["Trip planning"]
  node_planner["Route and energy planner<br/>[TripPlanner.kt]"]
  node_mealplanner["Meal-stop planner<br/>[MealPlanner.kt]"]
  node_triprepo["Live trip repository<br/>[TripRepository.kt]"]
  node_location["Phone location"]
  node_mapsclient["Maps client"]
  node_geo["Route geometry<br/>[Geo.kt]"]
end

subgraph group_background["Background features"]
  node_worker["Car check worker<br/>[CarCheckWorker.kt]"]
  node_notifications["Alerts and notifications<br/>[Notifications.kt]"]
  node_smartprecool["Smart pre-cool<br/>[SmartPrecool.kt]"]
  node_cooling["Cabin cooling model<br/>[Cooling.kt]"]
  node_spin["Spin home charger<br/>[SpinCharger.kt]"]
end

node_driver(("MG EV owner"))
node_mgservice{{"MG i-SMART"}}
node_googlemaps{{"Google Maps Platform"}}

node_driver -->|"signs in"| node_onboarding
node_driver -->|"checks car"| node_dashboard
node_driver -->|"plans trip"| node_tripui
node_driver -->|"tracks charging"| node_energy
node_onboarding -->|"connects account"| node_ismartrepo
node_onboarding -->|"checks key"| node_mapsclient
node_dashboard -->|"shows status and sends commands"| node_ismartrepo
node_settings -.->|"saves preferences"| node_settingsrepo
node_ismartrepo -->|"uses client"| node_ismartclient
node_ismartclient -->|"reads and commands"| node_mgservice
node_ismartrepo -->|"uses settings"| node_settingsrepo
node_ismartrepo -->|"records readings"| node_socrepo
node_ismartrepo -.->|"logs charge data"| node_database
node_ismartrepo -->|"produces status"| node_vehiclemodel
node_settingsrepo -->|"provides preferences"| node_tripsettings
node_settingsrepo -->|"provides profile"| node_profile
node_tripui -.->|"requests plans"| node_triprepo
node_triprepo -->|"reads car status"| node_ismartrepo
node_triprepo -->|"reads trip settings"| node_settingsrepo
node_triprepo -->|"reads location"| node_location
node_triprepo -->|"replans route"| node_planner
node_triprepo -->|"requests map data"| node_mapsclient
node_planner -->|"plans meal stops"| node_mealplanner
node_mapsclient -->|"requests routes and places"| node_googlemaps
node_mapsclient -->|"uses geometry"| node_geo
node_androidauto -->|"checks after leaving car"| node_worker
node_worker -->|"checks vehicle"| node_ismartrepo
node_worker -.->|"raises alerts"| node_notifications
node_triprepo -->|"alerts on trip changes"| node_notifications
node_smartprecool -.->|"models cooling"| node_cooling
node_dashboard -->|"controls charger"| node_spin
node_driver -->|"reviews suggestion"| node_smartprecool
node_driver -->|"uses in car"| node_androidauto
node_driver -->|"checks widget"| node_widget
node_dashboard -.->|"renders with"| node_design

click node_onboarding "https://github.com/irshadm/volta-android/blob/main/feature/onboarding/src/main/kotlin/dev/irshadm/volta/feature/onboarding/signin/SignInScreen.kt"
click node_dashboard "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/home/HomeScreen.kt"
click node_energy "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/energy/EnergyScreen.kt"
click node_settings "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/settings/SettingsScreen.kt"
click node_androidauto "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/car/VoltaCarAppService.kt"
click node_widget "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/widget/VoltaWidget.kt"
click node_ismartrepo "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt"
click node_ismartclient "https://github.com/irshadm/volta-android/blob/main/core/ismart/src/main/kotlin/dev/irshadm/volta/core/ismart/MgIsmartClient.kt"
click node_settingsrepo "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt"
click node_socrepo "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/SocRepository.kt"
click node_database "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/db/AppDatabase.kt"
click node_vehiclemodel "https://github.com/irshadm/volta-android/blob/main/core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleStatus.kt"
click node_tripsettings "https://github.com/irshadm/volta-android/blob/main/core/model/src/main/kotlin/dev/irshadm/volta/core/model/TripSettings.kt"
click node_profile "https://github.com/irshadm/volta-android/blob/main/core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleProfile.kt"
click node_planner "https://github.com/irshadm/volta-android/blob/main/core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/TripPlanner.kt"
click node_mealplanner "https://github.com/irshadm/volta-android/blob/main/core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/MealPlanner.kt"
click node_triprepo "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt"
click node_location "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/trip/LocationProvider.kt"
click node_mapsclient "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/maps/GoogleMapsClient.kt"
click node_geo "https://github.com/irshadm/volta-android/blob/main/core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/Geo.kt"
click node_tripui "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/plan/PlanScreen.kt"
click node_worker "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt"
click node_notifications "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/Notifications.kt"
click node_smartprecool "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/smart/SmartPrecool.kt"
click node_cooling "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/smart/Cooling.kt"
click node_spin "https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/charger/SpinCharger.kt"
click node_design "https://github.com/irshadm/volta-android/blob/main/core/designsystem/src/main/kotlin/dev/irshadm/volta/core/designsystem/VoltaIcons.kt"

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_onboarding,node_dashboard,node_energy,node_settings,node_androidauto,node_widget,node_tripui,node_design toneBlue
class node_ismartrepo,node_ismartclient,node_settingsrepo,node_socrepo,node_database,node_vehiclemodel,node_tripsettings,node_profile toneAmber
class node_planner,node_mealplanner,node_triprepo,node_location,node_mapsclient,node_geo toneMint
class node_worker,node_notifications,node_smartprecool,node_cooling,node_spin toneRose
class node_driver,node_mgservice,node_googlemaps toneIndigo
```

## Components

### App experience

- [Sign-in and setup](https://github.com/irshadm/volta-android/blob/main/feature/onboarding/src/main/kotlin/dev/irshadm/volta/feature/onboarding/signin/SignInScreen.kt): `feature/onboarding/src/main/kotlin/dev/irshadm/volta/feature/onboarding/signin/SignInScreen.kt`
- [Dashboard and controls](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/home/HomeScreen.kt): `app/src/main/kotlin/dev/irshadm/volta/ui/home/HomeScreen.kt`
- [Energy tracking](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/energy/EnergyScreen.kt): `app/src/main/kotlin/dev/irshadm/volta/ui/energy/EnergyScreen.kt`
- [Settings](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/settings/SettingsScreen.kt): `app/src/main/kotlin/dev/irshadm/volta/ui/settings/SettingsScreen.kt`
- [Android Auto](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/car/VoltaCarAppService.kt): `app/src/main/kotlin/dev/irshadm/volta/car/VoltaCarAppService.kt`
- [Home widget](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/widget/VoltaWidget.kt): `app/src/main/kotlin/dev/irshadm/volta/widget/VoltaWidget.kt`
- [Trip planning UI](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/ui/plan/PlanScreen.kt): `app/src/main/kotlin/dev/irshadm/volta/ui/plan/PlanScreen.kt`
- [Design system](https://github.com/irshadm/volta-android/blob/main/core/designsystem/src/main/kotlin/dev/irshadm/volta/core/designsystem/VoltaIcons.kt): `core/designsystem/src/main/kotlin/dev/irshadm/volta/core/designsystem/VoltaIcons.kt`

### Vehicle and data

- [Vehicle repository](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt): `app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt`
- [MG i-SMART client](https://github.com/irshadm/volta-android/blob/main/core/ismart/src/main/kotlin/dev/irshadm/volta/core/ismart/MgIsmartClient.kt): `core/ismart/src/main/kotlin/dev/irshadm/volta/core/ismart/MgIsmartClient.kt`
- [Settings repository](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt): `app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt`
- [Battery readings](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/SocRepository.kt): `app/src/main/kotlin/dev/irshadm/volta/data/SocRepository.kt`
- [Local database](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/db/AppDatabase.kt): `app/src/main/kotlin/dev/irshadm/volta/data/db/AppDatabase.kt`
- [Vehicle status model](https://github.com/irshadm/volta-android/blob/main/core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleStatus.kt): `core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleStatus.kt`
- [Trip settings model](https://github.com/irshadm/volta-android/blob/main/core/model/src/main/kotlin/dev/irshadm/volta/core/model/TripSettings.kt): `core/model/src/main/kotlin/dev/irshadm/volta/core/model/TripSettings.kt`
- [Vehicle profile model](https://github.com/irshadm/volta-android/blob/main/core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleProfile.kt): `core/model/src/main/kotlin/dev/irshadm/volta/core/model/VehicleProfile.kt`

### Trip planning

- [Route and energy planner](https://github.com/irshadm/volta-android/blob/main/core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/TripPlanner.kt): `core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/TripPlanner.kt`
- [Meal-stop planner](https://github.com/irshadm/volta-android/blob/main/core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/MealPlanner.kt): `core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/MealPlanner.kt`
- [Live trip repository](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt): `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`
- [Phone location](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/trip/LocationProvider.kt): `app/src/main/kotlin/dev/irshadm/volta/data/trip/LocationProvider.kt`
- [Maps client](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/maps/GoogleMapsClient.kt): `app/src/main/kotlin/dev/irshadm/volta/data/maps/GoogleMapsClient.kt`
- [Route geometry](https://github.com/irshadm/volta-android/blob/main/core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/Geo.kt): `core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/Geo.kt`

### Background features

- [Car check worker](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt): `app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt`
- [Alerts and notifications](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/Notifications.kt): `app/src/main/kotlin/dev/irshadm/volta/service/Notifications.kt`
- [Smart pre-cool](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/smart/SmartPrecool.kt): `app/src/main/kotlin/dev/irshadm/volta/service/smart/SmartPrecool.kt`
- [Cabin cooling model](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/service/smart/Cooling.kt): `app/src/main/kotlin/dev/irshadm/volta/service/smart/Cooling.kt`
- [Spin home charger](https://github.com/irshadm/volta-android/blob/main/app/src/main/kotlin/dev/irshadm/volta/data/charger/SpinCharger.kt): `app/src/main/kotlin/dev/irshadm/volta/data/charger/SpinCharger.kt`

### Other components

- **MG EV owner**
- **MG i-SMART**
- **Google Maps Platform**

## Connections

- MG EV owner → Sign-in and setup: signs in (evidence: `README.md`)
- MG EV owner → Dashboard and controls: checks car (evidence: `README.md`)
- MG EV owner → Trip planning UI: plans trip (evidence: `README.md`)
- MG EV owner → Energy tracking: tracks charging (evidence: `README.md`)
- Sign-in and setup → Vehicle repository: connects account (evidence: `README.md`)
- Sign-in and setup → Maps client: checks key (evidence: `README.md`)
- Dashboard and controls → Vehicle repository: shows status and sends commands (evidence: `README.md`)
- Settings → Settings repository: saves preferences
- Vehicle repository → MG i-SMART client: uses client (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt`)
- MG i-SMART client → MG i-SMART: reads and commands (evidence: `README.md`)
- Vehicle repository → Settings repository: uses settings (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt`)
- Vehicle repository → Battery readings: records readings (evidence: `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 (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/ismart/IsmartRepository.kt`)
- Settings repository → Trip settings model: provides preferences (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/SettingsRepository.kt`)
- Settings repository → Vehicle profile model: provides profile (evidence: `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 (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`)
- Live trip repository → Settings repository: reads trip settings (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`)
- Live trip repository → Phone location: reads location (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`)
- Live trip repository → Route and energy planner: replans route (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`)
- Live trip repository → Maps client: requests map data (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`)
- Route and energy planner → Meal-stop planner: plans meal stops (evidence: `core/planner/src/main/kotlin/dev/irshadm/volta/core/planner/MealPlanner.kt`)
- Maps client → Google Maps Platform: requests routes and places (evidence: `README.md`)
- Maps client → Route geometry: uses geometry (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/maps/GoogleMapsClient.kt`)
- Android Auto → Car check worker: checks after leaving car (evidence: `app/src/main/kotlin/dev/irshadm/volta/car/VoltaCarAppService.kt`)
- Car check worker → Vehicle repository: checks vehicle (evidence: `app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt`)
- Car check worker → Alerts and notifications: raises alerts (evidence: `app/src/main/kotlin/dev/irshadm/volta/service/CarCheckWorker.kt`)
- Live trip repository → Alerts and notifications: alerts on trip changes (evidence: `app/src/main/kotlin/dev/irshadm/volta/data/trip/TripRepository.kt`)
- Smart pre-cool → Cabin cooling model: models cooling (evidence: `app/src/main/kotlin/dev/irshadm/volta/service/smart/SmartPrecool.kt`)
- Dashboard and controls → Spin home charger: controls charger (evidence: `README.md`)
- MG EV owner → Smart pre-cool: reviews suggestion (evidence: `README.md`)
- MG EV owner → Android Auto: uses in car (evidence: `README.md`)
- MG EV owner → Home widget: checks widget (evidence: `README.md`)
- Dashboard and controls → Design system: renders with
