# sivachanmaargaai/coinquest_v1 architecture

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

- Interactive diagram: https://gitdiagram.com/sivachanmaargaai/coinquest_v1
- Repository: https://github.com/sivachanmaargaai/coinquest_v1

## Overview

CoinQuest is a Flutter app organized around feature-specific presentation, domain, and data layers. The tree indicates a user journey spanning onboarding and age selection, then financial tools and learning/game features, with parent and progress views. The README provides no product detail, and the sampled source contains only the Windows runner, so feature links and server behavior cannot be verified; those feature nodes are shown without speculative connections. Windows startup and Flutter view hosting are supported by the sampled runner source.

Main entry points: [`windows/runner/flutter_window.cpp`](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/flutter_window.cpp) (Flutter host window), [`windows/runner/main.cpp`](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/main.cpp) (Windows startup), [`windows/runner/win32_window.cpp`](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/win32_window.cpp) (Native window), [`lib/app.dart`](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/lib/app.dart) (Flutter application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_winmain["Windows startup<br/>[main.cpp]"]
  node_winwindow["Flutter host window<br/>[flutter_window.cpp]"]
  node_nativewindow["Native window<br/>[win32_window.cpp]"]
  node_app["Flutter application<br/>[app.dart]"]
end

subgraph group_setup["Account setup"]
  node_onboarding["Onboarding"]
  node_age["Age selection"]
  node_auth["Authentication"]
end

subgraph group_finance["Money tools"]
  node_budget["Budget and goals"]
  node_expense["Expenses"]
  node_savings["Savings"]
  node_money["Money overview<br/>[money_page.dart]"]
  node_home["Home dashboard"]
end

subgraph group_learning["Learning and play"]
  node_learn["Financial lessons"]
  node_quiz["Quizzes"]
  node_quests["Quests"]
  node_challenges["Challenges"]
  node_chat["AI chat"]
end

subgraph group_progress["Progress and support"]
  node_profile["Profile and badges"]
  node_leaderboard["Leaderboard"]
  node_report["Monthly reports"]
  node_parent["Parent dashboard"]
  node_plan["Personalized plan"]
end

node_user(("App user"))

node_user -->|"launches"| node_winmain
node_winmain -->|"creates"| node_winwindow
node_winwindow -->|"inherits window"| node_nativewindow
node_winwindow -.->|"hosts Flutter view"| node_app

click node_winmain "https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/main.cpp"
click node_winwindow "https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/flutter_window.cpp"
click node_nativewindow "https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/win32_window.cpp"
click node_app "https://github.com/sivachanmaargaai/coinquest_v1/blob/main/lib/app.dart"
click node_onboarding "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/onboarding"
click node_age "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/age_selection"
click node_auth "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/auth"
click node_budget "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/budget"
click node_expense "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/expense"
click node_savings "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/savings"
click node_money "https://github.com/sivachanmaargaai/coinquest_v1/blob/main/lib/features/money/presentation/pages/money_page.dart"
click node_home "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/home"
click node_learn "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/learn"
click node_quiz "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/quiz"
click node_quests "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/Quests"
click node_challenges "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/challenges"
click node_chat "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/ai_chat"
click node_profile "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/profile"
click node_leaderboard "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/leaderboard"
click node_report "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/monthly_report"
click node_parent "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/parent_dashboard"
click node_plan "https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/personalized_plan"

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_winmain,node_winwindow,node_nativewindow,node_app,node_user toneBlue
class node_onboarding,node_age,node_auth toneAmber
class node_budget,node_expense,node_savings,node_money,node_home toneMint
class node_learn,node_quiz,node_quests,node_challenges,node_chat toneRose
class node_profile,node_leaderboard,node_report,node_parent,node_plan toneIndigo
```

## Components

### App entry

- [Windows startup](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter host window](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Native window](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Flutter application](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/lib/app.dart): `lib/app.dart`

### Account setup

- [Onboarding](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/onboarding): `lib/features/onboarding`
- [Age selection](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/age_selection): `lib/features/age_selection`
- [Authentication](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/auth): `lib/features/auth`

### Money tools

- [Budget and goals](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/budget): `lib/features/budget`
- [Expenses](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/expense): `lib/features/expense`
- [Savings](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/savings): `lib/features/savings`
- [Money overview](https://github.com/sivachanmaargaai/coinquest_v1/blob/main/lib/features/money/presentation/pages/money_page.dart): `lib/features/money/presentation/pages/money_page.dart`
- [Home dashboard](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/home): `lib/features/home`

### Learning and play

- [Financial lessons](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/learn): `lib/features/learn`
- [Quizzes](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/quiz): `lib/features/quiz`
- [Quests](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/Quests): `lib/features/Quests`
- [Challenges](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/challenges): `lib/features/challenges`
- [AI chat](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/ai_chat): `lib/features/ai_chat`

### Progress and support

- [Profile and badges](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/profile): `lib/features/profile`
- [Leaderboard](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/leaderboard): `lib/features/leaderboard`
- [Monthly reports](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/monthly_report): `lib/features/monthly_report`
- [Parent dashboard](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/parent_dashboard): `lib/features/parent_dashboard`
- [Personalized plan](https://github.com/sivachanmaargaai/coinquest_v1/tree/main/lib/features/personalized_plan): `lib/features/personalized_plan`

### Other components

- **App user**

## Connections

- App user → Windows startup: launches (evidence: `windows/runner/main.cpp`)
- Windows startup → Flutter host window: creates (evidence: `windows/runner/main.cpp`)
- Flutter host window → Native window: inherits window
- Flutter host window → Flutter application: hosts Flutter view
