# shamkumar06/ikwath architecture

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

- Interactive diagram: https://gitdiagram.com/shamkumar06/ikwath
- Repository: https://github.com/shamkumar06/ikwath

## Overview

iKwath is a Flutter dashboard for a pod-based smart decoction maker. The documented user workflow is to monitor ESP32 telemetry and live extraction graphs, inspect the device’s physical state, and control the device during AFI-standardized decoction preparation. The repository tree identifies UI views, models, localization, and a controller, but their Dart implementations were not sampled, so their internal calls and data flow cannot be verified. The sampled Windows files describe the desktop Flutter host, not the decoction workflow.

Main entry points: [`ikwath_app/lib/screens/dashboard_screen.dart`](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/dashboard_screen.dart) (Dashboard Screen), [`ikwath_app/windows/runner/flutter_window.cpp`](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/flutter_window.cpp) (Flutter Window Host), [`ikwath_app/windows/runner/main.cpp`](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/main.cpp) (Windows Entry), [`ikwath_app/windows/runner/win32_window.cpp`](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/win32_window.cpp) (Win32 Window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard UI"]
  node_app["Flutter App Entry<br/>[main.dart]"]
  node_dashboard_screen["Dashboard Screen"]
  node_telemetry_view["Telemetry View"]
  node_chart_view["Extraction Charts<br/>[chart_view.dart]"]
  node_formulation_view["Formulation View"]
  node_logs_view["Cycle Logs<br/>[logs_view.dart]"]
  node_stepper_view["Process Stepper<br/>[stepper_view.dart]"]
  node_alerts["Alerts Sheet<br/>[alerts_sheet.dart]"]
  node_settings["Settings Sheet"]
  node_vessel["Vessel Diagram"]
  node_localization["Localization<br/>[app_strings.dart]"]
end

subgraph group_domain["Device Domain"]
  node_locale_provider["Locale Provider"]
  node_controller["Device Controller"]
  node_telemetry_model["Telemetry Model<br/>[telemetry.dart]"]
  node_cycle_model["Cycle Log Model<br/>[cycle_log.dart]"]
  node_formulation_model["Formulation Model<br/>[formulation.dart]"]
end

subgraph group_platform["Desktop Host"]
  node_windows_entry["Windows Entry<br/>[main.cpp]"]
  node_flutter_host["Flutter Window Host<br/>[flutter_window.cpp]"]
  node_native_window["Win32 Window<br/>[win32_window.cpp]"]
end

node_user(("Operator"))
node_esp32{{"ESP32 Device"}}

node_user -->|"uses"| node_dashboard_screen
node_dashboard_screen -->|"controls and monitors"| node_esp32
node_esp32 -->|"provides telemetry"| node_dashboard_screen
node_windows_entry -->|"creates"| node_flutter_host
node_flutter_host -->|"inherits window"| node_native_window

click node_app "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/main.dart"
click node_dashboard_screen "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/dashboard_screen.dart"
click node_telemetry_view "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/telemetry_view.dart"
click node_chart_view "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/chart_view.dart"
click node_formulation_view "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/formulation_view.dart"
click node_logs_view "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/logs_view.dart"
click node_stepper_view "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/stepper_view.dart"
click node_alerts "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/widgets/alerts_sheet.dart"
click node_settings "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/widgets/settings_sheet.dart"
click node_vessel "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/widgets/vessel_diagram.dart"
click node_localization "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/l10n/app_strings.dart"
click node_locale_provider "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/services/locale_provider.dart"
click node_controller "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/services/ikwath_controller.dart"
click node_telemetry_model "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/models/telemetry.dart"
click node_cycle_model "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/models/cycle_log.dart"
click node_formulation_model "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/models/formulation.dart"
click node_windows_entry "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/main.cpp"
click node_flutter_host "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/flutter_window.cpp"
click node_native_window "https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/win32_window.cpp"

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_app,node_dashboard_screen,node_telemetry_view,node_chart_view,node_formulation_view,node_logs_view,node_stepper_view,node_alerts,node_settings,node_vessel,node_localization toneBlue
class node_locale_provider,node_controller,node_telemetry_model,node_cycle_model,node_formulation_model toneAmber
class node_windows_entry,node_flutter_host,node_native_window toneMint
class node_user,node_esp32 toneIndigo
```

## Components

### Dashboard UI

- [Flutter App Entry](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/main.dart): `ikwath_app/lib/main.dart`
- [Dashboard Screen](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/dashboard_screen.dart): `ikwath_app/lib/screens/dashboard_screen.dart`
- [Telemetry View](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/telemetry_view.dart): `ikwath_app/lib/screens/views/telemetry_view.dart`
- [Extraction Charts](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/chart_view.dart): `ikwath_app/lib/screens/views/chart_view.dart`
- [Formulation View](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/formulation_view.dart): `ikwath_app/lib/screens/views/formulation_view.dart`
- [Cycle Logs](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/logs_view.dart): `ikwath_app/lib/screens/views/logs_view.dart`
- [Process Stepper](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/views/stepper_view.dart): `ikwath_app/lib/screens/views/stepper_view.dart`
- [Alerts Sheet](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/widgets/alerts_sheet.dart): `ikwath_app/lib/screens/widgets/alerts_sheet.dart`
- [Settings Sheet](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/widgets/settings_sheet.dart): `ikwath_app/lib/screens/widgets/settings_sheet.dart`
- [Vessel Diagram](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/screens/widgets/vessel_diagram.dart): `ikwath_app/lib/screens/widgets/vessel_diagram.dart`
- [Localization](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/l10n/app_strings.dart): `ikwath_app/lib/l10n/app_strings.dart`

### Device Domain

- [Locale Provider](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/services/locale_provider.dart): `ikwath_app/lib/services/locale_provider.dart`
- [Device Controller](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/services/ikwath_controller.dart): `ikwath_app/lib/services/ikwath_controller.dart`
- [Telemetry Model](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/models/telemetry.dart): `ikwath_app/lib/models/telemetry.dart`
- [Cycle Log Model](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/models/cycle_log.dart): `ikwath_app/lib/models/cycle_log.dart`
- [Formulation Model](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/lib/models/formulation.dart): `ikwath_app/lib/models/formulation.dart`

### Desktop Host

- [Windows Entry](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/main.cpp): `ikwath_app/windows/runner/main.cpp`
- [Flutter Window Host](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/flutter_window.cpp): `ikwath_app/windows/runner/flutter_window.cpp`
- [Win32 Window](https://github.com/shamkumar06/ikwath/blob/main/ikwath_app/windows/runner/win32_window.cpp): `ikwath_app/windows/runner/win32_window.cpp`

### Other components

- **Operator**
- **ESP32 Device**

## Connections

- Operator → Dashboard Screen: uses (evidence: `README.md`)
- Dashboard Screen → ESP32 Device: controls and monitors (evidence: `README.md`)
- ESP32 Device → Dashboard Screen: provides telemetry (evidence: `README.md`)
- Windows Entry → Flutter Window Host: creates (evidence: `ikwath_app/windows/runner/main.cpp`)
- Flutter Window Host → Win32 Window: inherits window
