# pravinn18/ecocart architecture

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

- Interactive diagram: https://gitdiagram.com/pravinn18/ecocart
- Repository: https://github.com/pravinn18/ecocart

## Overview

This repository implements a grocery-commerce storefront and its admin interface, backed by an Express/MongoDB API. The main customer journey is browsing products, managing a cart, checking out, and tracking orders; related capabilities include login, wishlists, lifestyle and category browsing, Plus loyalty, and catalog and order administration. The graph also shows the API’s route and persistence layers. Several frontend pages and backend route modules are listed but not excerpted, so their internal connections are omitted where evidence is unavailable.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/App.jsx) (App routing), [`backend/routes/orderRoutes.js`](https://github.com/pravinn18/ecocart/blob/main/backend/routes/orderRoutes.js) (Order API), [`backend/server.js`](https://github.com/pravinn18/ecocart/blob/main/backend/server.js) (API server), [`backend/controllers/productController.js`](https://github.com/pravinn18/ecocart/blob/main/backend/controllers/productController.js) (Product API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App routing<br/>[App.jsx]"]
  node_home["Home discovery<br/>[Home.jsx]"]
  node_product["Product details<br/>[ProductDetails.jsx]"]
  node_browse["Search and browse<br/>[SearchResults.jsx]"]
  node_category["Category browsing"]
  node_lifestyle["Lifestyle browsing"]
  node_header["Store navigation<br/>[Header.jsx]"]
end

subgraph group_customer["Customer account"]
  node_login["Login<br/>[Login.jsx]"]
  node_auth["Auth state<br/>[AuthContext.jsx]"]
  node_wishlist["Wishlist state"]
  node_plus["Plus membership<br/>[PlusPage.jsx]"]
end

subgraph group_commerce["Cart and orders"]
  node_cart["Cart state<br/>[CartContext.jsx]"]
  node_checkout["Checkout"]
  node_orders["Order history<br/>[Orders.jsx]"]
  node_orderdetail["Order details<br/>[OrderDetails.jsx]"]
  node_admin["Admin operations<br/>[AdminDashboard.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["API server<br/>[server.js]"]
  node_productapi["Product API"]
  node_orderapi["Order API<br/>[orderRoutes.js]"]
  node_userapi["User and Plus API<br/>[userRoutes.js]"]
  node_authmw["Auth middleware<br/>[authMiddleware.js]"]
end

subgraph group_data["Data and integrations"]
  node_productmodel[("Product records<br/>[Product.js]")]
  node_ordermodel[("Order records<br/>[Order.js]")]
  node_usermodel[("User records<br/>[User.js]")]
  node_cloudinary["Image hosting<br/>[cloudinary.js]"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_product
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_category
node_app -->|"routes to"| node_lifestyle
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_plus
node_app -->|"renders"| node_header
node_app -->|"provides state"| node_cart
node_app -->|"provides state"| node_wishlist
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_orders
node_app -->|"routes to"| node_orderdetail
node_app -->|"routes to"| node_admin
node_server -->|"mounts routes"| node_productapi
node_server -->|"mounts routes"| node_orderapi
node_server -->|"mounts routes"| node_userapi
node_productapi -->|"reads and writes"| node_productmodel
node_productapi -->|"uploads images"| node_cloudinary
node_orderapi -->|"reads and writes"| node_ordermodel
node_orderapi -->|"updates sales"| node_productmodel
node_orderapi -->|"reads user"| node_usermodel
node_userapi -->|"reads and writes"| node_usermodel
node_orderapi -->|"protects routes"| node_authmw
node_userapi -->|"protects routes"| node_authmw
node_authmw -->|"loads user"| node_usermodel

click node_app "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/App.jsx"
click node_home "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/Home.jsx"
click node_product "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/ProductDetails.jsx"
click node_browse "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/SearchResults.jsx"
click node_category "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/CategoryProducts.jsx"
click node_lifestyle "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/LifestyleProducts.jsx"
click node_header "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/components/Header.jsx"
click node_login "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/Login.jsx"
click node_auth "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/context/AuthContext.jsx"
click node_wishlist "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/context/WishlistContext.jsx"
click node_plus "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/PlusPage.jsx"
click node_cart "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/context/CartContext.jsx"
click node_checkout "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/CheckoutPayment.jsx"
click node_orders "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/Orders.jsx"
click node_orderdetail "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/OrderDetails.jsx"
click node_admin "https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/AdminDashboard.jsx"
click node_server "https://github.com/pravinn18/ecocart/blob/main/backend/server.js"
click node_productapi "https://github.com/pravinn18/ecocart/blob/main/backend/controllers/productController.js"
click node_orderapi "https://github.com/pravinn18/ecocart/blob/main/backend/routes/orderRoutes.js"
click node_userapi "https://github.com/pravinn18/ecocart/blob/main/backend/routes/userRoutes.js"
click node_authmw "https://github.com/pravinn18/ecocart/blob/main/backend/middleware/authMiddleware.js"
click node_productmodel "https://github.com/pravinn18/ecocart/blob/main/backend/models/Product.js"
click node_ordermodel "https://github.com/pravinn18/ecocart/blob/main/backend/models/Order.js"
click node_usermodel "https://github.com/pravinn18/ecocart/blob/main/backend/models/User.js"
click node_cloudinary "https://github.com/pravinn18/ecocart/blob/main/backend/config/cloudinary.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_product,node_browse,node_category,node_lifestyle,node_header toneBlue
class node_login,node_auth,node_wishlist,node_plus toneAmber
class node_cart,node_checkout,node_orders,node_orderdetail,node_admin toneMint
class node_server,node_productapi,node_orderapi,node_userapi,node_authmw toneRose
class node_productmodel,node_ordermodel,node_usermodel,node_cloudinary,node_shopper toneIndigo
```

## Components

### Storefront

- [App routing](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Home discovery](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/Home.jsx): `Frontend/src/pages/Home.jsx`
- [Product details](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/ProductDetails.jsx): `Frontend/src/pages/ProductDetails.jsx`
- [Search and browse](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/SearchResults.jsx): `Frontend/src/pages/SearchResults.jsx`
- [Category browsing](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/CategoryProducts.jsx): `Frontend/src/pages/CategoryProducts.jsx`
- [Lifestyle browsing](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/LifestyleProducts.jsx): `Frontend/src/pages/LifestyleProducts.jsx`
- [Store navigation](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/components/Header.jsx): `Frontend/src/components/Header.jsx`

### Customer account

- [Login](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/Login.jsx): `Frontend/src/pages/Login.jsx`
- [Auth state](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/context/AuthContext.jsx): `Frontend/src/context/AuthContext.jsx`
- [Wishlist state](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/context/WishlistContext.jsx): `Frontend/src/context/WishlistContext.jsx`
- [Plus membership](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/PlusPage.jsx): `Frontend/src/pages/PlusPage.jsx`

### Cart and orders

- [Cart state](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/context/CartContext.jsx): `Frontend/src/context/CartContext.jsx`
- [Checkout](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/CheckoutPayment.jsx): `Frontend/src/pages/CheckoutPayment.jsx`
- [Order history](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/Orders.jsx): `Frontend/src/pages/Orders.jsx`
- [Order details](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/OrderDetails.jsx): `Frontend/src/pages/OrderDetails.jsx`
- [Admin operations](https://github.com/pravinn18/ecocart/blob/main/Frontend/src/pages/AdminDashboard.jsx): `Frontend/src/pages/AdminDashboard.jsx`

### Backend API

- [API server](https://github.com/pravinn18/ecocart/blob/main/backend/server.js): `backend/server.js`
- [Product API](https://github.com/pravinn18/ecocart/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Order API](https://github.com/pravinn18/ecocart/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [User and Plus API](https://github.com/pravinn18/ecocart/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Auth middleware](https://github.com/pravinn18/ecocart/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`

### Data and integrations

- [Product records](https://github.com/pravinn18/ecocart/blob/main/backend/models/Product.js): `backend/models/Product.js`
- [Order records](https://github.com/pravinn18/ecocart/blob/main/backend/models/Order.js): `backend/models/Order.js`
- [User records](https://github.com/pravinn18/ecocart/blob/main/backend/models/User.js): `backend/models/User.js`
- [Image hosting](https://github.com/pravinn18/ecocart/blob/main/backend/config/cloudinary.js): `backend/config/cloudinary.js`

### Other components

- **Shopper**

## Connections

- Shopper → App routing: uses
- App routing → Home discovery: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Product details: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Search and browse: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Category browsing: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Lifestyle browsing: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Login: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Plus membership: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Store navigation: renders (evidence: `Frontend/src/App.jsx`)
- App routing → Cart state: provides state (evidence: `Frontend/src/App.jsx`)
- App routing → Wishlist state: provides state (evidence: `Frontend/src/App.jsx`)
- App routing → Checkout: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Order history: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Order details: routes to (evidence: `Frontend/src/App.jsx`)
- App routing → Admin operations: routes to (evidence: `Frontend/src/App.jsx`)
- API server → Product API: mounts routes (evidence: `backend/server.js`)
- API server → Order API: mounts routes (evidence: `backend/server.js`)
- API server → User and Plus API: mounts routes (evidence: `backend/server.js`)
- Product API → Product records: reads and writes (evidence: `backend/controllers/productController.js`)
- Product API → Image hosting: uploads images (evidence: `backend/controllers/productController.js`)
- Order API → Order records: reads and writes (evidence: `backend/routes/orderRoutes.js`)
- Order API → Product records: updates sales (evidence: `backend/routes/orderRoutes.js`)
- Order API → User records: reads user (evidence: `backend/routes/orderRoutes.js`)
- User and Plus API → User records: reads and writes (evidence: `backend/routes/userRoutes.js`)
- Order API → Auth middleware: protects routes (evidence: `backend/routes/orderRoutes.js`)
- User and Plus API → Auth middleware: protects routes (evidence: `backend/routes/userRoutes.js`)
- Auth middleware → User records: loads user (evidence: `backend/middleware/authMiddleware.js`)
