# vishakeaswar/flame-kart architecture

> Architecture diagram of the GitHub repository vishakeaswar/flame-kart, 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/vishakeaswar/flame-kart
- Repository: https://github.com/vishakeaswar/flame-kart

## Overview

Flame Kart is a React storefront. A shopper lands on the home page, searches or filters the catalog, opens a product, and can save it to a wishlist or cart; the cart supports quantity changes and totals. Product data is served from a bundled JSON file, while cart and wishlist state live in browser localStorage and custom events refresh navigation counts. The excerpts show these page-level interactions; checkout is only a button, with no checkout implementation evidenced.

Main entry points: [`src/App.js`](https://github.com/vishakeaswar/flame-kart/blob/master/src/App.js) (Route Shell), [`src/pages/HomePage.jsx`](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/HomePage.jsx) (Home & Search), [`src/pages/ProductPage.jsx`](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/ProductPage.jsx) (Product Listing), [`src/pages/ProductView.jsx`](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/ProductView.jsx) (Product Detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_entry["React Entry<br/>[index.js]"]
  node_routes["Route Shell<br/>[App.js]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_navbar["Navigation<br/>[NavBar.jsx]"]
end

subgraph group_catalog["Product Discovery"]
  node_home["Home &amp; Search<br/>[HomePage.jsx]"]
  node_listing["Product Listing<br/>[ProductPage.jsx]"]
  node_detail["Product Detail<br/>[ProductView.jsx]"]
  node_catalogdata["Product Catalog<br/>[products.json]"]
end

subgraph group_shopping["Saved Items &amp; Cart"]
  node_wishlist["Wishlist<br/>[WishlistPage.jsx]"]
  node_cart["Cart<br/>[CartPage.jsx]"]
  node_browserstore[("Browser Storage")]
end

node_shopper(("Shopper"))

node_shopper -->|"opens storefront"| node_entry
node_entry -->|"renders"| node_routes
node_routes -->|"routes home"| node_home
node_routes -->|"routes listing"| node_listing
node_routes -->|"routes wishlist"| node_wishlist
node_routes -->|"routes cart"| node_cart
node_routes -->|"routes detail"| node_detail
node_routes -->|"renders"| node_footer
node_home -->|"renders"| node_listing
node_home -->|"fetches categories"| node_catalogdata
node_listing -->|"navigates to"| node_detail
node_detail -->|"loads product"| node_catalogdata
node_listing -->|"reads/writes cart and wishlist"| node_browserstore
node_detail -->|"reads/writes cart and wishlist"| node_browserstore
node_cart -->|"reads/writes cart"| node_browserstore
node_wishlist -->|"reads/writes wishlist and cart"| node_browserstore
node_navbar -->|"reads counts"| node_browserstore
node_home -->|"navigates"| node_wishlist
node_home -->|"navigates"| node_cart
node_shopper -->|"searches catalog"| node_home

click node_entry "https://github.com/vishakeaswar/flame-kart/blob/master/src/index.js"
click node_routes "https://github.com/vishakeaswar/flame-kart/blob/master/src/App.js"
click node_footer "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/Footer.jsx"
click node_home "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/HomePage.jsx"
click node_listing "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/ProductPage.jsx"
click node_detail "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/ProductView.jsx"
click node_catalogdata "https://github.com/vishakeaswar/flame-kart/blob/master/public/products.json"
click node_navbar "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/NavBar.jsx"
click node_wishlist "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/WishlistPage.jsx"
click node_cart "https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/CartPage.jsx"

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_entry,node_routes,node_footer,node_navbar toneBlue
class node_home,node_listing,node_detail,node_catalogdata toneAmber
class node_wishlist,node_cart,node_browserstore toneMint
class node_shopper toneIndigo
```

## Components

### App Shell

- [React Entry](https://github.com/vishakeaswar/flame-kart/blob/master/src/index.js): `src/index.js`
- [Route Shell](https://github.com/vishakeaswar/flame-kart/blob/master/src/App.js): `src/App.js`
- [Footer](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/Footer.jsx): `src/pages/Footer.jsx`
- [Navigation](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/NavBar.jsx): `src/pages/NavBar.jsx`

### Product Discovery

- [Home & Search](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Product Listing](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/ProductPage.jsx): `src/pages/ProductPage.jsx`
- [Product Detail](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/ProductView.jsx): `src/pages/ProductView.jsx`
- [Product Catalog](https://github.com/vishakeaswar/flame-kart/blob/master/public/products.json): `public/products.json`

### Saved Items & Cart

- [Wishlist](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/WishlistPage.jsx): `src/pages/WishlistPage.jsx`
- [Cart](https://github.com/vishakeaswar/flame-kart/blob/master/src/pages/CartPage.jsx): `src/pages/CartPage.jsx`
- **Browser Storage**

### Other components

- **Shopper**

## Connections

- Shopper → React Entry: opens storefront (evidence: `src/index.js`)
- React Entry → Route Shell: renders (evidence: `src/index.js`)
- Route Shell → Home & Search: routes home (evidence: `src/App.js`)
- Route Shell → Product Listing: routes listing (evidence: `src/App.js`)
- Route Shell → Wishlist: routes wishlist (evidence: `src/App.js`)
- Route Shell → Cart: routes cart (evidence: `src/App.js`)
- Route Shell → Product Detail: routes detail (evidence: `src/App.js`)
- Route Shell → Footer: renders (evidence: `src/App.js`)
- Home & Search → Product Listing: renders (evidence: `src/pages/HomePage.jsx`)
- Home & Search → Product Catalog: fetches categories (evidence: `src/pages/HomePage.jsx`)
- Product Listing → Product Detail: navigates to (evidence: `src/pages/ProductPage.jsx`)
- Product Detail → Product Catalog: loads product (evidence: `src/pages/ProductView.jsx`)
- Product Listing → Browser Storage: reads/writes cart and wishlist (evidence: `src/pages/ProductPage.jsx`)
- Product Detail → Browser Storage: reads/writes cart and wishlist (evidence: `src/pages/ProductView.jsx`)
- Cart → Browser Storage: reads/writes cart (evidence: `src/pages/CartPage.jsx`)
- Wishlist → Browser Storage: reads/writes wishlist and cart (evidence: `src/pages/WishlistPage.jsx`)
- Navigation → Browser Storage: reads counts (evidence: `src/pages/NavBar.jsx`)
- Home & Search → Wishlist: navigates (evidence: `src/pages/HomePage.jsx`)
- Home & Search → Cart: navigates (evidence: `src/pages/HomePage.jsx`)
- Shopper → Home & Search: searches catalog (evidence: `src/pages/HomePage.jsx`)
