# truptigujar/luxora-mern-ecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/truptigujar/luxora-mern-ecommerce
- Repository: https://github.com/truptigujar/luxora-mern-ecommerce

## Overview

LUXORA is a React storefront backed by an Express API and a local JSON-file database. The main customer journey is browsing the catalogue, viewing a product, adding it to a cart, and submitting checkout; login supports account-backed cart and order features. Contact messages and newsletter subscriptions are separate capabilities. The graph follows documented routes and source-index references; connections not demonstrated by the excerpts or README are omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/App.jsx) (App Router), [`client/src/api.js`](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/api.js) (API Client), [`server/server.js`](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/server.js) (Express API), [`client/src/context/CartContext.jsx`](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/context/CartContext.jsx) (Cart Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App Router<br/>[App.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_categories["Category Pages<br/>[CategoryPage.jsx]"]
  node_product_detail["Product Details<br/>[ProductDetails.jsx]"]
  node_product_card["Product Card<br/>[ProductCard.jsx]"]
  node_quick_view["Quick View"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_confirmation["Order Confirmation"]
  node_account_pages["Account Pages<br/>[Login.jsx]"]
  node_cart_page["Cart Page<br/>[Cart.jsx]"]
  node_info_pages["Brand Pages<br/>[About.jsx]"]
  node_contact_page["Contact Form<br/>[Contact.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_client_state["Client State"]
  node_auth_state["Auth Context<br/>[AuthContext.jsx]"]
  node_cart_state["Cart Context<br/>[CartContext.jsx]"]
  node_fallback_products["Fallback Catalogue<br/>[products.js]"]
end

subgraph group_api_domains["API Domains"]
  node_api_client["API Client<br/>[api.js]"]
  node_server["Express API<br/>[server.js]"]
  node_auth_routes["Auth Routes<br/>[auth.js]"]
  node_product_routes["Product Routes<br/>[products.js]"]
  node_cart_routes["Cart Routes<br/>[cart.js]"]
  node_order_routes["Order Routes<br/>[orders.js]"]
  node_contact_routes["Contact Route<br/>[contact.js]"]
  node_newsletter_routes["Newsletter Route<br/>[newsletter.js]"]
  node_auth_middleware["JWT Middleware<br/>[auth.js]"]
end

subgraph group_persistence["Persistence"]
  node_product_model["Product Model<br/>[Product.js]"]
  node_cart_model["Cart Model<br/>[Cart.js]"]
  node_order_model["Order Model<br/>[Order.js]"]
  node_user_model["User Model<br/>[User.js]"]
  node_contact_model["Contact Messages<br/>[ContactMessage.js]"]
  node_subscriber_model["Subscribers<br/>[Subscriber.js]"]
  node_store["Collection Store<br/>[store.js]"]
  node_json_db[("Local JSON DB<br/>[db.js]")]
end

node_shopper(("Shopper"))

node_shopper -->|"browses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_categories
node_app -->|"routes to"| node_product_detail
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_confirmation
node_app -->|"routes to"| node_account_pages
node_app -->|"routes to"| node_cart_page
node_app -->|"routes to"| node_info_pages
node_app -->|"routes to"| node_contact_page
node_app -->|"renders"| node_footer
node_home -->|"loads products"| node_api_client
node_home -->|"uses fallback"| node_fallback_products
node_home -->|"renders"| node_product_card
node_categories -.->|"loads products"| node_api_client
node_product_detail -->|"loads product"| node_api_client
node_product_detail -->|"uses fallback"| node_fallback_products
node_product_detail -->|"renders"| node_product_card
node_product_card -->|"adds item"| node_cart_state
node_quick_view -->|"adds item"| node_cart_state
node_cart_page -->|"updates cart"| node_cart_state
node_checkout -->|"reads cart"| node_cart_state
node_checkout -->|"reads account"| node_auth_state
node_checkout -->|"submits order"| node_api_client
node_confirmation -->|"loads order"| node_api_client
node_account_pages -->|"authenticates"| node_auth_state
node_auth_state -->|"requests auth"| node_api_client
node_cart_state -->|"syncs cart"| node_api_client
node_contact_page -->|"sends message"| node_api_client
node_footer -->|"subscribes email"| node_api_client
node_api_client -->|"calls API"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_product_routes
node_server -->|"mounts routes"| node_cart_routes
node_server -->|"mounts routes"| node_order_routes
node_server -->|"mounts routes"| node_contact_routes
node_server -->|"mounts routes"| node_newsletter_routes
node_auth_routes -->|"manages users"| node_user_model
node_product_routes -->|"queries products"| node_product_model
node_cart_routes -->|"manages carts"| node_cart_model
node_cart_routes -->|"checks token"| node_auth_middleware
node_order_routes -->|"manages orders"| node_order_model
node_order_routes -->|"checks token"| node_auth_middleware
node_contact_routes -->|"stores message"| node_contact_model
node_newsletter_routes -->|"stores email"| node_subscriber_model
node_product_model -->|"uses collection"| node_store
node_cart_model -->|"uses collection"| node_store
node_order_model -->|"uses collection"| node_store

click node_app "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/App.jsx"
click node_home "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Home.jsx"
click node_categories "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/CategoryPage.jsx"
click node_product_detail "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/ProductDetails.jsx"
click node_product_card "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/components/ProductCard.jsx"
click node_quick_view "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/components/ProductQuickView.jsx"
click node_checkout "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Checkout.jsx"
click node_confirmation "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/OrderConfirmation.jsx"
click node_account_pages "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Login.jsx"
click node_cart_page "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Cart.jsx"
click node_info_pages "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/About.jsx"
click node_contact_page "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Contact.jsx"
click node_footer "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/components/Footer.jsx"
click node_auth_state "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/context/AuthContext.jsx"
click node_cart_state "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/context/CartContext.jsx"
click node_fallback_products "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/data/products.js"
click node_api_client "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/api.js"
click node_server "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/server.js"
click node_auth_routes "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/auth.js"
click node_product_routes "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/products.js"
click node_cart_routes "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/cart.js"
click node_order_routes "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/orders.js"
click node_contact_routes "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/contact.js"
click node_newsletter_routes "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/newsletter.js"
click node_auth_middleware "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/middleware/auth.js"
click node_product_model "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Product.js"
click node_cart_model "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Cart.js"
click node_order_model "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Order.js"
click node_user_model "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/User.js"
click node_contact_model "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/ContactMessage.js"
click node_subscriber_model "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Subscriber.js"
click node_store "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/config/store.js"
click node_json_db "https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/config/db.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_app,node_home,node_categories,node_product_detail,node_product_card,node_quick_view,node_checkout,node_confirmation,node_account_pages,node_cart_page,node_info_pages,node_contact_page,node_footer toneBlue
class node_auth_state,node_cart_state,node_fallback_products toneAmber
class node_api_client,node_server,node_auth_routes,node_product_routes,node_cart_routes,node_order_routes,node_contact_routes,node_newsletter_routes,node_auth_middleware toneMint
class node_product_model,node_cart_model,node_order_model,node_user_model,node_contact_model,node_subscriber_model,node_store,node_json_db toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [App Router](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Home](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Category Pages](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/CategoryPage.jsx): `client/src/pages/CategoryPage.jsx`
- [Product Details](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/ProductDetails.jsx): `client/src/pages/ProductDetails.jsx`
- [Product Card](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/components/ProductCard.jsx): `client/src/components/ProductCard.jsx`
- [Quick View](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/components/ProductQuickView.jsx): `client/src/components/ProductQuickView.jsx`
- [Checkout](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Checkout.jsx): `client/src/pages/Checkout.jsx`
- [Order Confirmation](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/OrderConfirmation.jsx): `client/src/pages/OrderConfirmation.jsx`
- [Account Pages](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Cart Page](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Cart.jsx): `client/src/pages/Cart.jsx`
- [Brand Pages](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/About.jsx): `client/src/pages/About.jsx`
- [Contact Form](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/pages/Contact.jsx): `client/src/pages/Contact.jsx`
- [Footer](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/components/Footer.jsx): `client/src/components/Footer.jsx`

### Client State

- [Auth Context](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Cart Context](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/context/CartContext.jsx): `client/src/context/CartContext.jsx`
- [Fallback Catalogue](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/data/products.js): `client/src/data/products.js`

### API Domains

- [API Client](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/client/src/api.js): `client/src/api.js`
- [Express API](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/server.js): `server/server.js`
- [Auth Routes](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Product Routes](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/products.js): `server/routes/products.js`
- [Cart Routes](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/cart.js): `server/routes/cart.js`
- [Order Routes](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/orders.js): `server/routes/orders.js`
- [Contact Route](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/contact.js): `server/routes/contact.js`
- [Newsletter Route](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/routes/newsletter.js): `server/routes/newsletter.js`
- [JWT Middleware](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/middleware/auth.js): `server/middleware/auth.js`

### Persistence

- [Product Model](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Product.js): `server/models/Product.js`
- [Cart Model](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Cart.js): `server/models/Cart.js`
- [Order Model](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Order.js): `server/models/Order.js`
- [User Model](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/User.js): `server/models/User.js`
- [Contact Messages](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/ContactMessage.js): `server/models/ContactMessage.js`
- [Subscribers](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/models/Subscriber.js): `server/models/Subscriber.js`
- [Collection Store](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/config/store.js): `server/config/store.js`
- [Local JSON DB](https://github.com/truptigujar/luxora-mern-ecommerce/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **Shopper**

## Connections

- Shopper → App Router: browses (evidence: `client/src/App.jsx`)
- App Router → Home: routes to (evidence: `client/src/App.jsx`)
- App Router → Category Pages: routes to (evidence: `client/src/App.jsx`)
- App Router → Product Details: routes to (evidence: `client/src/App.jsx`)
- App Router → Checkout: routes to (evidence: `client/src/App.jsx`)
- App Router → Order Confirmation: routes to (evidence: `client/src/App.jsx`)
- App Router → Account Pages: routes to (evidence: `client/src/App.jsx`)
- App Router → Cart Page: routes to (evidence: `client/src/App.jsx`)
- App Router → Brand Pages: routes to (evidence: `client/src/App.jsx`)
- App Router → Contact Form: routes to (evidence: `client/src/App.jsx`)
- App Router → Footer: renders (evidence: `client/src/App.jsx`)
- Home → API Client: loads products (evidence: `client/src/pages/Home.jsx`)
- Home → Fallback Catalogue: uses fallback (evidence: `client/src/pages/Home.jsx`)
- Home → Product Card: renders (evidence: `client/src/pages/Home.jsx`)
- Category Pages → API Client: loads products
- Product Details → API Client: loads product (evidence: `client/src/pages/ProductDetails.jsx`)
- Product Details → Fallback Catalogue: uses fallback (evidence: `client/src/pages/ProductDetails.jsx`)
- Product Details → Product Card: renders (evidence: `client/src/pages/ProductDetails.jsx`)
- Product Card → Cart Context: adds item (evidence: `client/src/components/ProductCard.jsx`)
- Quick View → Cart Context: adds item (evidence: `client/src/components/ProductQuickView.jsx`)
- Cart Page → Cart Context: updates cart (evidence: `client/src/pages/Cart.jsx`)
- Checkout → Cart Context: reads cart (evidence: `client/src/pages/Checkout.jsx`)
- Checkout → Auth Context: reads account (evidence: `client/src/pages/Checkout.jsx`)
- Checkout → API Client: submits order (evidence: `client/src/pages/Checkout.jsx`)
- Order Confirmation → API Client: loads order (evidence: `client/src/pages/OrderConfirmation.jsx`)
- Account Pages → Auth Context: authenticates (evidence: `client/src/pages/Login.jsx`)
- Auth Context → API Client: requests auth (evidence: `client/src/context/AuthContext.jsx`)
- Cart Context → API Client: syncs cart (evidence: `client/src/context/CartContext.jsx`)
- Contact Form → API Client: sends message (evidence: `client/src/pages/Contact.jsx`)
- Footer → API Client: subscribes email (evidence: `client/src/components/Footer.jsx`)
- API Client → Express API: calls API (evidence: `README.md`)
- Express API → Auth Routes: mounts routes (evidence: `server/server.js`)
- Express API → Product Routes: mounts routes (evidence: `server/server.js`)
- Express API → Cart Routes: mounts routes (evidence: `server/server.js`)
- Express API → Order Routes: mounts routes (evidence: `server/server.js`)
- Express API → Contact Route: mounts routes (evidence: `server/server.js`)
- Express API → Newsletter Route: mounts routes (evidence: `server/server.js`)
- Auth Routes → User Model: manages users (evidence: `server/routes/auth.js`)
- Product Routes → Product Model: queries products (evidence: `server/routes/products.js`)
- Cart Routes → Cart Model: manages carts (evidence: `server/routes/cart.js`)
- Cart Routes → JWT Middleware: checks token (evidence: `server/routes/cart.js`)
- Order Routes → Order Model: manages orders (evidence: `server/models/Order.js`)
- Order Routes → JWT Middleware: checks token (evidence: `server/routes/orders.js`)
- Contact Route → Contact Messages: stores message (evidence: `server/routes/contact.js`)
- Newsletter Route → Subscribers: stores email (evidence: `server/routes/newsletter.js`)
- Product Model → Collection Store: uses collection (evidence: `server/models/Product.js`)
- Cart Model → Collection Store: uses collection (evidence: `server/models/Cart.js`)
- Order Model → Collection Store: uses collection (evidence: `server/models/Order.js`)
