# kddeveloperhub/styleaura-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/kddeveloperhub/styleaura-ecommerce
- Repository: https://github.com/kddeveloperhub/styleaura-ecommerce

## Overview

Style Aura is a fashion-commerce storefront with customer shopping, account, ordering, payment, and administration capabilities. The main customer journey runs from browsing or searching products through cart and checkout, then payment and order confirmation/history. The frontend also maintains wishlist and authentication state, while the Express backend secures order and payment routes and persists order records in Firestore. Catalog and page composition are visible in the supplied excerpts and index; some frontend-to-backend request details are not shown, so those links are left unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/App.jsx) (Page Router), [`backend/routes/paymentRoutes.js`](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/routes/paymentRoutes.js) (Payment Routes), [`backend/server.js`](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/server.js) (API Server), [`frontend/src/components/ProductCard.jsx`](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/components/ProductCard.jsx) (Product Card)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_router["Page Router<br/>[App.jsx]"]
  node_catalog["Catalog Pages"]
  node_product_data["Product Data<br/>[products.js]"]
  node_search["Product Search<br/>[SearchResults.jsx]"]
  node_product_card["Product Card<br/>[ProductCard.jsx]"]
  node_cart_pages["Cart and Checkout<br/>[Checkout.jsx]"]
  node_wishlist_pages["Wishlist Pages<br/>[Wishlist.jsx]"]
  node_payment_page["Payment Page<br/>[Payment.jsx]"]
  node_order_views["Order Views<br/>[MyOrders.jsx]"]
  node_confirmation["Order Confirmation"]
  node_admin_page["Admin Dashboard<br/>[AdminDashboard.jsx]"]
end

subgraph group_customer_state["Customer State"]
  node_cart_state["Cart State<br/>[CartContext.js]"]
  node_wishlist_state["Wishlist State<br/>[WishlistContext.js]"]
end

subgraph group_identity["Identity"]
  node_auth_pages["Account Pages<br/>[Login.jsx]"]
  node_auth_service["Authentication Service<br/>[authService.js]"]
  node_auth_context["Session and Role State<br/>[AuthContext.js]"]
  node_client_firebase["Firebase Client<br/>[firebase.js]"]
end

subgraph group_commerce_backend["Commerce Backend"]
  node_order_service["Order Service<br/>[orderService.js]"]
  node_server["API Server<br/>[server.js]"]
  node_auth_middleware["Token Verification<br/>[authMiddleware.js]"]
  node_order_routes["Order Routes<br/>[orderRoutes.js]"]
  node_payment_routes["Payment Routes<br/>[paymentRoutes.js]"]
  node_server_firebase[("Firebase Admin Store<br/>[firebase.js]")]
end

node_shopper(("Shopper"))
node_razorpay["Razorpay"]

node_shopper -->|"opens pages"| node_router
node_router -->|"routes to"| node_catalog
node_router -->|"routes to"| node_cart_pages
node_router -->|"routes to"| node_wishlist_pages
node_router -->|"routes to"| node_auth_pages
node_router -->|"routes to"| node_payment_page
node_router -->|"routes to"| node_order_views
node_router -->|"routes to"| node_confirmation
node_router -->|"routes to"| node_admin_page
node_catalog -->|"reads catalog"| node_product_data
node_search -->|"filters products"| node_product_data
node_search -->|"renders results"| node_product_card
node_product_card -->|"adds items"| node_cart_state
node_product_card -->|"toggles saved items"| node_wishlist_state
node_cart_pages -->|"reads cart"| node_cart_state
node_cart_pages -->|"creates orders"| node_order_service
node_wishlist_pages -.->|"uses wishlist"| node_wishlist_state
node_auth_pages -->|"signs in"| node_auth_service
node_auth_service -->|"uses Firebase Auth"| node_client_firebase
node_auth_context -->|"reads user role"| node_client_firebase
node_order_service -.->|"submits requests"| node_server
node_payment_page -.->|"requests payment"| node_payment_routes
node_order_views -.->|"loads orders"| node_server
node_admin_page -.->|"manages orders"| node_server
node_server -->|"mounts routes"| node_order_routes
node_server -->|"mounts routes"| node_payment_routes
node_order_routes -->|"verifies requests"| node_auth_middleware
node_payment_routes -->|"verifies requests"| node_auth_middleware
node_auth_middleware -->|"verifies ID tokens"| node_server_firebase
node_order_routes -->|"reads and writes orders"| node_server_firebase
node_payment_routes -->|"updates orders"| node_server_firebase
node_payment_routes -->|"creates payment order"| node_razorpay

