# balajiece2023/smart-bike-monitor architecture

> Architecture diagram of the GitHub repository balajiece2023/smart-bike-monitor, 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/balajiece2023/smart-bike-monitor
- Repository: https://github.com/balajiece2023/smart-bike-monitor

## Overview

Smart Bike Monitor is a Flutter app for live two-wheeler telemetry, safety controls, rider management, and emergency response. The main workflow runs from the rider/admin through the dashboard and BikeController, into the repository and Bluetooth services, then to bike firmware; incoming telemetry supports accident alerts and related actions. The README also describes geofencing, licensing, settings, and a hardware simulator. Runtime details for most Dart modules were not sampled, so feature links and subsystem relationships below rely on the README’s architecture and capability descriptions.

Main entry points: [`lib/ui/features/bike/view_models/bike_controller.dart`](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/view_models/bike_controller.dart) (Bike controller), [`lib/data/services/ble_service.dart`](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/ble_service.dart) (BLE service), [`lib/data/services/reactive_ble_service.dart`](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/reactive_ble_service.dart) (Reactive BLE), [`lib/ui/features/bike/views/scenario_views.dart`](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart) (Accident response)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_dashboard["Live dashboard"]
  node_pairing["Device pairing"]
  node_scenario["Scenario views"]
  node_geofence["Geofencing"]
  node_users["Rider management"]
  node_renewal["Bike renewal"]
  node_settings["App settings"]
end

subgraph group_state["State and domain"]
  node_controller["Bike controller"]
  node_bike_data["Bike models<br/>[bike_models.dart]"]
  node_repository["Bike repository"]
end

subgraph group_connectivity["Bike connectivity"]
  node_ble_service["BLE service<br/>[ble_service.dart]"]
  node_reactive_ble["Reactive BLE"]
  node_classic_bt["Classic Bluetooth"]
  node_protocol["Packet protocol<br/>[ble_protocol.dart]"]
  node_android_bridge["Android Bluetooth bridge<br/>[MainActivity.kt]"]
  node_firmware["ESP32 bike firmware"]
  node_simulator["Communication simulator<br/>[simulator.html]"]
end

subgraph group_safety["Safety and administration"]
  node_emergency["Accident response"]
  node_map["Nearby hospitals"]
  node_alert_audio["Emergency siren<br/>[alert.wav]"]
end

node_rider(("Rider or admin"))

node_rider -->|"views telemetry"| node_dashboard
node_rider -->|"pairs device"| node_pairing
node_rider -->|"sets restrictions"| node_geofence
node_rider -->|"manages riders"| node_users
node_rider -->|"views renewal"| node_renewal
node_rider -->|"changes settings"| node_settings
node_dashboard -->|"uses state"| node_controller
node_pairing -->|"connects through"| node_controller
node_geofence -->|"uses state"| node_controller
node_users -->|"uses state"| node_controller
node_renewal -.->|"uses state"| node_controller
node_settings -.->|"uses state"| node_controller
node_controller -->|"delegates data"| node_repository
node_repository -->|"uses service"| node_ble_service
node_controller -.->|"holds telemetry"| node_bike_data
node_ble_service -->|"supports BLE"| node_reactive_ble
node_ble_service -->|"supports SPP"| node_classic_bt
node_reactive_ble -->|"bridges Android"| node_android_bridge
node_reactive_ble -->|"frames packets"| node_protocol
node_classic_bt -->|"uses native SPP"| node_android_bridge
node_firmware -->|"exchanges telemetry"| node_ble_service
node_simulator -.->|"simulates hardware"| node_ble_service
node_controller -.->|"triggers alert"| node_emergency
node_emergency -->|"finds nearby care"| node_map
node_emergency -->|"plays siren"| node_alert_audio

