# lifonghang/flutter-ui-project architecture

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

- Interactive diagram: https://gitdiagram.com/lifonghang/flutter-ui-project
- Repository: https://github.com/lifonghang/flutter-ui-project

## Overview

This is a Flutter application with onboarding, shopping-oriented screens (home, search, cart, wishlist, settings), and employee-management screens. The tree suggests these are separate product areas, but the generic README and available source excerpts do not establish their navigation, data flow, or persistence. The sampled native code shows Windows and Linux launch paths and Windows plugin registration; those relationships are shown without inferring connections to the unsampled Dart screens.

Main entry points: [`windows/flutter/generated_plugin_registrant.cc`](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/flutter/generated_plugin_registrant.cc) (Windows plugins), [`windows/runner/flutter_window.h`](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/flutter_window.h) (Flutter window), [`windows/runner/main.cpp`](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/main.cpp) (Windows launcher), [`linux/runner/main.cc`](https://github.com/lifonghang/flutter-ui-project/blob/main/linux/runner/main.cc) (Linux launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_onboarding["Onboarding"]
  node_home["Home screen<br/>[home_screen.dart]"]
  node_navigation["Bottom navigation"]
  node_settings["Settings"]
end

subgraph group_shopping["Shopping"]
  node_shopping_home["Product home<br/>[homepage.dart]"]
  node_search["Search<br/>[search_screen.dart]"]
  node_cart["Cart<br/>[cart_screen.dart]"]
  node_wishlist["Wishlist"]
end

subgraph group_workforce["Employee management"]
  node_employees["Employees"]
  node_add_employee["Add employee"]
  node_employee_service["Employee service"]
  node_employee_alt["Employee screens"]
end

subgraph group_platform["Platform runtime"]
  node_app_entry["Dart entry<br/>[main.dart]"]
  node_win_entry["Windows launcher<br/>[main.cpp]"]
  node_flutter_window["Flutter window<br/>[flutter_window.h]"]
  node_win_window["Win32 window<br/>[win32_window.h]"]
  node_linux_entry["Linux launcher<br/>[main.cc]"]
  node_linux_application["Linux application<br/>[my_application.h]"]
  node_win_plugins["Windows plugins"]
  node_firestore["Cloud Firestore plugin"]
  node_firebase_core["Firebase Core plugin"]
end

node_user(("User"))

node_win_entry -->|"creates"| node_flutter_window
node_flutter_window -->|"inherits"| node_win_window
node_linux_entry -->|"creates"| node_linux_application
node_win_plugins -->|"registers"| node_firestore
node_win_plugins -->|"registers"| node_firebase_core

click node_onboarding "https://github.com/lifonghang/flutter-ui-project/tree/main/lib/OnboardScreen"
click node_home "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/home/home_screen.dart"
click node_navigation "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/widgets/bottom_nav_bar.dart"
click node_shopping_home "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/products/homepage.dart"
click node_search "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/search_screen.dart"
click node_cart "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/cart_screen.dart"
click node_wishlist "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/wishlist_screen.dart"
click node_settings "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/setting_screen.dart"
click node_employees "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/employees/employee_screen.dart"
click node_add_employee "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/employees/add_employee_screen.dart"
click node_employee_service "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/employee/employee_service.dart"
click node_employee_alt "https://github.com/lifonghang/flutter-ui-project/tree/main/lib/screens/employee"
click node_app_entry "https://github.com/lifonghang/flutter-ui-project/blob/main/lib/main.dart"
click node_win_entry "https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/main.cpp"
click node_flutter_window "https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/flutter_window.h"
click node_win_window "https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/win32_window.h"
click node_linux_entry "https://github.com/lifonghang/flutter-ui-project/blob/main/linux/runner/main.cc"
click node_linux_application "https://github.com/lifonghang/flutter-ui-project/blob/main/linux/runner/my_application.h"
click node_win_plugins "https://github.com/lifonghang/flutter-ui-project/blob/main/windows/flutter/generated_plugin_registrant.cc"

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_onboarding,node_home,node_navigation,node_settings,node_user toneBlue
class node_shopping_home,node_search,node_cart,node_wishlist toneAmber
class node_employees,node_add_employee,node_employee_service,node_employee_alt toneMint
class node_app_entry,node_win_entry,node_flutter_window,node_win_window,node_linux_entry,node_linux_application,node_win_plugins,node_firestore,node_firebase_core toneRose
```

## Components

### App experience

- [Onboarding](https://github.com/lifonghang/flutter-ui-project/tree/main/lib/OnboardScreen): `lib/OnboardScreen`
- [Home screen](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/home/home_screen.dart): `lib/screens/home/home_screen.dart`
- [Bottom navigation](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/widgets/bottom_nav_bar.dart): `lib/widgets/bottom_nav_bar.dart`
- [Settings](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/setting_screen.dart): `lib/screens/setting_screen.dart`

### Shopping

- [Product home](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/products/homepage.dart): `lib/products/homepage.dart`
- [Search](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/search_screen.dart): `lib/screens/search_screen.dart`
- [Cart](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/cart_screen.dart): `lib/screens/cart_screen.dart`
- [Wishlist](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/wishlist_screen.dart): `lib/screens/wishlist_screen.dart`

### Employee management

- [Employees](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/employees/employee_screen.dart): `lib/screens/employees/employee_screen.dart`
- [Add employee](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/employees/add_employee_screen.dart): `lib/screens/employees/add_employee_screen.dart`
- [Employee service](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/screens/employee/employee_service.dart): `lib/screens/employee/employee_service.dart`
- [Employee screens](https://github.com/lifonghang/flutter-ui-project/tree/main/lib/screens/employee): `lib/screens/employee`

### Platform runtime

- [Dart entry](https://github.com/lifonghang/flutter-ui-project/blob/main/lib/main.dart): `lib/main.dart`
- [Windows launcher](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Flutter window](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/flutter_window.h): `windows/runner/flutter_window.h`
- [Win32 window](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/runner/win32_window.h): `windows/runner/win32_window.h`
- [Linux launcher](https://github.com/lifonghang/flutter-ui-project/blob/main/linux/runner/main.cc): `linux/runner/main.cc`
- [Linux application](https://github.com/lifonghang/flutter-ui-project/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Windows plugins](https://github.com/lifonghang/flutter-ui-project/blob/main/windows/flutter/generated_plugin_registrant.cc): `windows/flutter/generated_plugin_registrant.cc`
- **Cloud Firestore plugin**
- **Firebase Core plugin**

### Other components

- **User**

## Connections

- Windows launcher → Flutter window: creates (evidence: `windows/runner/main.cpp`)
- Flutter window → Win32 window: inherits (evidence: `windows/runner/flutter_window.h`)
- Linux launcher → Linux application: creates (evidence: `linux/runner/main.cc`)
- Windows plugins → Cloud Firestore plugin: registers (evidence: `windows/flutter/generated_plugin_registrant.cc`)
- Windows plugins → Firebase Core plugin: registers (evidence: `windows/flutter/generated_plugin_registrant.cc`)
