# sachinnandakumar93/racedash architecture

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

- Interactive diagram: https://gitdiagram.com/sachinnandakumar93/racedash
- Repository: https://github.com/sachinnandakumar93/racedash

## Overview

RaceDash is an Android in-car dashboard, trip recorder, and optional launcher. The main drive workflow presents GPS and sensor readings in the dash, records trips in the background, and exposes trip history, fuel cost, and parking location. Separate branches cover the home launcher and map tiles. The README documents several dashboard capabilities whose individual web implementations were not sampled; those are represented at the dashboard asset-directory level. Edges reflect shown source references or README descriptions, not an inspection of unsampled assets.

Main entry points: [`app/src/main/java/com/racedash/app/MainActivity.java`](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/MainActivity.java) (Dashboard host), [`app/src/main/assets/dash`](https://github.com/sachinnandakumar93/racedash/tree/main/app/src/main/assets/dash) (Dash interface), [`app/src/main/java/com/racedash/app/TripService.java`](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripService.java) (Trip recorder), [`app/src/main/java/com/racedash/app/HomeActivity.java`](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/HomeActivity.java) (Home host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dash["Driving dashboard"]
  node_main["Dashboard host<br/>[MainActivity.java]"]
  node_dashui["Dash interface"]
  node_drivefeatures["Drive instruments"]
  node_themes["Themes and settings<br/>[themes.js]"]
end

subgraph group_trips["Trip recording"]
  node_boot["Boot receiver<br/>[BootReceiver.java]"]
  node_service["Trip recorder<br/>[TripService.java]"]
  node_store[("Trip store<br/>[TripStore.java]")]
  node_tripsactivity["Trip screen host<br/>[TripsActivity.java]"]
  node_tripsui["Trip history UI<br/>[trips.html]"]
end

subgraph group_map["Live map"]
  node_tiles["Map tiles<br/>[MainActivity.java]"]
  node_osm["OpenStreetMap"]
end

subgraph group_home["Home launcher"]
  node_homeactivity["Home host<br/>[HomeActivity.java]"]
  node_homeui["Home interface<br/>[home.html]"]
end

subgraph group_platform["Android platform"]
  node_location["GPS location"]
  node_sensors["Device sensors"]
  node_androidapps["Installed apps"]
  node_systemlauncher["System launcher"]
end

node_driver(("Driver"))

node_driver -->|"uses"| node_dashui
node_main -->|"hosts"| node_dashui
node_main -->|"reads GPS"| node_location
node_main -->|"reads sensors"| node_sensors
node_dashui -->|"presents"| node_drivefeatures
node_dashui -->|"offers settings"| node_themes
node_main -->|"fetches and caches"| node_tiles
node_tiles -->|"requests tiles"| node_osm
node_boot -->|"starts"| node_service
node_main -->|"starts"| node_service
node_service -->|"requests updates"| node_location
node_service -->|"records trips"| node_store
node_main -->|"reads trip data"| node_store
node_tripsactivity -->|"hosts"| node_tripsui
node_driver -->|"reviews trips"| node_tripsui
node_homeactivity -->|"hosts"| node_homeui
node_homeactivity -->|"lists and launches"| node_androidapps
node_homeactivity -->|"opens"| node_systemlauncher
node_driver -->|"uses"| node_homeui

click node_main "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/MainActivity.java"
click node_dashui "https://github.com/sachinnandakumar93/racedash/tree/main/app/src/main/assets/dash"
click node_drivefeatures "https://github.com/sachinnandakumar93/racedash/tree/main/app/src/main/assets/dash"
click node_themes "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/assets/dash/themes.js"
click node_tiles "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/MainActivity.java"
click node_boot "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/BootReceiver.java"
click node_service "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripService.java"
click node_store "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripStore.java"
click node_tripsactivity "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripsActivity.java"
click node_tripsui "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/assets/dash/trips.html"
click node_homeactivity "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/HomeActivity.java"
click node_homeui "https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/assets/dash/home.html"

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_main,node_dashui,node_drivefeatures,node_themes toneBlue
class node_boot,node_service,node_store,node_tripsactivity,node_tripsui toneAmber
class node_tiles,node_osm toneMint
class node_homeactivity,node_homeui toneRose
class node_location,node_sensors,node_androidapps,node_systemlauncher,node_driver toneIndigo
```

## Components

### Driving dashboard

- [Dashboard host](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/MainActivity.java): `app/src/main/java/com/racedash/app/MainActivity.java`
- [Dash interface](https://github.com/sachinnandakumar93/racedash/tree/main/app/src/main/assets/dash): `app/src/main/assets/dash`
- [Drive instruments](https://github.com/sachinnandakumar93/racedash/tree/main/app/src/main/assets/dash): `app/src/main/assets/dash`
- [Themes and settings](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/assets/dash/themes.js): `app/src/main/assets/dash/themes.js`

### Trip recording

- [Boot receiver](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/BootReceiver.java): `app/src/main/java/com/racedash/app/BootReceiver.java`
- [Trip recorder](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripService.java): `app/src/main/java/com/racedash/app/TripService.java`
- [Trip store](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripStore.java): `app/src/main/java/com/racedash/app/TripStore.java`
- [Trip screen host](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/TripsActivity.java): `app/src/main/java/com/racedash/app/TripsActivity.java`
- [Trip history UI](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/assets/dash/trips.html): `app/src/main/assets/dash/trips.html`

### Live map

- [Map tiles](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/MainActivity.java): `app/src/main/java/com/racedash/app/MainActivity.java`
- **OpenStreetMap**

### Home launcher

- [Home host](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/java/com/racedash/app/HomeActivity.java): `app/src/main/java/com/racedash/app/HomeActivity.java`
- [Home interface](https://github.com/sachinnandakumar93/racedash/blob/main/app/src/main/assets/dash/home.html): `app/src/main/assets/dash/home.html`

### Android platform

- **GPS location**
- **Device sensors**
- **Installed apps**
- **System launcher**

### Other components

- **Driver**

## Connections

- Driver → Dash interface: uses (evidence: `README.md`)
- Dashboard host → Dash interface: hosts (evidence: `README.md`)
- Dashboard host → GPS location: reads GPS (evidence: `app/src/main/java/com/racedash/app/MainActivity.java`)
- Dashboard host → Device sensors: reads sensors (evidence: `app/src/main/java/com/racedash/app/MainActivity.java`)
- Dash interface → Drive instruments: presents (evidence: `README.md`)
- Dash interface → Themes and settings: offers settings (evidence: `README.md`)
- Dashboard host → Map tiles: fetches and caches (evidence: `app/src/main/java/com/racedash/app/MainActivity.java`)
- Map tiles → OpenStreetMap: requests tiles (evidence: `app/src/main/java/com/racedash/app/MainActivity.java`)
- Boot receiver → Trip recorder: starts (evidence: `app/src/main/java/com/racedash/app/BootReceiver.java`)
- Dashboard host → Trip recorder: starts (evidence: `app/src/main/java/com/racedash/app/MainActivity.java`)
- Trip recorder → GPS location: requests updates (evidence: `app/src/main/java/com/racedash/app/TripService.java`)
- Trip recorder → Trip store: records trips (evidence: `app/src/main/java/com/racedash/app/TripService.java`)
- Dashboard host → Trip store: reads trip data (evidence: `app/src/main/java/com/racedash/app/MainActivity.java`)
- Trip screen host → Trip history UI: hosts (evidence: `README.md`)
- Driver → Trip history UI: reviews trips (evidence: `README.md`)
- Home host → Home interface: hosts (evidence: `app/src/main/java/com/racedash/app/HomeActivity.java`)
- Home host → Installed apps: lists and launches (evidence: `app/src/main/java/com/racedash/app/HomeActivity.java`)
- Home host → System launcher: opens (evidence: `app/src/main/java/com/racedash/app/HomeActivity.java`)
- Driver → Home interface: uses (evidence: `README.md`)