click node_dashboard "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/bike_dashboard_screen.dart"
click node_pairing "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/device_pairing_screen.dart"
click node_scenario "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart"
click node_geofence "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/geofencing_screen.dart"
click node_users "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/user_management_screen.dart"
click node_renewal "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/bike_renewal_screen.dart"
click node_settings "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/settings_screen.dart"
click node_controller "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/view_models/bike_controller.dart"
click node_bike_data "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/domain/models/bike_models.dart"
click node_repository "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/repositories/bike_repository_impl.dart"
click node_ble_service "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/ble_service.dart"
click node_reactive_ble "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/reactive_ble_service.dart"
click node_classic_bt "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/classic_bluetooth_service.dart"
click node_protocol "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/ble_protocol.dart"
click node_android_bridge "https://github.com/balajiece2023/smart-bike-monitor/blob/main/android/app/src/main/kotlin/com/example/smart_bike_app/MainActivity.kt"
click node_firmware "https://github.com/balajiece2023/smart-bike-monitor/blob/main/firmware/esp32_smart_bike.ino"
click node_simulator "https://github.com/balajiece2023/smart-bike-monitor/blob/main/simulator.html"
click node_emergency "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart"
click node_map "https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart"
click node_alert_audio "https://github.com/balajiece2023/smart-bike-monitor/blob/main/assets/audio/alert.wav"

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_dashboard,node_pairing,node_scenario,node_geofence,node_users,node_renewal,node_settings toneBlue
class node_controller,node_bike_data,node_repository toneAmber
class node_ble_service,node_reactive_ble,node_classic_bt,node_protocol,node_android_bridge,node_firmware,node_simulator toneMint
class node_emergency,node_map,node_alert_audio toneRose
class node_rider toneIndigo
```

## Components

### App experience

- [Live dashboard](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/bike_dashboard_screen.dart): `lib/ui/features/bike/views/bike_dashboard_screen.dart`
- [Device pairing](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/device_pairing_screen.dart): `lib/ui/features/bike/views/device_pairing_screen.dart`
- [Scenario views](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart): `lib/ui/features/bike/views/scenario_views.dart`
- [Geofencing](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/geofencing_screen.dart): `lib/ui/features/bike/views/geofencing_screen.dart`
- [Rider management](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/user_management_screen.dart): `lib/ui/features/bike/views/user_management_screen.dart`
- [Bike renewal](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/bike_renewal_screen.dart): `lib/ui/features/bike/views/bike_renewal_screen.dart`
- [App settings](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/settings_screen.dart): `lib/ui/features/bike/views/settings_screen.dart`

### State and domain

- [Bike controller](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/view_models/bike_controller.dart): `lib/ui/features/bike/view_models/bike_controller.dart`
- [Bike models](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/domain/models/bike_models.dart): `lib/domain/models/bike_models.dart`
- [Bike repository](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/repositories/bike_repository_impl.dart): `lib/data/repositories/bike_repository_impl.dart`

### Bike connectivity

- [BLE service](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/ble_service.dart): `lib/data/services/ble_service.dart`
- [Reactive BLE](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/reactive_ble_service.dart): `lib/data/services/reactive_ble_service.dart`
- [Classic Bluetooth](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/classic_bluetooth_service.dart): `lib/data/services/classic_bluetooth_service.dart`
- [Packet protocol](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/data/services/ble_protocol.dart): `lib/data/services/ble_protocol.dart`
- [Android Bluetooth bridge](https://github.com/balajiece2023/smart-bike-monitor/blob/main/android/app/src/main/kotlin/com/example/smart_bike_app/MainActivity.kt): `android/app/src/main/kotlin/com/example/smart_bike_app/MainActivity.kt`
- [ESP32 bike firmware](https://github.com/balajiece2023/smart-bike-monitor/blob/main/firmware/esp32_smart_bike.ino): `firmware/esp32_smart_bike.ino`
- [Communication simulator](https://github.com/balajiece2023/smart-bike-monitor/blob/main/simulator.html): `simulator.html`

### Safety and administration

- [Accident response](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart): `lib/ui/features/bike/views/scenario_views.dart`
- [Nearby hospitals](https://github.com/balajiece2023/smart-bike-monitor/blob/main/lib/ui/features/bike/views/scenario_views.dart): `lib/ui/features/bike/views/scenario_views.dart`
- [Emergency siren](https://github.com/balajiece2023/smart-bike-monitor/blob/main/assets/audio/alert.wav): `assets/audio/alert.wav`

### Other components

- **Rider or admin**

## Connections

- Rider or admin → Live dashboard: views telemetry (evidence: `README.md`)
- Rider or admin → Device pairing: pairs device (evidence: `README.md`)
- Rider or admin → Geofencing: sets restrictions (evidence: `README.md`)
- Rider or admin → Rider management: manages riders (evidence: `README.md`)
- Rider or admin → Bike renewal: views renewal (evidence: `README.md`)
- Rider or admin → App settings: changes settings (evidence: `README.md`)
- Live dashboard → Bike controller: uses state (evidence: `README.md`)
- Device pairing → Bike controller: connects through (evidence: `README.md`)
- Geofencing → Bike controller: uses state (evidence: `README.md`)
- Rider management → Bike controller: uses state (evidence: `README.md`)
- Bike renewal → Bike controller: uses state
- App settings → Bike controller: uses state
- Bike controller → Bike repository: delegates data (evidence: `README.md`)
- Bike repository → BLE service: uses service (evidence: `README.md`)
- Bike controller → Bike models: holds telemetry
- BLE service → Reactive BLE: supports BLE (evidence: `README.md`)
- BLE service → Classic Bluetooth: supports SPP (evidence: `README.md`)
- Reactive BLE → Android Bluetooth bridge: bridges Android (evidence: `README.md`)
- Reactive BLE → Packet protocol: frames packets (evidence: `README.md`)
- Classic Bluetooth → Android Bluetooth bridge: uses native SPP (evidence: `README.md`)
- ESP32 bike firmware → BLE service: exchanges telemetry (evidence: `README.md`)
- Communication simulator → BLE service: simulates hardware
- Bike controller → Accident response: triggers alert
- Accident response → Nearby hospitals: finds nearby care (evidence: `README.md`)
- Accident response → Emergency siren: plays siren (evidence: `README.md`)