click node_router "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/App.jsx"
click node_catalog "https://github.com/kddeveloperhub/styleaura-ecommerce/tree/main/frontend/src/pages"
click node_product_data "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/data/products.js"
click node_search "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/SearchResults.jsx"
click node_product_card "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/components/ProductCard.jsx"
click node_cart_pages "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Checkout.jsx"
click node_cart_state "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/context/CartContext.js"
click node_wishlist_pages "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Wishlist.jsx"
click node_wishlist_state "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/context/WishlistContext.js"
click node_auth_pages "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Login.jsx"
click node_auth_service "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/services/authService.js"
click node_auth_context "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/context/AuthContext.js"
click node_client_firebase "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/firebase/firebase.js"
click node_order_service "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/services/orderService.js"
click node_payment_page "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Payment.jsx"
click node_order_views "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/MyOrders.jsx"
click node_confirmation "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/OrderConfirmation.jsx"
click node_admin_page "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_server "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/server.js"
click node_auth_middleware "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/middleware/authMiddleware.js"
click node_order_routes "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/routes/orderRoutes.js"
click node_payment_routes "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/routes/paymentRoutes.js"
click node_server_firebase "https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/config/firebase.js"

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_router,node_catalog,node_product_data,node_search,node_product_card,node_cart_pages,node_wishlist_pages,node_payment_page,node_order_views,node_confirmation,node_admin_page toneBlue
class node_cart_state,node_wishlist_state toneAmber
class node_auth_pages,node_auth_service,node_auth_context,node_client_firebase toneMint
class node_order_service,node_server,node_auth_middleware,node_order_routes,node_payment_routes,node_server_firebase toneRose
class node_shopper,node_razorpay toneIndigo
```

## Components

### Storefront

- [Page Router](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Catalog Pages](https://github.com/kddeveloperhub/styleaura-ecommerce/tree/main/frontend/src/pages): `frontend/src/pages`
- [Product Data](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/data/products.js): `frontend/src/data/products.js`
- [Product Search](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/SearchResults.jsx): `frontend/src/pages/SearchResults.jsx`
- [Product Card](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/components/ProductCard.jsx): `frontend/src/components/ProductCard.jsx`
- [Cart and Checkout](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Checkout.jsx): `frontend/src/pages/Checkout.jsx`
- [Wishlist Pages](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Wishlist.jsx): `frontend/src/pages/Wishlist.jsx`
- [Payment Page](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Payment.jsx): `frontend/src/pages/Payment.jsx`
- [Order Views](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/MyOrders.jsx): `frontend/src/pages/MyOrders.jsx`
- [Order Confirmation](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/OrderConfirmation.jsx): `frontend/src/pages/OrderConfirmation.jsx`
- [Admin Dashboard](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`

### Customer State

- [Cart State](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/context/CartContext.js): `frontend/src/context/CartContext.js`
- [Wishlist State](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/context/WishlistContext.js): `frontend/src/context/WishlistContext.js`

### Identity

- [Account Pages](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Authentication Service](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [Session and Role State](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/context/AuthContext.js): `frontend/src/context/AuthContext.js`
- [Firebase Client](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/firebase/firebase.js): `frontend/src/firebase/firebase.js`

### Commerce Backend

- [Order Service](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/frontend/src/services/orderService.js): `frontend/src/services/orderService.js`
- [API Server](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/server.js): `backend/server.js`
- [Token Verification](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Order Routes](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Payment Routes](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/routes/paymentRoutes.js): `backend/routes/paymentRoutes.js`
- [Firebase Admin Store](https://github.com/kddeveloperhub/styleaura-ecommerce/blob/main/backend/config/firebase.js): `backend/config/firebase.js`

### Other components

- **Shopper**
- **Razorpay**

## Connections

- Shopper → Page Router: opens pages (evidence: `frontend/src/App.jsx`)
- Page Router → Catalog Pages: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Cart and Checkout: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Wishlist Pages: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Account Pages: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Payment Page: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Order Views: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Order Confirmation: routes to (evidence: `frontend/src/App.jsx`)
- Page Router → Admin Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Catalog Pages → Product Data: reads catalog (evidence: `frontend/src/pages/Home.jsx`)
- Product Search → Product Data: filters products (evidence: `frontend/src/pages/SearchResults.jsx`)
- Product Search → Product Card: renders results (evidence: `frontend/src/pages/SearchResults.jsx`)
- Product Card → Cart State: adds items (evidence: `frontend/src/components/ProductCard.jsx`)
- Product Card → Wishlist State: toggles saved items (evidence: `frontend/src/components/ProductCard.jsx`)
- Cart and Checkout → Cart State: reads cart (evidence: `frontend/src/pages/Checkout.jsx`)
- Cart and Checkout → Order Service: creates orders (evidence: `frontend/src/pages/Checkout.jsx`)
- Wishlist Pages → Wishlist State: uses wishlist
- Account Pages → Authentication Service: signs in (evidence: `frontend/src/pages/Login.jsx`)
- Authentication Service → Firebase Client: uses Firebase Auth (evidence: `frontend/src/services/authService.js`)
- Session and Role State → Firebase Client: reads user role (evidence: `frontend/src/context/AuthContext.js`)
- Order Service → API Server: submits requests
- Payment Page → Payment Routes: requests payment
- Order Views → API Server: loads orders
- Admin Dashboard → API Server: manages orders
- API Server → Order Routes: mounts routes (evidence: `backend/server.js`)
- API Server → Payment Routes: mounts routes (evidence: `backend/server.js`)
- Order Routes → Token Verification: verifies requests (evidence: `backend/routes/orderRoutes.js`)
- Payment Routes → Token Verification: verifies requests (evidence: `backend/routes/paymentRoutes.js`)
- Token Verification → Firebase Admin Store: verifies ID tokens (evidence: `backend/middleware/authMiddleware.js`)
- Order Routes → Firebase Admin Store: reads and writes orders (evidence: `backend/routes/orderRoutes.js`)
- Payment Routes → Firebase Admin Store: updates orders (evidence: `backend/routes/paymentRoutes.js`)
- Payment Routes → Razorpay: creates payment order (evidence: `backend/routes/paymentRoutes.js`)
