# joshcarlouycaro/cudiamat architecture

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

- Interactive diagram: https://gitdiagram.com/joshcarlouycaro/cudiamat
- Repository: https://github.com/joshcarlouycaro/cudiamat

## Overview

This is a Flutter application whose documented description is only a project starter; the README does not specify its domain or user workflow. The tree indicates a dashboard, registration and summary screens, reusable dashboard/KPI/profile widgets, and an API service, but their runtime connections and behavior were not sampled. Native desktop runner relationships shown below are limited to references in the supplied source index and excerpts; no storage or external API behavior is inferred.

Main entry points: [`windows/runner/main.cpp`](https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/main.cpp) (Windows launcher), [`windows/runner/flutter_window.h`](https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/flutter_window.h) (Flutter window), [`linux/runner/main.cc`](https://github.com/joshcarlouycaro/cudiamat/blob/main/linux/runner/main.cc) (Linux launcher), [`linux/runner/my_application.h`](https://github.com/joshcarlouycaro/cudiamat/blob/main/linux/runner/my_application.h) (Linux application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter app"]
  node_entry["App entry<br/>[main.dart]"]
  node_api["API service<br/>[api_service.dart]"]
end

subgraph group_screens["User screens"]
  node_registration["Registration"]
  node_dashboard["Dashboard"]
  node_summary["Summary"]
end

subgraph group_widgets["UI components"]
  node_tile["Dashboard tile"]
  node_kpi["KPI card<br/>[kpi_card.dart]"]
  node_profile["Profile card<br/>[profile_card.dart]"]
end

subgraph group_native["Native runners"]
  node_linuxmain["Linux launcher<br/>[main.cc]"]
  node_linuxapp["Linux application<br/>[my_application.h]"]
  node_winmain["Windows launcher<br/>[main.cpp]"]
  node_winflutter["Flutter window<br/>[flutter_window.h]"]
  node_winwindow["Window host<br/>[win32_window.cpp]"]
end

node_user(("User"))

node_linuxmain -->|"creates app"| node_linuxapp
node_winmain -->|"creates window"| node_winflutter
node_winmain -->|"reads arguments"| node_winmain
node_winflutter -->|"inherits window"| node_winwindow

click node_entry "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/main.dart"
click node_api "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/services/api_service.dart"
click node_registration "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/screens/registration_screen.dart"
click node_dashboard "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/screens/dashboard_screen.dart"
click node_summary "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/screens/summary_screen.dart"
click node_tile "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/widgets/dashboard_tile.dart"
click node_kpi "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/widgets/kpi_card.dart"
click node_profile "https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/widgets/profile_card.dart"
click node_linuxmain "https://github.com/joshcarlouycaro/cudiamat/blob/main/linux/runner/main.cc"
click node_linuxapp "https://github.com/joshcarlouycaro/cudiamat/blob/main/linux/runner/my_application.h"
click node_winmain "https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/main.cpp"
click node_winflutter "https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/flutter_window.h"
click node_winwindow "https://github.com/joshcarlouycaro/cudiamat/blob/main/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_entry,node_api,node_user toneBlue
class node_registration,node_dashboard,node_summary toneAmber
class node_tile,node_kpi,node_profile toneMint
class node_linuxmain,node_linuxapp,node_winmain,node_winflutter,node_winwindow toneRose
```

## Components

### Flutter app

- [App entry](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/main.dart): `lib/main.dart`
- [API service](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/services/api_service.dart): `lib/services/api_service.dart`

### User screens

- [Registration](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/screens/registration_screen.dart): `lib/screens/registration_screen.dart`
- [Dashboard](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/screens/dashboard_screen.dart): `lib/screens/dashboard_screen.dart`
- [Summary](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/screens/summary_screen.dart): `lib/screens/summary_screen.dart`

### UI components

- [Dashboard tile](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/widgets/dashboard_tile.dart): `lib/widgets/dashboard_tile.dart`
- [KPI card](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/widgets/kpi_card.dart): `lib/widgets/kpi_card.dart`
- [Profile card](https://github.com/joshcarlouycaro/cudiamat/blob/main/lib/widgets/profile_card.dart): `lib/widgets/profile_card.dart`

### Native runners

- [Linux launcher](https://github.com/joshcarlouycaro/cudiamat/blob/main/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux application](https://github.com/joshcarlouycaro/cudiamat/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Windows launcher](https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window](https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Window host](https://github.com/joshcarlouycaro/cudiamat/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`

### Other components

- **User**

## Connections

- Linux launcher → Linux application: creates app (evidence: `linux/runner/main.cc`)
- Windows launcher → Flutter window: creates window (evidence: `windows/runner/main.cpp`)
- Windows launcher → Windows launcher: reads arguments (evidence: `windows/runner/main.cpp`)
- Flutter window → Window host: inherits window (evidence: `windows/runner/flutter_window.h`)