# darsika4478/pikzen-mobile-app architecture

> Architecture diagram of the GitHub repository darsika4478/pikzen-mobile-app, 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/darsika4478/pikzen-mobile-app
- Repository: https://github.com/darsika4478/pikzen-mobile-app

## Overview

Pikzen appears to be a Flutter shopping app with customer and shop-management features. The likely customer journey spans account access, product discovery, cart and pickup checkout, then order/payment tracking; shop tools cover inventory and order preparation. The tree also shows profile, notifications, and shared service/model layers. Dart implementation files were not excerpted and the README is generic, so feature relationships below are tentative (dashed, without evidence); platform runner scaffolding is omitted.

Main entry points: [`lib/app.dart`](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/app.dart) (App Shell), [`lib/features/payments_tracking/providers/order_tracking_provider.dart`](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/payments_tracking/providers/order_tracking_provider.dart) (Orders & Tracking), [`lib/features/product_discovery/providers/product_provider.dart`](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/product_discovery/providers/product_provider.dart) (Product Discovery), [`lib/features/cart_checkout/screens/checkout_screen.dart`](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/cart_checkout/screens/checkout_screen.dart) (Checkout & Pickup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_entry["App Entry<br/>[main.dart]"]
  node_app_shell["App Shell<br/>[app.dart]"]
end

subgraph group_customer["Customer Shopping"]
  node_auth["Authentication<br/>[login_screen.dart]"]
  node_discovery["Product Discovery"]
  node_cart["Cart<br/>[cart_provider.dart]"]
  node_checkout["Checkout &amp; Pickup"]
  node_orders["Orders &amp; Tracking"]
  node_notifications["Notifications"]
  node_profile["Profile"]
end

subgraph group_shop["Shop Operations"]
  node_shop_dashboard["Shop Dashboard"]
  node_inventory["Inventory"]
  node_incoming_orders["Incoming Orders"]
  node_order_prep["Order Preparation"]
end

subgraph group_foundation["Shared Foundation"]
  node_auth_service["Auth Service<br/>[auth_service.dart]"]
  node_firestore["Firestore Service"]
  node_storage["Storage Service"]
  node_notification_service["Notification Service"]
  node_models["Domain Models<br/>[order_model.dart]"]
end

node_user(("Customer / Shop"))

node_user -.->|"launches"| node_entry
node_entry -.->|"starts"| node_app_shell
node_app_shell -.->|"routes to"| node_auth
node_app_shell -.->|"routes to"| node_discovery
node_discovery -.->|"adds products"| node_cart
node_cart -.->|"proceeds to"| node_checkout
node_checkout -.->|"places order"| node_orders
node_orders -.->|"notifies"| node_notifications
node_app_shell -.->|"routes to"| node_profile
node_app_shell -.->|"routes to"| node_shop_dashboard
node_shop_dashboard -.->|"manages"| node_inventory
node_shop_dashboard -.->|"views"| node_incoming_orders
node_incoming_orders -.->|"prepares"| node_order_prep
node_auth -.->|"uses"| node_auth_service
node_discovery -.->|"loads data"| node_firestore
node_checkout -.->|"stores order"| node_firestore
node_orders -.->|"loads orders"| node_firestore
node_notifications -.->|"uses"| node_notification_service
node_orders -.->|"uses"| node_models

click node_entry "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/main.dart"
click node_app_shell "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/app.dart"
click node_auth "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/auth/screens/login_screen.dart"
click node_discovery "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/product_discovery/providers/product_provider.dart"
click node_cart "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/cart_checkout/providers/cart_provider.dart"
click node_checkout "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/cart_checkout/screens/checkout_screen.dart"
click node_orders "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/payments_tracking/providers/order_tracking_provider.dart"
click node_notifications "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/payments_tracking/screens/notifications_screen.dart"
click node_profile "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/profile/providers/profile_provider.dart"
click node_shop_dashboard "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/shop_dashboard_screen.dart"
click node_inventory "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/inventory_screen.dart"
click node_incoming_orders "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/incoming_orders_screen.dart"
click node_order_prep "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/prepare_order_screen.dart"
click node_auth_service "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/auth_service.dart"
click node_firestore "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/firestore_service.dart"
click node_storage "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/storage_service.dart"
click node_notification_service "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/notification_service.dart"
click node_models "https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/models/order_model.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_entry,node_app_shell toneBlue
class node_auth,node_discovery,node_cart,node_checkout,node_orders,node_notifications,node_profile toneAmber
class node_shop_dashboard,node_inventory,node_incoming_orders,node_order_prep toneMint
class node_auth_service,node_firestore,node_storage,node_notification_service,node_models toneRose
class node_user toneIndigo
```

## Components

### App Shell

- [App Entry](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/main.dart): `lib/main.dart`
- [App Shell](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/app.dart): `lib/app.dart`

### Customer Shopping

- [Authentication](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/auth/screens/login_screen.dart): `lib/features/auth/screens/login_screen.dart`
- [Product Discovery](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/product_discovery/providers/product_provider.dart): `lib/features/product_discovery/providers/product_provider.dart`
- [Cart](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/cart_checkout/providers/cart_provider.dart): `lib/features/cart_checkout/providers/cart_provider.dart`
- [Checkout & Pickup](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/cart_checkout/screens/checkout_screen.dart): `lib/features/cart_checkout/screens/checkout_screen.dart`
- [Orders & Tracking](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/payments_tracking/providers/order_tracking_provider.dart): `lib/features/payments_tracking/providers/order_tracking_provider.dart`
- [Notifications](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/payments_tracking/screens/notifications_screen.dart): `lib/features/payments_tracking/screens/notifications_screen.dart`
- [Profile](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/profile/providers/profile_provider.dart): `lib/features/profile/providers/profile_provider.dart`

### Shop Operations

- [Shop Dashboard](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/shop_dashboard_screen.dart): `lib/features/shop_management/screens/shop_dashboard_screen.dart`
- [Inventory](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/inventory_screen.dart): `lib/features/shop_management/screens/inventory_screen.dart`
- [Incoming Orders](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/incoming_orders_screen.dart): `lib/features/shop_management/screens/incoming_orders_screen.dart`
- [Order Preparation](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/features/shop_management/screens/prepare_order_screen.dart): `lib/features/shop_management/screens/prepare_order_screen.dart`

### Shared Foundation

- [Auth Service](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/auth_service.dart): `lib/core/services/auth_service.dart`
- [Firestore Service](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/firestore_service.dart): `lib/core/services/firestore_service.dart`
- [Storage Service](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/storage_service.dart): `lib/core/services/storage_service.dart`
- [Notification Service](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/core/services/notification_service.dart): `lib/core/services/notification_service.dart`
- [Domain Models](https://github.com/darsika4478/pikzen-mobile-app/blob/main/lib/models/order_model.dart): `lib/models/order_model.dart`

### Other components

- **Customer / Shop**

## Connections

- Customer / Shop → App Entry: launches
- App Entry → App Shell: starts
- App Shell → Authentication: routes to
- App Shell → Product Discovery: routes to
- Product Discovery → Cart: adds products
- Cart → Checkout & Pickup: proceeds to
- Checkout & Pickup → Orders & Tracking: places order
- Orders & Tracking → Notifications: notifies
- App Shell → Profile: routes to
- App Shell → Shop Dashboard: routes to
- Shop Dashboard → Inventory: manages
- Shop Dashboard → Incoming Orders: views
- Incoming Orders → Order Preparation: prepares
- Authentication → Auth Service: uses
- Product Discovery → Firestore Service: loads data
- Checkout & Pickup → Firestore Service: stores order
- Orders & Tracking → Firestore Service: loads orders
- Notifications → Notification Service: uses
- Orders & Tracking → Domain Models: uses
