# jjaze20/guidegrade architecture

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

- Interactive diagram: https://gitdiagram.com/jjaze20/guidegrade
- Repository: https://github.com/jjaze20/guidegrade

## Overview

GuideGrade is a Flutter application with native launch shells for several desktop and mobile platforms, plus a Firebase Cloud Function that synchronizes Firebase Auth claims from Firestore user records. The tree does not include the Flutter/Dart application sources or a README, so the app’s user-facing feature workflow cannot be established here. The graph focuses on the visible platform shells and the documented claims-sync workflow; generated plugin registrations indicate platform integrations but not their use in app features.

Main entry points: [`functions/claims.js`](https://github.com/jjaze20/guidegrade/blob/main/functions/claims.js) (Claim synchronizer), [`windows/runner/main.cpp`](https://github.com/jjaze20/guidegrade/blob/main/windows/runner/main.cpp) (Windows entry), [`windows/runner/flutter_window.cpp`](https://github.com/jjaze20/guidegrade/blob/main/windows/runner/flutter_window.cpp) (Windows Flutter view), [`functions/index.js`](https://github.com/jjaze20/guidegrade/blob/main/functions/index.js) (User-write trigger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Platform shells"]
  node_windows_entry["Windows entry<br/>[main.cpp]"]
  node_windows_view["Windows Flutter view<br/>[flutter_window.cpp]"]
  node_windows_window["Win32 window<br/>[win32_window.cpp]"]
  node_windows_plugins["Windows plugins"]
  node_linux_entry["Linux entry<br/>[main.cc]"]
  node_linux_app["Linux application<br/>[my_application.cc]"]
  node_linux_plugins["Linux plugins"]
  node_macos_plugins["macOS plugins"]
  node_android_entry["Android entry<br/>[MainActivity.kt]"]
  node_ios_entry["iOS entry<br/>[AppDelegate.swift]"]
end

subgraph group_cloud["Claims synchronization"]
  node_trigger["User-write trigger<br/>[index.js]"]
  node_claim_logic["Claim synchronizer<br/>[claims.js]"]
end

node_user(("App user"))
node_firestore[("Firestore users")]
node_firebase_auth["Firebase Auth"]

node_user -.->|"launches"| node_windows_entry
node_windows_entry -->|"creates"| node_windows_view
node_windows_view -->|"extends"| node_windows_window
node_linux_entry -->|"runs"| node_linux_app
node_firestore -->|"emits writes"| node_trigger
node_trigger -->|"invokes"| node_claim_logic
node_claim_logic -->|"reads current user"| node_firestore
node_claim_logic -->|"reads and updates claims"| node_firebase_auth

click node_windows_entry "https://github.com/jjaze20/guidegrade/blob/main/windows/runner/main.cpp"
click node_windows_view "https://github.com/jjaze20/guidegrade/blob/main/windows/runner/flutter_window.cpp"
click node_windows_window "https://github.com/jjaze20/guidegrade/blob/main/windows/runner/win32_window.cpp"
click node_windows_plugins "https://github.com/jjaze20/guidegrade/blob/main/windows/flutter/generated_plugin_registrant.cc"
click node_linux_entry "https://github.com/jjaze20/guidegrade/blob/main/linux/runner/main.cc"
click node_linux_app "https://github.com/jjaze20/guidegrade/blob/main/linux/runner/my_application.cc"
click node_linux_plugins "https://github.com/jjaze20/guidegrade/blob/main/linux/flutter/generated_plugin_registrant.cc"
click node_macos_plugins "https://github.com/jjaze20/guidegrade/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"
click node_android_entry "https://github.com/jjaze20/guidegrade/blob/main/android/app/src/main/kotlin/com/team/guidegrade/MainActivity.kt"
click node_ios_entry "https://github.com/jjaze20/guidegrade/blob/main/ios/Runner/AppDelegate.swift"
click node_trigger "https://github.com/jjaze20/guidegrade/blob/main/functions/index.js"
click node_claim_logic "https://github.com/jjaze20/guidegrade/blob/main/functions/claims.js"

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_windows_entry,node_windows_view,node_windows_window,node_windows_plugins,node_linux_entry,node_linux_app,node_linux_plugins,node_macos_plugins,node_android_entry,node_ios_entry,node_user toneBlue
class node_trigger,node_claim_logic,node_firestore toneAmber
class node_firebase_auth toneIndigo
```

## Components

### Platform shells

- [Windows entry](https://github.com/jjaze20/guidegrade/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Windows Flutter view](https://github.com/jjaze20/guidegrade/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Win32 window](https://github.com/jjaze20/guidegrade/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Windows plugins](https://github.com/jjaze20/guidegrade/blob/main/windows/flutter/generated_plugin_registrant.cc): `windows/flutter/generated_plugin_registrant.cc`
- [Linux entry](https://github.com/jjaze20/guidegrade/blob/main/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux application](https://github.com/jjaze20/guidegrade/blob/main/linux/runner/my_application.cc): `linux/runner/my_application.cc`
- [Linux plugins](https://github.com/jjaze20/guidegrade/blob/main/linux/flutter/generated_plugin_registrant.cc): `linux/flutter/generated_plugin_registrant.cc`
- [macOS plugins](https://github.com/jjaze20/guidegrade/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`
- [Android entry](https://github.com/jjaze20/guidegrade/blob/main/android/app/src/main/kotlin/com/team/guidegrade/MainActivity.kt): `android/app/src/main/kotlin/com/team/guidegrade/MainActivity.kt`
- [iOS entry](https://github.com/jjaze20/guidegrade/blob/main/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`

### Claims synchronization

- [User-write trigger](https://github.com/jjaze20/guidegrade/blob/main/functions/index.js): `functions/index.js`
- [Claim synchronizer](https://github.com/jjaze20/guidegrade/blob/main/functions/claims.js): `functions/claims.js`

### Other components

- **App user**
- **Firestore users**
- **Firebase Auth**

## Connections

- App user → Windows entry: launches
- Windows entry → Windows Flutter view: creates (evidence: `windows/runner/main.cpp`)
- Windows Flutter view → Win32 window: extends
- Linux entry → Linux application: runs (evidence: `linux/runner/main.cc`)
- Firestore users → User-write trigger: emits writes (evidence: `functions/index.js`)
- User-write trigger → Claim synchronizer: invokes (evidence: `functions/index.js`)
- Claim synchronizer → Firestore users: reads current user (evidence: `functions/claims.js`)
- Claim synchronizer → Firebase Auth: reads and updates claims (evidence: `functions/claims.js`)
