# fahadrafan/mileagetracker architecture

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

- Interactive diagram: https://gitdiagram.com/fahadrafan/mileagetracker
- Repository: https://github.com/fahadrafan/mileagetracker

## Overview

Fuel Garage is an offline-first Android app for managing vehicles and recording fuel fills. The main workflow is to choose a vehicle, enter a fill-up, persist it, and review mileage and expense metrics on the dashboard or in history. The README documents vehicle management, dashboard statistics, history, and planned statistics capabilities; the tree also contains settings and backup/restore modules. Source excerpts were not provided, so implementation links are dashed where runtime calls cannot be verified.

Main entry points: [`app/src/main/java/com/example/mileagetracker/navigation/AppNavigation.kt`](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/navigation/AppNavigation.kt) (App Navigation), [`app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardViewModel.kt`](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardViewModel.kt) (Dashboard Metrics), [`app/src/main/java/com/example/mileagetracker/data/repository/FuelRepository.kt`](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/repository/FuelRepository.kt) (Fuel Repository), [`app/src/main/java/com/example/mileagetracker/ui/home/HomeScreen.kt`](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/home/HomeScreen.kt) (Vehicle Home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_flow["App Flow"]
  node_activity["App Activity<br/>[MainActivity.kt]"]
  node_navigation["App Navigation<br/>[AppNavigation.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
end

subgraph group_vehicle_fuel["Vehicle and Fuel"]
  node_home["Vehicle Home<br/>[HomeScreen.kt]"]
  node_vehicle_manage["Vehicle Management<br/>[VehicleDialog.kt]"]
  node_fuel_entry["Fuel Entry<br/>[FuelEntryScreen.kt]"]
  node_fuel_vm["Entry State"]
  node_history["Fuel History<br/>[HistoryScreen.kt]"]
end

subgraph group_analytics["Analytics"]
  node_dashboard["Vehicle Dashboard<br/>[DashboardScreen.kt]"]
  node_dashboard_vm["Dashboard Metrics"]
  node_calculations["Mileage Calculations"]
  node_statistics["Vehicle Statistics"]
end

subgraph group_persistence["Persistence and Preferences"]
  node_fuel_repo["Fuel Repository<br/>[FuelRepository.kt]"]
  node_vehicle_repo["Vehicle Repository"]
  node_fuel_dao["Fuel Data Access<br/>[FuelEntryDao.kt]"]
  node_vehicle_dao["Vehicle Data Access<br/>[VehicleDao.kt]"]
  node_room[("Room Database")]
  node_preferences["User Preferences"]
end

subgraph group_support["Data Management"]
  node_backup["Backup and Restore"]
  node_backup_data["Backup Data Model<br/>[BackupData.kt]"]
end

node_owner(("Vehicle Owner"))

node_owner -.->|"opens app"| node_activity
node_activity -.->|"hosts navigation"| node_navigation
node_navigation -.->|"routes to"| node_home
node_navigation -.->|"routes to"| node_fuel_entry
node_navigation -.->|"routes to"| node_history
node_navigation -.->|"routes to"| node_settings
node_home -.->|"manages vehicles"| node_vehicle_manage
node_home -.->|"shows metrics"| node_dashboard
node_fuel_entry -.->|"submits entry"| node_fuel_vm
node_fuel_vm -.->|"saves fill-up"| node_fuel_repo
node_history -.->|"loads entries"| node_fuel_repo
node_dashboard -.->|"requests metrics"| node_dashboard_vm
node_dashboard_vm -.->|"reads fuel data"| node_fuel_repo
node_dashboard_vm -.->|"calculates mileage"| node_calculations
node_dashboard_vm -.->|"summarizes usage"| node_statistics
node_fuel_repo -.->|"uses data access"| node_fuel_dao
node_vehicle_repo -.->|"uses data access"| node_vehicle_dao
node_fuel_dao -.->|"queries database"| node_room
node_vehicle_dao -.->|"queries database"| node_room
node_vehicle_manage -.->|"manages records"| node_vehicle_repo
node_settings -.->|"updates preferences"| node_preferences
node_backup -.->|"encodes data"| node_backup_data

click node_activity "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/MainActivity.kt"
click node_navigation "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/navigation/AppNavigation.kt"
click node_home "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/home/HomeScreen.kt"
click node_vehicle_manage "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/vehicle/VehicleDialog.kt"
click node_fuel_entry "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryScreen.kt"
click node_fuel_vm "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryViewModel.kt"
click node_history "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/history/HistoryScreen.kt"
click node_dashboard "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardScreen.kt"
click node_dashboard_vm "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardViewModel.kt"
click node_calculations "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/utils/MileageCalculator.kt"
click node_statistics "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/utils/VehicleStatistics.kt"
click node_fuel_repo "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/repository/FuelRepository.kt"
click node_vehicle_repo "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/repository/VehicleRepository.kt"
click node_fuel_dao "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/dao/FuelEntryDao.kt"
click node_vehicle_dao "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/dao/VehicleDao.kt"
click node_room "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/database/FuelGarageDatabase.kt"
click node_preferences "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/preferences/UserPreferencesRepository.kt"
click node_settings "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/settings/SettingsScreen.kt"
click node_backup "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/backup/BackupAndRestoreManager.kt"
click node_backup_data "https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/backup/BackupData.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_activity,node_navigation,node_settings toneBlue
class node_home,node_vehicle_manage,node_fuel_entry,node_fuel_vm,node_history toneAmber
class node_dashboard,node_dashboard_vm,node_calculations,node_statistics toneMint
class node_fuel_repo,node_vehicle_repo,node_fuel_dao,node_vehicle_dao,node_room,node_preferences toneRose
class node_backup,node_backup_data,node_owner toneIndigo
```

## Components

### App Flow

- [App Activity](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/MainActivity.kt): `app/src/main/java/com/example/mileagetracker/MainActivity.kt`
- [App Navigation](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/navigation/AppNavigation.kt): `app/src/main/java/com/example/mileagetracker/navigation/AppNavigation.kt`
- [Settings](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/settings/SettingsScreen.kt): `app/src/main/java/com/example/mileagetracker/ui/settings/SettingsScreen.kt`

### Vehicle and Fuel

- [Vehicle Home](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/home/HomeScreen.kt): `app/src/main/java/com/example/mileagetracker/ui/home/HomeScreen.kt`
- [Vehicle Management](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/vehicle/VehicleDialog.kt): `app/src/main/java/com/example/mileagetracker/ui/vehicle/VehicleDialog.kt`
- [Fuel Entry](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryScreen.kt): `app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryScreen.kt`
- [Entry State](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryViewModel.kt): `app/src/main/java/com/example/mileagetracker/ui/fuel/FuelEntryViewModel.kt`
- [Fuel History](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/history/HistoryScreen.kt): `app/src/main/java/com/example/mileagetracker/ui/history/HistoryScreen.kt`

### Analytics

- [Vehicle Dashboard](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardScreen.kt): `app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardScreen.kt`
- [Dashboard Metrics](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardViewModel.kt): `app/src/main/java/com/example/mileagetracker/ui/dashboard/DashboardViewModel.kt`
- [Mileage Calculations](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/utils/MileageCalculator.kt): `app/src/main/java/com/example/mileagetracker/utils/MileageCalculator.kt`
- [Vehicle Statistics](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/utils/VehicleStatistics.kt): `app/src/main/java/com/example/mileagetracker/utils/VehicleStatistics.kt`

### Persistence and Preferences

- [Fuel Repository](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/repository/FuelRepository.kt): `app/src/main/java/com/example/mileagetracker/data/repository/FuelRepository.kt`
- [Vehicle Repository](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/repository/VehicleRepository.kt): `app/src/main/java/com/example/mileagetracker/data/repository/VehicleRepository.kt`
- [Fuel Data Access](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/dao/FuelEntryDao.kt): `app/src/main/java/com/example/mileagetracker/data/dao/FuelEntryDao.kt`
- [Vehicle Data Access](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/dao/VehicleDao.kt): `app/src/main/java/com/example/mileagetracker/data/dao/VehicleDao.kt`
- [Room Database](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/database/FuelGarageDatabase.kt): `app/src/main/java/com/example/mileagetracker/data/database/FuelGarageDatabase.kt`
- [User Preferences](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/data/preferences/UserPreferencesRepository.kt): `app/src/main/java/com/example/mileagetracker/data/preferences/UserPreferencesRepository.kt`

### Data Management

- [Backup and Restore](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/backup/BackupAndRestoreManager.kt): `app/src/main/java/com/example/mileagetracker/backup/BackupAndRestoreManager.kt`
- [Backup Data Model](https://github.com/fahadrafan/mileagetracker/blob/main/app/src/main/java/com/example/mileagetracker/backup/BackupData.kt): `app/src/main/java/com/example/mileagetracker/backup/BackupData.kt`

### Other components

- **Vehicle Owner**

## Connections

- Vehicle Owner → App Activity: opens app
- App Activity → App Navigation: hosts navigation
- App Navigation → Vehicle Home: routes to
- App Navigation → Fuel Entry: routes to
- App Navigation → Fuel History: routes to
- App Navigation → Settings: routes to
- Vehicle Home → Vehicle Management: manages vehicles
- Vehicle Home → Vehicle Dashboard: shows metrics
- Fuel Entry → Entry State: submits entry
- Entry State → Fuel Repository: saves fill-up
- Fuel History → Fuel Repository: loads entries
- Vehicle Dashboard → Dashboard Metrics: requests metrics
- Dashboard Metrics → Fuel Repository: reads fuel data
- Dashboard Metrics → Mileage Calculations: calculates mileage
- Dashboard Metrics → Vehicle Statistics: summarizes usage
- Fuel Repository → Fuel Data Access: uses data access
- Vehicle Repository → Vehicle Data Access: uses data access
- Fuel Data Access → Room Database: queries database
- Vehicle Data Access → Room Database: queries database
- Vehicle Management → Vehicle Repository: manages records
- Settings → User Preferences: updates preferences
- Backup and Restore → Backup Data Model: encodes data
