# chamikakarunarathna/fashion_store_mobile_application architecture

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

- Interactive diagram: https://gitdiagram.com/chamikakarunarathna/fashion_store_mobile_application
- Repository: https://github.com/chamikakarunarathna/fashion_store_mobile_application

## Overview

CK Mart is a Flutter fashion-commerce app. Its documented user journey starts at login, proceeds to product discovery and details, then cart management and checkout; profile management is another main branch. The tree separates screens, models, services, reusable widgets, and theming. README navigation and feature descriptions support the workflow edges below, but Dart sources were not excerpted, so internal calls, persistence details, and service-to-screen wiring are not asserted.

Main entry points: [`lib/screens/home_screen.dart`](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/home_screen.dart) (Home), [`lib/screens/product_details_screen.dart`](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/product_details_screen.dart) (Product details), [`lib/screens/cart_screen.dart`](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/cart_screen.dart) (Cart), [`lib/screens/shop_screen.dart`](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/shop_screen.dart) (Product browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journey["Shopping journey"]
  node_home["Home<br/>[home_screen.dart]"]
  node_shop["Product browsing<br/>[shop_screen.dart]"]
  node_details["Product details"]
  node_cart["Cart<br/>[cart_screen.dart]"]
  node_checkout["Checkout"]
  node_orders["Orders<br/>[orders_screen.dart]"]
  node_shipping["Shipping address"]
end

subgraph group_account["Account"]
  node_login["Login<br/>[login_screen.dart]"]
  node_profile["Profile"]
  node_register["Registration"]
  node_edit_profile["Edit profile"]
end

subgraph group_data["App data"]
  node_auth_service["Authentication service<br/>[auth_service.dart]"]
  node_user_service["User service<br/>[user_service.dart]"]
  node_product_model["Product model<br/>[product.dart]"]
  node_cart_model["Cart item model<br/>[cart_item.dart]"]
  node_order_model["Order model<br/>[app_order.dart]"]
  node_user_model["User model<br/>[app_user.dart]"]
  node_cart_service["Cart service<br/>[cart_service.dart]"]
  node_order_service["Order service<br/>[order_service.dart]"]
  node_firestore["Firestore service"]
end

subgraph group_presentation["Presentation"]
  node_product_card["Product card<br/>[product_card.dart]"]
  node_cart_badge["Cart badge"]
  node_theme["App theme<br/>[app_theme.dart]"]
end

node_shopper(("Shopper"))

node_shopper -->|"opens app"| node_login
node_login -->|"continues to"| node_home
node_home -->|"browses products"| node_shop
node_home -->|"opens product"| node_details
node_shop -->|"opens product"| node_details
node_details -->|"adds items"| node_cart
node_home -->|"opens cart"| node_cart
node_cart -->|"proceeds to"| node_checkout
node_home -->|"opens profile"| node_profile
node_profile -->|"manages account"| node_edit_profile

click node_login "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/login_screen.dart"
click node_home "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/home_screen.dart"
click node_shop "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/shop_screen.dart"
click node_details "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/product_details_screen.dart"
click node_cart "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/cart_screen.dart"
click node_checkout "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/checkout_screen.dart"
click node_orders "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/orders_screen.dart"
click node_profile "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/profile_screen.dart"
click node_register "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/register_screen.dart"
click node_edit_profile "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/edit_profile_screen.dart"
click node_shipping "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/shipping_address_screen.dart"
click node_auth_service "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/auth_service.dart"
click node_user_service "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/user_service.dart"
click node_product_model "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/product.dart"
click node_cart_model "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/cart_item.dart"
click node_order_model "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/app_order.dart"
click node_user_model "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/app_user.dart"
click node_cart_service "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/cart_service.dart"
click node_order_service "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/order_service.dart"
click node_firestore "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/firestore_service.dart"
click node_product_card "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/widgets/product_card.dart"
click node_cart_badge "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/widgets/cart_badge_icon.dart"
click node_theme "https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/theme/app_theme.dart"

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_home,node_shop,node_details,node_cart,node_checkout,node_orders,node_shipping toneBlue
class node_login,node_profile,node_register,node_edit_profile toneAmber
class node_auth_service,node_user_service,node_product_model,node_cart_model,node_order_model,node_user_model,node_cart_service,node_order_service,node_firestore toneMint
class node_product_card,node_cart_badge,node_theme toneRose
class node_shopper toneIndigo
```

## Components

### Shopping journey

- [Home](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/home_screen.dart): `lib/screens/home_screen.dart`
- [Product browsing](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/shop_screen.dart): `lib/screens/shop_screen.dart`
- [Product details](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/product_details_screen.dart): `lib/screens/product_details_screen.dart`
- [Cart](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/cart_screen.dart): `lib/screens/cart_screen.dart`
- [Checkout](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/checkout_screen.dart): `lib/screens/checkout_screen.dart`
- [Orders](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/orders_screen.dart): `lib/screens/orders_screen.dart`
- [Shipping address](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/shipping_address_screen.dart): `lib/screens/shipping_address_screen.dart`

### Account

- [Login](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/login_screen.dart): `lib/screens/login_screen.dart`
- [Profile](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/profile_screen.dart): `lib/screens/profile_screen.dart`
- [Registration](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/register_screen.dart): `lib/screens/register_screen.dart`
- [Edit profile](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/screens/edit_profile_screen.dart): `lib/screens/edit_profile_screen.dart`

### App data

- [Authentication service](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [User service](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/user_service.dart): `lib/services/user_service.dart`
- [Product model](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/product.dart): `lib/models/product.dart`
- [Cart item model](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/cart_item.dart): `lib/models/cart_item.dart`
- [Order model](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/app_order.dart): `lib/models/app_order.dart`
- [User model](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/models/app_user.dart): `lib/models/app_user.dart`
- [Cart service](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/cart_service.dart): `lib/services/cart_service.dart`
- [Order service](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/order_service.dart): `lib/services/order_service.dart`
- [Firestore service](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/services/firestore_service.dart): `lib/services/firestore_service.dart`

### Presentation

- [Product card](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/widgets/product_card.dart): `lib/widgets/product_card.dart`
- [Cart badge](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/widgets/cart_badge_icon.dart): `lib/widgets/cart_badge_icon.dart`
- [App theme](https://github.com/chamikakarunarathna/fashion_store_mobile_application/blob/master/lib/theme/app_theme.dart): `lib/theme/app_theme.dart`

### Other components

- **Shopper**

## Connections

- Shopper → Login: opens app (evidence: `README.md`)
- Login → Home: continues to (evidence: `README.md`)
- Home → Product browsing: browses products (evidence: `README.md`)
- Home → Product details: opens product (evidence: `README.md`)
- Product browsing → Product details: opens product (evidence: `README.md`)
- Product details → Cart: adds items (evidence: `README.md`)
- Home → Cart: opens cart (evidence: `README.md`)
- Cart → Checkout: proceeds to (evidence: `README.md`)
- Home → Profile: opens profile (evidence: `README.md`)
- Profile → Edit profile: manages account (evidence: `README.md`)
