# mostafa-yasser-dev/nike_store_app architecture

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

- Interactive diagram: https://gitdiagram.com/mostafa-yasser-dev/nike_store_app
- Repository: https://github.com/mostafa-yasser-dev/nike_store_app

## Overview

This is a Flutter Nike-storefront app, though the README only describes a starter project. The tree indicates a customer journey spanning sign-in, product discovery, product details, cart, checkout/payment, order tracking, and account features, with Cubits, repositories, and data sources as internal layers. The Dart implementation was not excerpted, so these component boundaries come from the file tree and the relationships below are dashed and unverified; the README does not document their wiring.

Main entry points: [`lib/app/router/app_router.dart`](https://github.com/mostafa-yasser-dev/nike_store_app/blob/main/lib/app/router/app_router.dart) (App navigation), [`lib/app/views/screens/home_Screen`](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/home_Screen) (Product discovery), [`lib/app/views/screens/check_Out_Screen`](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/check_Out_Screen) (Checkout and payment), [`lib/app/data/repos`](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/repos) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App bootstrap<br/>[main.dart]"]
  node_router["App navigation<br/>[app_router.dart]"]
end

subgraph group_commerce["Shopping and orders"]
  node_home["Product discovery"]
  node_search["Product search"]
  node_details["Product details"]
  node_favorites["Favorites"]
  node_cart["Shopping cart"]
  node_checkout["Checkout and payment"]
  node_orders["Orders and tracking"]
  node_success["Purchase confirmation"]
end

subgraph group_account["Identity and account"]
  node_auth["Sign-in and registration"]
  node_profile["Profile management"]
  node_location["Location and maps"]
  node_notifications["Notifications"]
end

subgraph group_platform["State and data"]
  node_state["Feature state"]
  node_repositories["Repositories"]
  node_sources["Remote and local sources"]
  node_models["Domain models"]
end

node_customer(("Customer"))
node_firebase[("Firebase services")]
node_paymob["Paymob"]

node_customer -.->|"opens"| node_app
node_app -.->|"starts navigation"| node_router
node_router -.->|"routes to"| node_auth
node_router -.->|"routes to"| node_home
node_home -.->|"offers search"| node_search
node_home -.->|"opens product"| node_details
node_details -.->|"marks favorite"| node_favorites
node_details -.->|"adds item"| node_cart
node_cart -.->|"starts checkout"| node_checkout
node_checkout -.->|"confirms purchase"| node_success
node_checkout -.->|"uses payment"| node_paymob
node_success -.->|"leads to orders"| node_orders
node_router -.->|"routes to"| node_profile
node_checkout -.->|"uses location"| node_location
node_router -.->|"routes to"| node_notifications
node_home -.->|"uses state"| node_state
node_cart -.->|"uses state"| node_state
node_auth -.->|"uses state"| node_state
node_state -.->|"delegates to"| node_repositories
node_repositories -.->|"accesses data"| node_sources
node_repositories -.->|"uses models"| node_models
node_repositories -.->|"may access"| node_firebase

click node_app "https://github.com/mostafa-yasser-dev/nike_store_app/blob/main/lib/main.dart"
click node_router "https://github.com/mostafa-yasser-dev/nike_store_app/blob/main/lib/app/router/app_router.dart"
click node_home "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/home_Screen"
click node_search "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/search_Screen"
click node_details "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/details_Screen"
click node_favorites "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/favorite_Screen"
click node_cart "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/my_cart_Screen"
click node_checkout "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/check_Out_Screen"
click node_orders "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/orders_screen"
click node_success "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/success_screen"
click node_auth "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/auth"
click node_profile "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/profile_Screen"
click node_location "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/map_Screen"
click node_notifications "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/notifications_Screen"
click node_state "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/manager"
click node_repositories "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/repos"
click node_sources "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/data_source"
click node_models "https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/models"

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_router toneBlue
class node_home,node_search,node_details,node_favorites,node_cart,node_checkout,node_orders,node_success,node_firebase toneAmber
class node_auth,node_profile,node_location,node_notifications toneMint
class node_state,node_repositories,node_sources,node_models toneRose
class node_customer,node_paymob toneIndigo
```

## Components

### App experience

- [App bootstrap](https://github.com/mostafa-yasser-dev/nike_store_app/blob/main/lib/main.dart): `lib/main.dart`
- [App navigation](https://github.com/mostafa-yasser-dev/nike_store_app/blob/main/lib/app/router/app_router.dart): `lib/app/router/app_router.dart`

### Shopping and orders

- [Product discovery](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/home_Screen): `lib/app/views/screens/home_Screen`
- [Product search](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/search_Screen): `lib/app/views/screens/search_Screen`
- [Product details](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/details_Screen): `lib/app/views/screens/details_Screen`
- [Favorites](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/favorite_Screen): `lib/app/views/screens/favorite_Screen`
- [Shopping cart](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/my_cart_Screen): `lib/app/views/screens/my_cart_Screen`
- [Checkout and payment](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/check_Out_Screen): `lib/app/views/screens/check_Out_Screen`
- [Orders and tracking](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/orders_screen): `lib/app/views/screens/orders_screen`
- [Purchase confirmation](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/success_screen): `lib/app/views/screens/success_screen`

### Identity and account

- [Sign-in and registration](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/auth): `lib/app/views/screens/auth`
- [Profile management](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/profile_Screen): `lib/app/views/screens/profile_Screen`
- [Location and maps](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/map_Screen): `lib/app/views/screens/map_Screen`
- [Notifications](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/views/screens/notifications_Screen): `lib/app/views/screens/notifications_Screen`

### State and data

- [Feature state](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/manager): `lib/app/data/manager`
- [Repositories](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/repos): `lib/app/data/repos`
- [Remote and local sources](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/data_source): `lib/app/data/data_source`
- [Domain models](https://github.com/mostafa-yasser-dev/nike_store_app/tree/main/lib/app/data/models): `lib/app/data/models`

### Other components

- **Customer**
- **Firebase services**
- **Paymob**

## Connections

- Customer → App bootstrap: opens
- App bootstrap → App navigation: starts navigation
- App navigation → Sign-in and registration: routes to
- App navigation → Product discovery: routes to
- Product discovery → Product search: offers search
- Product discovery → Product details: opens product
- Product details → Favorites: marks favorite
- Product details → Shopping cart: adds item
- Shopping cart → Checkout and payment: starts checkout
- Checkout and payment → Purchase confirmation: confirms purchase
- Checkout and payment → Paymob: uses payment
- Purchase confirmation → Orders and tracking: leads to orders
- App navigation → Profile management: routes to
- Checkout and payment → Location and maps: uses location
- App navigation → Notifications: routes to
- Product discovery → Feature state: uses state
- Shopping cart → Feature state: uses state
- Sign-in and registration → Feature state: uses state
- Feature state → Repositories: delegates to
- Repositories → Remote and local sources: accesses data
- Repositories → Domain models: uses models
- Repositories → Firebase services: may access
