# mr-ahad-khan/blinkit-clone-2 architecture

> Architecture diagram of the GitHub repository mr-ahad-khan/blinkit-clone-2, 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/mr-ahad-khan/blinkit-clone-2
- Repository: https://github.com/mr-ahad-khan/blinkit-clone-2

## Overview

Blinkit Clone combines a customer grocery storefront, an Express/Mongoose API, and a separate product-admin interface. The customer journey runs from browsing and product selection through a locally persisted cart, checkout, payment, and order confirmation; authentication gates shopping routes. The backend exposes domain APIs backed by MongoDB, while admins manage products through their own panel. The README documents the overall client/API/database links and shopping flow; source excerpts show selected routing, cart, controller, and persistence details, so unsampled domain wiring is not inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/App.jsx) (Storefront routes), [`backend/Routes/apiRoutes.js`](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Routes/apiRoutes.js) (Domain routes), [`frontend/src/api.js`](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/api.js) (API client), [`frontend/src/Pages/ProductDetails.jsx`](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/ProductDetails.jsx) (Product details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer storefront"]
  node_frontend_app["Storefront routes<br/>[App.jsx]"]
  node_home["Home browsing<br/>[Home.jsx]"]
  node_catalog_ui["Product discovery UI<br/>[ProductCards.jsx]"]
  node_product_detail["Product details<br/>[ProductDetails.jsx]"]
  node_cart_state[("Cart state<br/>[useCart.js]")]
  node_cart_page["Cart review<br/>[MyCart.jsx]"]
  node_checkout["Checkout<br/>[CheckoutPage.jsx]"]
  node_payment["Payment page<br/>[PaymentPage.jsx]"]
  node_order_success["Order confirmation<br/>[OrderSuccess.jsx]"]
  node_login["Customer login<br/>[Loginpage.jsx]"]
  node_frontend_api["API client<br/>[api.js]"]
end

subgraph group_backend["API and persistence"]
  node_backend_server["Express server<br/>[Server.js]"]
  node_api_routes["Domain routes<br/>[apiRoutes.js]"]
  node_customer_controller["Customer handlers"]
  node_product_controller["Product handlers"]
  node_order_controller["Order handlers<br/>[OrderController.js]"]
  node_payment_controller["Payment handlers"]
  node_admin_controller["Admin handlers<br/>[AdminController.js]"]
  node_crud_controller["CRUD logic<br/>[crudController.js]"]
  node_mongo_models["Mongoose models"]
  node_mongo_config["Mongo connection<br/>[db.js]"]
end

subgraph group_admin["Product administration"]
  node_admin_app["Admin application<br/>[App.jsx]"]
  node_admin_products["Product management<br/>[Allproduct.jsx]"]
  node_admin_add["Add product<br/>[Addproduct.jsx]"]
  node_admin_api["Admin API client<br/>[Api.js]"]
end

node_shopper(("Customer"))
node_mongodb[("MongoDB")]
node_admin_user(("Administrator"))

node_shopper -->|"uses"| node_frontend_app
node_frontend_app -->|"routes to"| node_home
node_frontend_app -->|"routes to"| node_product_detail
node_frontend_app -->|"routes to"| node_cart_page
node_frontend_app -->|"routes to"| node_checkout
node_frontend_app -->|"routes to"| node_payment
node_frontend_app -->|"routes to"| node_order_success
node_frontend_app -->|"routes to"| node_login
node_home -->|"renders"| node_catalog_ui
node_catalog_ui -.->|"selects product"| node_product_detail
node_product_detail -->|"updates"| node_cart_state
node_cart_page -->|"reads and updates"| node_cart_state
node_checkout -->|"reads"| node_cart_state
node_payment -->|"reads"| node_cart_state
node_login -->|"calls"| node_frontend_api
node_product_detail -->|"calls"| node_frontend_api
node_checkout -->|"calls"| node_frontend_api
node_payment -->|"calls"| node_frontend_api
node_frontend_api -->|"sends API requests"| node_backend_server
node_backend_server -.->|"mounts domain routes"| node_api_routes
node_api_routes -->|"dispatches"| node_customer_controller
node_api_routes -->|"dispatches"| node_product_controller
node_api_routes -->|"dispatches"| node_order_controller
node_api_routes -->|"dispatches"| node_payment_controller
node_api_routes -->|"dispatches"| node_admin_controller
node_customer_controller -->|"uses CRUD logic"| node_crud_controller
node_admin_controller -->|"uses CRUD logic"| node_crud_controller
node_payment_controller -->|"uses CRUD logic"| node_crud_controller
node_crud_controller -->|"operates on model"| node_mongo_models
node_customer_controller -->|"queries customer model"| node_mongo_models
node_admin_controller -->|"queries admin model"| node_mongo_models
node_mongo_models -->|"uses connection"| node_mongo_config
node_mongo_config -->|"connects"| node_mongodb
node_admin_user -->|"uses"| node_admin_app
node_admin_app -->|"routes to"| node_admin_products
node_admin_app -->|"routes to"| node_admin_add
node_admin_products -->|"calls"| node_admin_api
node_admin_add -->|"calls"| node_admin_api
node_admin_api -->|"sends API requests"| node_backend_server

click node_frontend_app "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/Home.jsx"
click node_catalog_ui "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Components/ProductCards.jsx"
click node_product_detail "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/ProductDetails.jsx"
click node_cart_state "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/hooks/useCart.js"
click node_cart_page "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/MyCart.jsx"
click node_checkout "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/CheckoutPage.jsx"
click node_payment "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/PaymentPage.jsx"
click node_order_success "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/OrderSuccess.jsx"
click node_login "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/Loginpage.jsx"
click node_frontend_api "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/api.js"
click node_backend_server "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Server.js"
click node_api_routes "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Routes/apiRoutes.js"
click node_customer_controller "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/CustomerController.js"
click node_product_controller "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/ProductController.js"
click node_order_controller "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/OrderController.js"
click node_payment_controller "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/PaymentController.js"
click node_admin_controller "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/AdminController.js"
click node_crud_controller "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/crudController.js"
click node_mongo_models "https://github.com/mr-ahad-khan/blinkit-clone-2/tree/main/backend/Models"
click node_mongo_config "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Config/db.js"
click node_admin_app "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/App.jsx"
click node_admin_products "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/Pages/Allproduct.jsx"
click node_admin_add "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/Pages/Addproduct.jsx"
click node_admin_api "https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/Pages/Api.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_frontend_app,node_home,node_catalog_ui,node_product_detail,node_cart_state,node_cart_page,node_checkout,node_payment,node_order_success,node_login,node_frontend_api toneBlue
class node_backend_server,node_api_routes,node_customer_controller,node_product_controller,node_order_controller,node_payment_controller,node_admin_controller,node_crud_controller,node_mongo_models,node_mongo_config,node_mongodb toneAmber
class node_admin_app,node_admin_products,node_admin_add,node_admin_api toneMint
class node_shopper,node_admin_user toneIndigo
```

## Components

### Customer storefront

- [Storefront routes](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home browsing](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/Home.jsx): `frontend/src/Pages/Home.jsx`
- [Product discovery UI](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Components/ProductCards.jsx): `frontend/src/Components/ProductCards.jsx`
- [Product details](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/ProductDetails.jsx): `frontend/src/Pages/ProductDetails.jsx`
- [Cart state](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/hooks/useCart.js): `frontend/src/hooks/useCart.js`
- [Cart review](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/MyCart.jsx): `frontend/src/Pages/MyCart.jsx`
- [Checkout](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/CheckoutPage.jsx): `frontend/src/Pages/CheckoutPage.jsx`
- [Payment page](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/PaymentPage.jsx): `frontend/src/Pages/PaymentPage.jsx`
- [Order confirmation](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/OrderSuccess.jsx): `frontend/src/Pages/OrderSuccess.jsx`
- [Customer login](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/Pages/Loginpage.jsx): `frontend/src/Pages/Loginpage.jsx`
- [API client](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/frontend/src/api.js): `frontend/src/api.js`

### API and persistence

- [Express server](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Server.js): `backend/Server.js`
- [Domain routes](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Routes/apiRoutes.js): `backend/Routes/apiRoutes.js`
- [Customer handlers](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/CustomerController.js): `backend/Controllers/CustomerController.js`
- [Product handlers](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/ProductController.js): `backend/Controllers/ProductController.js`
- [Order handlers](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/OrderController.js): `backend/Controllers/OrderController.js`
- [Payment handlers](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/PaymentController.js): `backend/Controllers/PaymentController.js`
- [Admin handlers](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/AdminController.js): `backend/Controllers/AdminController.js`
- [CRUD logic](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Controllers/crudController.js): `backend/Controllers/crudController.js`
- [Mongoose models](https://github.com/mr-ahad-khan/blinkit-clone-2/tree/main/backend/Models): `backend/Models`
- [Mongo connection](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/backend/Config/db.js): `backend/Config/db.js`

### Product administration

- [Admin application](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/App.jsx): `adminpanel/src/App.jsx`
- [Product management](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/Pages/Allproduct.jsx): `adminpanel/src/Pages/Allproduct.jsx`
- [Add product](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/Pages/Addproduct.jsx): `adminpanel/src/Pages/Addproduct.jsx`
- [Admin API client](https://github.com/mr-ahad-khan/blinkit-clone-2/blob/main/adminpanel/src/Pages/Api.js): `adminpanel/src/Pages/Api.js`

### Other components

- **Customer**
- **MongoDB**
- **Administrator**

## Connections

- Customer → Storefront routes: uses (evidence: `README.md`)
- Storefront routes → Home browsing: routes to (evidence: `frontend/src/App.jsx`)
- Storefront routes → Product details: routes to (evidence: `frontend/src/App.jsx`)
- Storefront routes → Cart review: routes to (evidence: `frontend/src/App.jsx`)
- Storefront routes → Checkout: routes to (evidence: `frontend/src/App.jsx`)
- Storefront routes → Payment page: routes to (evidence: `frontend/src/App.jsx`)
- Storefront routes → Order confirmation: routes to (evidence: `frontend/src/App.jsx`)
- Storefront routes → Customer login: routes to (evidence: `frontend/src/App.jsx`)
- Home browsing → Product discovery UI: renders (evidence: `frontend/src/Pages/Home.jsx`)
- Product discovery UI → Product details: selects product
- Product details → Cart state: updates (evidence: `frontend/src/Pages/ProductDetails.jsx`)
- Cart review → Cart state: reads and updates (evidence: `frontend/src/Pages/MyCart.jsx`)
- Checkout → Cart state: reads (evidence: `frontend/src/Pages/CheckoutPage.jsx`)
- Payment page → Cart state: reads (evidence: `frontend/src/Pages/PaymentPage.jsx`)
- Customer login → API client: calls (evidence: `frontend/src/Pages/Loginpage.jsx`)
- Product details → API client: calls (evidence: `frontend/src/Pages/ProductDetails.jsx`)
- Checkout → API client: calls (evidence: `frontend/src/Pages/CheckoutPage.jsx`)
- Payment page → API client: calls (evidence: `frontend/src/Pages/PaymentPage.jsx`)
- API client → Express server: sends API requests (evidence: `README.md`)
- Express server → Domain routes: mounts domain routes
- Domain routes → Customer handlers: dispatches (evidence: `backend/Routes/apiRoutes.js`)
- Domain routes → Product handlers: dispatches (evidence: `backend/Routes/apiRoutes.js`)
- Domain routes → Order handlers: dispatches (evidence: `backend/Routes/apiRoutes.js`)
- Domain routes → Payment handlers: dispatches (evidence: `backend/Routes/apiRoutes.js`)
- Domain routes → Admin handlers: dispatches (evidence: `backend/Routes/apiRoutes.js`)
- Customer handlers → CRUD logic: uses CRUD logic (evidence: `backend/Controllers/CustomerController.js`)
- Admin handlers → CRUD logic: uses CRUD logic (evidence: `backend/Controllers/AdminController.js`)
- Payment handlers → CRUD logic: uses CRUD logic (evidence: `backend/Controllers/PaymentController.js`)
- CRUD logic → Mongoose models: operates on model (evidence: `backend/Controllers/crudController.js`)
- Customer handlers → Mongoose models: queries customer model (evidence: `backend/Controllers/CustomerController.js`)
- Admin handlers → Mongoose models: queries admin model (evidence: `backend/Controllers/AdminController.js`)
- Mongoose models → Mongo connection: uses connection (evidence: `backend/Models/CustomerModels.js`)
- Mongo connection → MongoDB: connects (evidence: `backend/Config/db.js`)
- Administrator → Admin application: uses (evidence: `README.md`)
- Admin application → Product management: routes to (evidence: `adminpanel/src/App.jsx`)
- Admin application → Add product: routes to (evidence: `adminpanel/src/App.jsx`)
- Product management → Admin API client: calls (evidence: `adminpanel/src/Pages/Allproduct.jsx`)
- Add product → Admin API client: calls (evidence: `adminpanel/src/Pages/Addproduct.jsx`)
- Admin API client → Express server: sends API requests (evidence: `README.md`)
