# yashwanth0210/dashkirana architecture

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

- Interactive diagram: https://gitdiagram.com/yashwanth0210/dashkirana
- Repository: https://github.com/yashwanth0210/dashkirana

## Overview

DashKirana is a grocery-shopping web app with customer storefront and admin operations. Customers browse and filter groceries, manage a cart, place orders, and view order status; admins manage orders, products, inventory, and customers. The store service provides a shared data layer backed by Supabase when enabled and browser storage/mock data otherwise. Source-index references and excerpts support the shown calls; unsampled admin and account behavior is represented at its existing route-directory level.

Main entry points: [`DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts`](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts) (Store service), [`DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/page.tsx) (Home storefront), [`DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx`](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx) (Product catalog), [`DashKirana-Handover/dash-mobile-demo-main/components/BottomNav.tsx`](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/BottomNav.tsx) (Bottom navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Customer shopping"]
  node_home["Home storefront<br/>[page.tsx]"]
  node_catalog["Product catalog<br/>[page.tsx]"]
  node_product_detail["Product details<br/>[page.tsx]"]
  node_cart["Shopping cart<br/>[page.tsx]"]
  node_account["Customer account"]
  node_customer_auth["Customer sign-in<br/>[page.tsx]"]
end

subgraph group_orders["Checkout and orders"]
  node_checkout["Checkout<br/>[page.tsx]"]
  node_order_list["Customer orders<br/>[page.tsx]"]
  node_order_detail["Order tracking<br/>[page.tsx]"]
end

subgraph group_admin["Admin operations"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_auth["Admin sign-in<br/>[page.tsx]"]
  node_admin_orders["Order management"]
  node_admin_products["Product management"]
  node_admin_inventory["Inventory management<br/>[page.tsx]"]
  node_admin_customers["Customer management<br/>[page.tsx]"]
end

subgraph group_data["Data services"]
  node_browser_cart[("Browser cart storage")]
  node_store["Store service<br/>[store.ts]"]
  node_mock_data["Mock data<br/>[mockData.ts]"]
  node_types["Domain types<br/>[index.ts]"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
  node_supabase_db[("Supabase database")]
end

subgraph group_ui["Shared interface"]
  node_product_card["Product card<br/>[ProductCard.tsx]"]
  node_bottom_nav["Bottom navigation<br/>[BottomNav.tsx]"]
  node_header["Storefront header<br/>[Header.tsx]"]
end

node_customer(("Customer"))
node_admin_user(("Admin"))

node_customer -->|"browses"| node_home
node_customer -->|"browses"| node_catalog
node_home -->|"loads products"| node_store
node_catalog -->|"loads products"| node_store
node_home -->|"reads and writes"| node_browser_cart
node_cart -->|"reads and writes"| node_browser_cart
node_home -->|"renders"| node_product_card
node_catalog -->|"renders"| node_product_card
node_home -->|"renders"| node_header
node_home -->|"renders"| node_bottom_nav
node_catalog -->|"renders"| node_bottom_nav
node_order_list -->|"renders"| node_bottom_nav
node_checkout -->|"creates order"| node_store
node_order_list -->|"loads orders"| node_store
node_order_detail -->|"loads order"| node_store
node_admin_user -->|"manages store"| node_admin_dashboard
node_admin_dashboard -->|"loads metrics"| node_store
node_admin_orders -.->|"manages orders"| node_store
node_admin_products -.->|"manages products"| node_store
node_admin_inventory -->|"manages inventory"| node_store
node_admin_customers -->|"loads customers"| node_store
node_customer_auth -->|"authenticates"| node_supabase_client
node_store -->|"uses fallback data"| node_mock_data
node_store -->|"uses client"| node_supabase_client
node_store -->|"reads and writes"| node_supabase_db
node_store -->|"persists fallback records"| node_browser_cart

click node_home "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/page.tsx"
click node_catalog "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx"
click node_product_detail "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/products/%5Bid%5D/page.tsx"
click node_product_card "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/ProductCard.tsx"
click node_cart "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/cart/page.tsx"
click node_checkout "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/checkout/page.tsx"
click node_order_list "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/orders/page.tsx"
click node_order_detail "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/orders/%5Bid%5D/page.tsx"
click node_account "https://github.com/yashwanth0210/dashkirana/tree/main/DashKirana-Handover/dash-mobile-demo-main/app/account"
click node_customer_auth "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/login/page.tsx"
click node_admin_dashboard "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/page.tsx"
click node_admin_auth "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/login/page.tsx"
click node_admin_orders "https://github.com/yashwanth0210/dashkirana/tree/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/orders"
click node_admin_products "https://github.com/yashwanth0210/dashkirana/tree/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/products"
click node_admin_inventory "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/inventory/page.tsx"
click node_admin_customers "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/customers/page.tsx"
click node_store "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts"
click node_mock_data "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/data/mockData.ts"
click node_types "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/types/index.ts"
click node_supabase_client "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/supabase/client.ts"
click node_bottom_nav "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/BottomNav.tsx"
click node_header "https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/Header.tsx"

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_catalog,node_product_detail,node_cart,node_account,node_customer_auth toneBlue
class node_checkout,node_order_list,node_order_detail toneAmber
class node_admin_dashboard,node_admin_auth,node_admin_orders,node_admin_products,node_admin_inventory,node_admin_customers toneMint
class node_browser_cart,node_store,node_mock_data,node_types,node_supabase_client,node_supabase_db toneRose
class node_product_card,node_bottom_nav,node_header,node_customer,node_admin_user toneIndigo
```

## Components

### Customer shopping

- [Home storefront](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`
- [Product catalog](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx`
- [Product details](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/products/%5Bid%5D/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/products/[id]/page.tsx`
- [Shopping cart](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/cart/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/cart/page.tsx`
- [Customer account](https://github.com/yashwanth0210/dashkirana/tree/main/DashKirana-Handover/dash-mobile-demo-main/app/account): `DashKirana-Handover/dash-mobile-demo-main/app/account`
- [Customer sign-in](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/login/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/login/page.tsx`

### Checkout and orders

- [Checkout](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/checkout/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/checkout/page.tsx`
- [Customer orders](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/orders/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/orders/page.tsx`
- [Order tracking](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/orders/%5Bid%5D/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/orders/[id]/page.tsx`

### Admin operations

- [Admin dashboard](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/admin/page.tsx`
- [Admin sign-in](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/login/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/admin/login/page.tsx`
- [Order management](https://github.com/yashwanth0210/dashkirana/tree/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/orders): `DashKirana-Handover/dash-mobile-demo-main/app/admin/orders`
- [Product management](https://github.com/yashwanth0210/dashkirana/tree/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/products): `DashKirana-Handover/dash-mobile-demo-main/app/admin/products`
- [Inventory management](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/inventory/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/admin/inventory/page.tsx`
- [Customer management](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/app/admin/customers/page.tsx): `DashKirana-Handover/dash-mobile-demo-main/app/admin/customers/page.tsx`

### Data services

- **Browser cart storage**
- [Store service](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts): `DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts`
- [Mock data](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/data/mockData.ts): `DashKirana-Handover/dash-mobile-demo-main/lib/data/mockData.ts`
- [Domain types](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/types/index.ts): `DashKirana-Handover/dash-mobile-demo-main/lib/types/index.ts`
- [Supabase client](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/lib/supabase/client.ts): `DashKirana-Handover/dash-mobile-demo-main/lib/supabase/client.ts`
- **Supabase database**

### Shared interface

- [Product card](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/ProductCard.tsx): `DashKirana-Handover/dash-mobile-demo-main/components/ProductCard.tsx`
- [Bottom navigation](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/BottomNav.tsx): `DashKirana-Handover/dash-mobile-demo-main/components/BottomNav.tsx`
- [Storefront header](https://github.com/yashwanth0210/dashkirana/blob/main/DashKirana-Handover/dash-mobile-demo-main/components/Header.tsx): `DashKirana-Handover/dash-mobile-demo-main/components/Header.tsx`

### Other components

- **Customer**
- **Admin**

## Connections

- Customer → Home storefront: browses (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`)
- Customer → Product catalog: browses (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx`)
- Home storefront → Store service: loads products (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`)
- Product catalog → Store service: loads products (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx`)
- Home storefront → Browser cart storage: reads and writes (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`)
- Shopping cart → Browser cart storage: reads and writes (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/cart/page.tsx`)
- Home storefront → Product card: renders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`)
- Product catalog → Product card: renders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx`)
- Home storefront → Storefront header: renders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`)
- Home storefront → Bottom navigation: renders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/page.tsx`)
- Product catalog → Bottom navigation: renders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/products/page.tsx`)
- Customer orders → Bottom navigation: renders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/orders/page.tsx`)
- Checkout → Store service: creates order (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/checkout/page.tsx`)
- Customer orders → Store service: loads orders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/orders/page.tsx`)
- Order tracking → Store service: loads order (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/orders/[id]/page.tsx`)
- Admin → Admin dashboard: manages store (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/admin/page.tsx`)
- Admin dashboard → Store service: loads metrics (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/admin/page.tsx`)
- Order management → Store service: manages orders (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/admin/orders/page.tsx`)
- Product management → Store service: manages products (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/admin/products/page.tsx`)
- Inventory management → Store service: manages inventory (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/admin/inventory/page.tsx`)
- Customer management → Store service: loads customers (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/admin/customers/page.tsx`)
- Customer sign-in → Supabase client: authenticates (evidence: `DashKirana-Handover/dash-mobile-demo-main/app/login/page.tsx`)
- Store service → Mock data: uses fallback data (evidence: `DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts`)
- Store service → Supabase client: uses client (evidence: `DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts`)
- Store service → Supabase database: reads and writes (evidence: `DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts`)
- Store service → Browser cart storage: persists fallback records (evidence: `DashKirana-Handover/dash-mobile-demo-main/lib/services/store.ts`)
