# ujas-goti/cs351-project2-coolmugs architecture

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

- Interactive diagram: https://gitdiagram.com/ujas-goti/cs351-project2-coolmugs
- Repository: https://github.com/ujas-goti/cs351-project2-coolmugs

## Overview

Cool Mugs is a React storefront backed by an Express API and MongoDB. The main customer journey runs from browsing products through cart management and checkout to saved order history; account creation, login, and profile editing support that journey. The graph also shows the storefront’s component layer and the API’s session and database responsibilities. Edges are limited to relationships visible in sampled source or explicitly described in the README; unsampled UI/API connections are omitted where not established.

Main entry points: [`client/src/App.jsx`](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/App.jsx) (App coordinator), [`server/server.js`](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/server.js) (Express server), [`server/routes/orderRoutes.js`](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/orderRoutes.js) (Order API), [`server/routes/accountRoutes.js`](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/accountRoutes.js) (Account API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront UI"]
  node_app["App coordinator<br/>[App.jsx]"]
  node_navbar["Navigation bar<br/>[navigationbar.jsx]"]
  node_home["Home storefront<br/>[Home.jsx]"]
  node_featured["Featured products"]
  node_shop["Shop catalog<br/>[Shop.jsx]"]
  node_productlist["Product list<br/>[productList.jsx]"]
  node_productcard["Product card<br/>[productCard.jsx]"]
  node_productdetail["Product details<br/>[ProductsDetail.jsx]"]
  node_cartview["Cart view<br/>[Cart.jsx]"]
  node_cartitem["Cart item<br/>[CartItem.jsx]"]
  node_checkout["Checkout form<br/>[Checkout.jsx]"]
  node_accountview["Account dashboard<br/>[Account.jsx]"]
  node_createaccount["Account creation<br/>[CreateAccount.jsx]"]
end

subgraph group_commerce["Commerce API"]
  node_productapi["Product API<br/>[productRoutes.js]"]
  node_cartapi["Cart API<br/>[cartRoutes.js]"]
  node_orderapi["Order API<br/>[orderRoutes.js]"]
end

subgraph group_identity["Accounts and sessions"]
  node_accountapi["Account API<br/>[accountRoutes.js]"]
  node_express["Express server<br/>[server.js]"]
  node_session[("Session state<br/>[server.js]")]
end

subgraph group_persistence["MongoDB data"]
  node_mongodb[("MongoDB Atlas")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_home
node_app -->|"renders"| node_shop
node_app -->|"renders"| node_productdetail
node_app -->|"renders"| node_cartview
node_app -->|"renders"| node_checkout
node_app -->|"renders"| node_accountview
node_app -->|"renders"| node_createaccount
node_home -->|"renders"| node_featured
node_featured -->|"renders"| node_productlist
node_shop -->|"renders"| node_productlist
node_productlist -->|"renders"| node_productcard
node_cartview -->|"renders"| node_cartitem
node_app -->|"fetches catalog"| node_productapi
node_app -->|"manages cart"| node_cartapi
node_checkout -->|"loads account"| node_accountapi
node_checkout -->|"submits order"| node_orderapi
node_accountview -->|"loads history"| node_orderapi
node_accountview -->|"edits profile"| node_accountapi
node_express -->|"mounts routes"| node_productapi
node_express -->|"mounts routes"| node_accountapi
node_express -->|"mounts routes"| node_cartapi
node_express -->|"mounts routes"| node_orderapi
node_express -->|"configures"| node_session
node_productapi -->|"reads products"| node_mongodb
node_cartapi -->|"looks up products"| node_mongodb
node_orderapi -->|"reads products, saves orders"| node_mongodb
node_accountapi -->|"reads and writes users"| node_mongodb
node_cartapi -->|"reads and writes cart"| node_session
node_orderapi -->|"reads and clears cart"| node_session
node_accountapi -->|"sets user session"| node_session

click node_app "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/App.jsx"
click node_navbar "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/navigationbar.jsx"
click node_home "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Home.jsx"
click node_featured "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/FeaturedProducts.jsx"
click node_shop "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Shop.jsx"
click node_productlist "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/productList.jsx"
click node_productcard "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/productCard.jsx"
click node_productdetail "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/ProductsDetail.jsx"
click node_cartview "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Cart.jsx"
click node_cartitem "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/CartItem.jsx"
click node_checkout "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Checkout.jsx"
click node_accountview "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Account.jsx"
click node_createaccount "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/CreateAccount.jsx"
click node_productapi "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/productRoutes.js"
click node_cartapi "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/cartRoutes.js"
click node_orderapi "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/orderRoutes.js"
click node_accountapi "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/accountRoutes.js"
click node_express "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/server.js"
click node_session "https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/server.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_navbar,node_home,node_featured,node_shop,node_productlist,node_productcard,node_productdetail,node_cartview,node_cartitem,node_checkout,node_accountview,node_createaccount toneBlue
class node_productapi,node_cartapi,node_orderapi toneAmber
class node_accountapi,node_express,node_session toneMint
class node_mongodb toneRose
class node_shopper toneIndigo
```

## Components

### Storefront UI

- [App coordinator](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Navigation bar](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/navigationbar.jsx): `client/src/components/navigationbar.jsx`
- [Home storefront](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Home.jsx): `client/src/views/Home.jsx`
- [Featured products](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/FeaturedProducts.jsx): `client/src/components/FeaturedProducts.jsx`
- [Shop catalog](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Shop.jsx): `client/src/views/Shop.jsx`
- [Product list](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/productList.jsx): `client/src/components/productList.jsx`
- [Product card](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/productCard.jsx): `client/src/components/productCard.jsx`
- [Product details](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/ProductsDetail.jsx): `client/src/views/ProductsDetail.jsx`
- [Cart view](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Cart.jsx): `client/src/views/Cart.jsx`
- [Cart item](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/components/CartItem.jsx): `client/src/components/CartItem.jsx`
- [Checkout form](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Checkout.jsx): `client/src/views/Checkout.jsx`
- [Account dashboard](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/Account.jsx): `client/src/views/Account.jsx`
- [Account creation](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/client/src/views/CreateAccount.jsx): `client/src/views/CreateAccount.jsx`

### Commerce API

- [Product API](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/productRoutes.js): `server/routes/productRoutes.js`
- [Cart API](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/cartRoutes.js): `server/routes/cartRoutes.js`
- [Order API](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/orderRoutes.js): `server/routes/orderRoutes.js`

### Accounts and sessions

- [Account API](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/routes/accountRoutes.js): `server/routes/accountRoutes.js`
- [Express server](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/server.js): `server/server.js`
- [Session state](https://github.com/ujas-goti/cs351-project2-coolmugs/blob/main/server/server.js): `server/server.js`

### MongoDB data

- **MongoDB Atlas**

### Other components

- **Shopper**

## Connections

- Shopper → App coordinator: uses
- App coordinator → Navigation bar: renders (evidence: `client/src/App.jsx`)
- App coordinator → Home storefront: renders (evidence: `client/src/App.jsx`)
- App coordinator → Shop catalog: renders (evidence: `client/src/App.jsx`)
- App coordinator → Product details: renders (evidence: `client/src/App.jsx`)
- App coordinator → Cart view: renders (evidence: `client/src/App.jsx`)
- App coordinator → Checkout form: renders (evidence: `client/src/App.jsx`)
- App coordinator → Account dashboard: renders (evidence: `client/src/App.jsx`)
- App coordinator → Account creation: renders (evidence: `client/src/App.jsx`)
- Home storefront → Featured products: renders (evidence: `client/src/views/Home.jsx`)
- Featured products → Product list: renders (evidence: `client/src/components/FeaturedProducts.jsx`)
- Shop catalog → Product list: renders (evidence: `client/src/views/Shop.jsx`)
- Product list → Product card: renders (evidence: `client/src/components/productList.jsx`)
- Cart view → Cart item: renders (evidence: `client/src/views/Cart.jsx`)
- App coordinator → Product API: fetches catalog (evidence: `client/src/App.jsx`)
- App coordinator → Cart API: manages cart (evidence: `client/src/App.jsx`)
- Checkout form → Account API: loads account (evidence: `client/src/views/Checkout.jsx`)
- Checkout form → Order API: submits order (evidence: `client/src/views/Checkout.jsx`)
- Account dashboard → Order API: loads history (evidence: `client/src/views/Account.jsx`)
- Account dashboard → Account API: edits profile (evidence: `client/src/views/Account.jsx`)
- Express server → Product API: mounts routes (evidence: `server/server.js`)
- Express server → Account API: mounts routes (evidence: `server/server.js`)
- Express server → Cart API: mounts routes (evidence: `server/server.js`)
- Express server → Order API: mounts routes (evidence: `server/server.js`)
- Express server → Session state: configures (evidence: `server/server.js`)
- Product API → MongoDB Atlas: reads products (evidence: `server/routes/productRoutes.js`)
- Cart API → MongoDB Atlas: looks up products (evidence: `server/routes/cartRoutes.js`)
- Order API → MongoDB Atlas: reads products, saves orders (evidence: `server/routes/orderRoutes.js`)
- Account API → MongoDB Atlas: reads and writes users (evidence: `server/routes/accountRoutes.js`)
- Cart API → Session state: reads and writes cart (evidence: `server/routes/cartRoutes.js`)
- Order API → Session state: reads and clears cart (evidence: `server/routes/orderRoutes.js`)
- Account API → Session state: sets user session (evidence: `server/routes/accountRoutes.js`)
