# vibeswithraj/e-commerce-website architecture

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

- Interactive diagram: https://gitdiagram.com/vibeswithraj/e-commerce-website
- Repository: https://github.com/vibeswithraj/e-commerce-website

## Overview

This is a React storefront with an Express/MongoDB backend. Customers browse and search products, manage carts and wishlists, check out, and use account features; administrators manage products and review orders through a dashboard. The graph preserves those major capabilities, but several page implementations and route/controller details were not excerpted, so uncertain client-to-API links are omitted or marked unverified.

Main entry points: [`client/src/pages/Home.jsx`](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Home.jsx) (Page Router), [`client/src/App.js`](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/App.js) (React App), [`server/router/products.js`](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/products.js) (Product API), [`server/models/user.js`](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/models/user.js) (User & Cart Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["React App<br/>[App.js]"]
  node_home["Page Router<br/>[Home.jsx]"]
  node_mainpage["Storefront Home<br/>[MainPage.jsx]"]
end

subgraph group_customer["Customer Commerce"]
  node_shop["Shop &amp; Catalog<br/>[Shop.jsx]"]
  node_allproducts["All Products<br/>[AllProducts.jsx]"]
  node_product["Product Display<br/>[Product.jsx]"]
  node_cart["Cart<br/>[AddToCart.jsx]"]
  node_checkout["Checkout<br/>[CheckDeatail.jsx]"]
  node_ordercomplete["Order Confirmation<br/>[OrderComplete.jsx]"]
  node_account["Account &amp; Orders"]
  node_wishlist["Wishlist<br/>[Wishlist.jsx]"]
  node_userstate["User State<br/>[UserContext.jsx]"]
  node_productstate["Commerce State<br/>[ProductContext.jsx]"]
  node_checkoutstate["Checkout State<br/>[DetailsContext.jsx]"]
end

subgraph group_admin["Administration"]
  node_adminlogin["Admin Access<br/>[AdminLogin.jsx]"]
  node_dashboard["Admin Dashboard<br/>[Dashboard.jsx]"]
  node_productadmin["Product Management<br/>[AddNewProduct.jsx]"]
  node_orderadmin["Order Management<br/>[OrderDetails.jsx]"]
  node_adminstate["Admin State<br/>[AdminProvider.jsx]"]
end

subgraph group_backend["API Backend"]
  node_server["HTTP Server<br/>[server.js]"]
  node_userapi["User API<br/>[user.js]"]
  node_adminapi["Admin API<br/>[admin.js]"]
  node_productapi["Product API<br/>[products.js]"]
  node_usercontroller["User Services<br/>[user.js]"]
  node_admincontroller["Admin Services<br/>[Admin.js]"]
  node_productcontroller["Catalog &amp; Orders<br/>[products.js]"]
  node_auth["JWT Auth<br/>[userAuth.js]"]
end

subgraph group_data["Persistence"]
  node_userstore[("User &amp; Cart Data<br/>[user.js]")]
  node_adminstore[("Admin &amp; Products<br/>[admin.js]")]
end

node_visitor(("Shopper"))
node_mongo[("MongoDB")]

node_visitor -->|"uses"| node_app
node_app -->|"renders"| node_home
node_home -->|"routes"| node_mainpage
node_home -->|"routes"| node_shop
node_home -->|"routes"| node_allproducts
node_home -->|"routes"| node_account
node_home -->|"routes"| node_adminlogin
node_home -->|"routes"| node_dashboard
node_shop -.->|"renders"| node_product
node_cart -->|"reads and updates"| node_productstate
node_cart -->|"reads and updates"| node_checkoutstate
node_checkout -->|"reads and updates"| node_productstate
node_checkout -->|"reads and updates"| node_checkoutstate
node_productstate -->|"sets subtotal"| node_checkoutstate
node_app -->|"provides"| node_userstate
node_app -->|"provides"| node_productstate
node_app -->|"provides"| node_checkoutstate
node_app -->|"provides"| node_adminstate
node_dashboard -->|"reads and updates"| node_adminstate
node_dashboard -->|"renders"| node_orderadmin
node_server -->|"mounts"| node_userapi
node_server -->|"mounts"| node_adminapi
node_server -->|"mounts"| node_productapi
node_server -->|"connects"| node_mongo
node_userapi -->|"dispatches"| node_usercontroller
node_adminapi -->|"dispatches"| node_admincontroller
node_productapi -->|"dispatches"| node_productcontroller
node_productapi -->|"uses middleware"| node_auth
node_usercontroller -->|"queries"| node_userstore
node_usercontroller -->|"sets auth cookies"| node_auth
node_admincontroller -->|"queries"| node_adminstore
node_admincontroller -->|"queries"| node_userstore
node_admincontroller -->|"uses product services"| node_productcontroller
node_productcontroller -->|"queries products"| node_adminstore
node_productcontroller -->|"reads and writes"| node_userstore
node_auth -->|"verifies users"| node_userstore
node_auth -->|"loads admin"| node_adminstore
node_userstore -.->|"persists"| node_mongo
node_adminstore -.->|"persists"| node_mongo
node_userstate -.->|"fetches session"| node_userapi
node_cart -.->|"cart operations"| node_productapi
node_checkout -.->|"submits order"| node_productapi
node_dashboard -.->|"loads analytics"| node_adminapi
node_productadmin -.->|"manages catalog"| node_adminapi

click node_app "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/App.js"
click node_home "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Home.jsx"
click node_mainpage "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/MainPage.jsx"
click node_shop "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Shop.jsx"
click node_allproducts "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/AllProducts.jsx"
click node_product "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/components/Product.jsx"
click node_cart "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/cart/AddToCart.jsx"
click node_checkout "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/cart/CheckDeatail.jsx"
click node_ordercomplete "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/cart/OrderComplete.jsx"
click node_account "https://github.com/vibeswithraj/e-commerce-website/tree/main/client/src/pages/account"
click node_wishlist "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/account/Wishlist.jsx"
click node_userstate "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/UserContext.jsx"
click node_productstate "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/ProductContext.jsx"
click node_checkoutstate "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/DetailsContext.jsx"
click node_adminlogin "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/AdminLogin.jsx"
click node_dashboard "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Dashboard.jsx"
click node_productadmin "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/components/AddNewProduct.jsx"
click node_orderadmin "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/components/OrderDetails.jsx"
click node_adminstate "https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/AdminProvider.jsx"
click node_server "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/server.js"
click node_userapi "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/user.js"
click node_adminapi "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/admin.js"
click node_productapi "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/products.js"
click node_usercontroller "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/controller/user.js"
click node_admincontroller "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/controller/Admin.js"
click node_productcontroller "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/controller/products.js"
click node_auth "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/helpers/userAuth.js"
click node_userstore "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/models/user.js"
click node_adminstore "https://github.com/vibeswithraj/e-commerce-website/blob/main/server/models/admin.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_mainpage toneBlue
class node_shop,node_allproducts,node_product,node_cart,node_checkout,node_ordercomplete,node_account,node_wishlist,node_userstate,node_productstate,node_checkoutstate,node_mongo toneAmber
class node_adminlogin,node_dashboard,node_productadmin,node_orderadmin,node_adminstate toneMint
class node_server,node_userapi,node_adminapi,node_productapi,node_usercontroller,node_admincontroller,node_productcontroller,node_auth toneRose
class node_userstore,node_adminstore,node_visitor toneIndigo
```

## Components

### Storefront

- [React App](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/App.js): `client/src/App.js`
- [Page Router](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Storefront Home](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/MainPage.jsx): `client/src/pages/MainPage.jsx`

### Customer Commerce

- [Shop & Catalog](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Shop.jsx): `client/src/pages/Shop.jsx`
- [All Products](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/AllProducts.jsx): `client/src/pages/AllProducts.jsx`
- [Product Display](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/components/Product.jsx): `client/src/components/Product.jsx`
- [Cart](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/cart/AddToCart.jsx): `client/src/pages/cart/AddToCart.jsx`
- [Checkout](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/cart/CheckDeatail.jsx): `client/src/pages/cart/CheckDeatail.jsx`
- [Order Confirmation](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/cart/OrderComplete.jsx): `client/src/pages/cart/OrderComplete.jsx`
- [Account & Orders](https://github.com/vibeswithraj/e-commerce-website/tree/main/client/src/pages/account): `client/src/pages/account`
- [Wishlist](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/account/Wishlist.jsx): `client/src/pages/account/Wishlist.jsx`
- [User State](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/UserContext.jsx): `client/src/contexts/UserContext.jsx`
- [Commerce State](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/ProductContext.jsx): `client/src/contexts/ProductContext.jsx`
- [Checkout State](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/DetailsContext.jsx): `client/src/contexts/DetailsContext.jsx`

### Administration

- [Admin Access](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/AdminLogin.jsx): `client/src/pages/AdminLogin.jsx`
- [Admin Dashboard](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Product Management](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/components/AddNewProduct.jsx): `client/src/components/AddNewProduct.jsx`
- [Order Management](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/components/OrderDetails.jsx): `client/src/components/OrderDetails.jsx`
- [Admin State](https://github.com/vibeswithraj/e-commerce-website/blob/main/client/src/contexts/AdminProvider.jsx): `client/src/contexts/AdminProvider.jsx`

### API Backend

- [HTTP Server](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/server.js): `server/server.js`
- [User API](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/user.js): `server/router/user.js`
- [Admin API](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/admin.js): `server/router/admin.js`
- [Product API](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/router/products.js): `server/router/products.js`
- [User Services](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/controller/user.js): `server/controller/user.js`
- [Admin Services](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/controller/Admin.js): `server/controller/Admin.js`
- [Catalog & Orders](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/controller/products.js): `server/controller/products.js`
- [JWT Auth](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/helpers/userAuth.js): `server/helpers/userAuth.js`

### Persistence

- [User & Cart Data](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/models/user.js): `server/models/user.js`
- [Admin & Products](https://github.com/vibeswithraj/e-commerce-website/blob/main/server/models/admin.js): `server/models/admin.js`

### Other components

- **Shopper**
- **MongoDB**

## Connections

- Shopper → React App: uses (evidence: `client/src/App.js`)
- React App → Page Router: renders (evidence: `client/src/App.js`)
- Page Router → Storefront Home: routes (evidence: `client/src/pages/Home.jsx`)
- Page Router → Shop & Catalog: routes (evidence: `client/src/pages/Home.jsx`)
- Page Router → All Products: routes (evidence: `client/src/pages/Home.jsx`)
- Page Router → Account & Orders: routes (evidence: `client/src/pages/Home.jsx`)
- Page Router → Admin Access: routes (evidence: `client/src/pages/Home.jsx`)
- Page Router → Admin Dashboard: routes (evidence: `client/src/pages/Home.jsx`)
- Shop & Catalog → Product Display: renders
- Cart → Commerce State: reads and updates (evidence: `client/src/pages/cart/AddToCart.jsx`)
- Cart → Checkout State: reads and updates (evidence: `client/src/pages/cart/AddToCart.jsx`)
- Checkout → Commerce State: reads and updates (evidence: `client/src/pages/cart/CheckDeatail.jsx`)
- Checkout → Checkout State: reads and updates (evidence: `client/src/pages/cart/CheckDeatail.jsx`)
- Commerce State → Checkout State: sets subtotal (evidence: `client/src/contexts/ProductContext.jsx`)
- React App → User State: provides (evidence: `client/src/App.js`)
- React App → Commerce State: provides (evidence: `client/src/App.js`)
- React App → Checkout State: provides (evidence: `client/src/App.js`)
- React App → Admin State: provides (evidence: `client/src/App.js`)
- Admin Dashboard → Admin State: reads and updates (evidence: `client/src/pages/Dashboard.jsx`)
- Admin Dashboard → Order Management: renders (evidence: `client/src/pages/Dashboard.jsx`)
- HTTP Server → User API: mounts (evidence: `server/server.js`)
- HTTP Server → Admin API: mounts (evidence: `server/server.js`)
- HTTP Server → Product API: mounts (evidence: `server/server.js`)
- HTTP Server → MongoDB: connects (evidence: `server/server.js`)
- User API → User Services: dispatches (evidence: `server/router/user.js`)
- Admin API → Admin Services: dispatches (evidence: `server/router/admin.js`)
- Product API → Catalog & Orders: dispatches (evidence: `server/router/products.js`)
- Product API → JWT Auth: uses middleware (evidence: `server/router/products.js`)
- User Services → User & Cart Data: queries (evidence: `server/controller/user.js`)
- User Services → JWT Auth: sets auth cookies (evidence: `server/controller/user.js`)
- Admin Services → Admin & Products: queries (evidence: `server/controller/Admin.js`)
- Admin Services → User & Cart Data: queries (evidence: `server/controller/Admin.js`)
- Admin Services → Catalog & Orders: uses product services (evidence: `server/controller/Admin.js`)
- Catalog & Orders → Admin & Products: queries products (evidence: `server/controller/products.js`)
- Catalog & Orders → User & Cart Data: reads and writes (evidence: `server/controller/products.js`)
- JWT Auth → User & Cart Data: verifies users (evidence: `server/helpers/userAuth.js`)
- JWT Auth → Admin & Products: loads admin (evidence: `server/helpers/userAuth.js`)
- User & Cart Data → MongoDB: persists
- Admin & Products → MongoDB: persists
- User State → User API: fetches session
- Cart → Product API: cart operations
- Checkout → Product API: submits order
- Admin Dashboard → Admin API: loads analytics
- Product Management → Admin API: manages catalog
