# saipavan0097/lumora-jewels architecture

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

- Interactive diagram: https://gitdiagram.com/saipavan0097/lumora-jewels
- Repository: https://github.com/saipavan0097/lumora-jewels

## Overview

Lumora is a jewelry storefront and atelier showcase implemented as a React front end. Visitors can browse the homepage and handmade-piece gallery, search atelier pieces, and enquire through WhatsApp; separate shop components implement product discovery, cart, wishlist, and checkout interactions. The sampled App routes `/shop` to AtelierGallery, while the source index shows the commerce components’ internal dependencies but does not establish that they are mounted by App. The README gives no further capability or deployment details.

Main entry points: [`src/App.tsx`](https://github.com/saipavan0097/lumora-jewels/blob/main/src/App.tsx) (App Router), [`src/data/products.ts`](https://github.com/saipavan0097/lumora-jewels/blob/main/src/data/products.ts) (Product Catalog), [`src/components/shop/ProductCard.tsx`](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ProductCard.tsx) (Product Card), [`src/components/shop/QuickView.tsx`](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/QuickView.tsx) (Quick View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Storefront"]
  node_app["App Router<br/>[App.tsx]"]
  node_navbar["Navigation &amp; Search<br/>[Navbar.tsx]"]
  node_hero["Homepage Sections<br/>[Hero.tsx]"]
  node_appointments["Appointment Form"]
  node_contact["Contact &amp; FAQ<br/>[Contact.tsx]"]
  node_footer["Footer &amp; Actions<br/>[Footer.tsx]"]
end

subgraph group_atelier["Atelier Showcase"]
  node_gallery["Handmade Gallery<br/>[AtelierGallery.tsx]"]
  node_atelierdata["Atelier Pieces<br/>[atelier.ts]"]
end

subgraph group_commerce["Product Commerce"]
  node_shop["Shop Browsing<br/>[ShopPage.tsx]"]
  node_productpage["Product Details<br/>[ProductPage.tsx]"]
  node_productcard["Product Card<br/>[ProductCard.tsx]"]
  node_quickview["Quick View<br/>[QuickView.tsx]"]
  node_cart["Cart Drawer<br/>[CartDrawer.tsx]"]
  node_checkout["Checkout<br/>[CheckoutPage.tsx]"]
  node_shopstate["Cart &amp; Wishlist State<br/>[ShopContext.tsx]"]
  node_productdata["Product Catalog<br/>[products.ts]"]
end

subgraph group_shared["Shared UI"]
  node_reveal["Reveal Animation<br/>[Reveal.tsx]"]
  node_revealhook["Visibility Hook<br/>[useReveal.ts]"]
end

node_visitor(("Visitor"))
node_whatsapp(("WhatsApp"))

node_visitor -->|"opens site"| node_app
node_app -->|"renders navigation"| node_navbar
node_app -->|"renders homepage"| node_hero
node_app -->|"renders form"| node_appointments
node_app -->|"renders contact"| node_contact
node_app -->|"renders footer"| node_footer
node_app -->|"renders shop route"| node_gallery
node_navbar -->|"searches pieces"| node_atelierdata
node_gallery -->|"reads pieces"| node_atelierdata
node_gallery -->|"opens enquiry"| node_whatsapp
node_shop -->|"renders cards"| node_productcard
node_shop -->|"opens quick view"| node_quickview
node_shop -->|"reads catalog"| node_productdata
node_productpage -->|"renders related"| node_productcard
node_productpage -->|"opens quick view"| node_quickview
node_productpage -->|"loads product"| node_productdata
node_productcard -->|"updates cart"| node_shopstate
node_productcard -->|"formats price"| node_productdata
node_quickview -->|"updates cart"| node_shopstate
node_quickview -->|"formats price"| node_productdata
node_cart -->|"reads cart"| node_shopstate
node_cart -->|"uses products"| node_productdata
node_checkout -->|"uses cart"| node_shopstate
node_checkout -->|"uses products"| node_productdata
node_reveal -->|"observes visibility"| node_revealhook

click node_app "https://github.com/saipavan0097/lumora-jewels/blob/main/src/App.tsx"
click node_navbar "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Navbar.tsx"
click node_hero "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Hero.tsx"
click node_appointments "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/AppointmentForm.tsx"
click node_contact "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Contact.tsx"
click node_footer "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Footer.tsx"
click node_gallery "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/AtelierGallery.tsx"
click node_atelierdata "https://github.com/saipavan0097/lumora-jewels/blob/main/src/data/atelier.ts"
click node_shop "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ShopPage.tsx"
click node_productpage "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ProductPage.tsx"
click node_productcard "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ProductCard.tsx"
click node_quickview "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/QuickView.tsx"
click node_cart "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/CartDrawer.tsx"
click node_checkout "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/CheckoutPage.tsx"
click node_shopstate "https://github.com/saipavan0097/lumora-jewels/blob/main/src/context/ShopContext.tsx"
click node_productdata "https://github.com/saipavan0097/lumora-jewels/blob/main/src/data/products.ts"
click node_reveal "https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Reveal.tsx"
click node_revealhook "https://github.com/saipavan0097/lumora-jewels/blob/main/src/hooks/useReveal.ts"

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_hero,node_appointments,node_contact,node_footer toneBlue
class node_gallery,node_atelierdata toneAmber
class node_shop,node_productpage,node_productcard,node_quickview,node_cart,node_checkout,node_shopstate,node_productdata toneMint
class node_reveal,node_revealhook toneRose
class node_visitor,node_whatsapp toneIndigo
```

## Components

### Storefront

- [App Router](https://github.com/saipavan0097/lumora-jewels/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation & Search](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Homepage Sections](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Appointment Form](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/AppointmentForm.tsx): `src/components/AppointmentForm.tsx`
- [Contact & FAQ](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Contact.tsx): `src/components/Contact.tsx`
- [Footer & Actions](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`

### Atelier Showcase

- [Handmade Gallery](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/AtelierGallery.tsx): `src/components/AtelierGallery.tsx`
- [Atelier Pieces](https://github.com/saipavan0097/lumora-jewels/blob/main/src/data/atelier.ts): `src/data/atelier.ts`

### Product Commerce

- [Shop Browsing](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ShopPage.tsx): `src/components/shop/ShopPage.tsx`
- [Product Details](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ProductPage.tsx): `src/components/shop/ProductPage.tsx`
- [Product Card](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/ProductCard.tsx): `src/components/shop/ProductCard.tsx`
- [Quick View](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/QuickView.tsx): `src/components/shop/QuickView.tsx`
- [Cart Drawer](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/CartDrawer.tsx): `src/components/shop/CartDrawer.tsx`
- [Checkout](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/shop/CheckoutPage.tsx): `src/components/shop/CheckoutPage.tsx`
- [Cart & Wishlist State](https://github.com/saipavan0097/lumora-jewels/blob/main/src/context/ShopContext.tsx): `src/context/ShopContext.tsx`
- [Product Catalog](https://github.com/saipavan0097/lumora-jewels/blob/main/src/data/products.ts): `src/data/products.ts`

### Shared UI

- [Reveal Animation](https://github.com/saipavan0097/lumora-jewels/blob/main/src/components/Reveal.tsx): `src/components/Reveal.tsx`
- [Visibility Hook](https://github.com/saipavan0097/lumora-jewels/blob/main/src/hooks/useReveal.ts): `src/hooks/useReveal.ts`

### Other components

- **Visitor**
- **WhatsApp**

## Connections

- Visitor → App Router: opens site
- App Router → Navigation & Search: renders navigation (evidence: `src/App.tsx`)
- App Router → Homepage Sections: renders homepage (evidence: `src/App.tsx`)
- App Router → Appointment Form: renders form (evidence: `src/App.tsx`)
- App Router → Contact & FAQ: renders contact (evidence: `src/App.tsx`)
- App Router → Footer & Actions: renders footer (evidence: `src/App.tsx`)
- App Router → Handmade Gallery: renders shop route (evidence: `src/App.tsx`)
- Navigation & Search → Atelier Pieces: searches pieces (evidence: `src/components/Navbar.tsx`)
- Handmade Gallery → Atelier Pieces: reads pieces (evidence: `src/components/AtelierGallery.tsx`)
- Handmade Gallery → WhatsApp: opens enquiry (evidence: `src/components/AtelierGallery.tsx`)
- Shop Browsing → Product Card: renders cards (evidence: `src/components/shop/ShopPage.tsx`)
- Shop Browsing → Quick View: opens quick view (evidence: `src/components/shop/ShopPage.tsx`)
- Shop Browsing → Product Catalog: reads catalog (evidence: `src/components/shop/ShopPage.tsx`)
- Product Details → Product Card: renders related (evidence: `src/components/shop/ProductPage.tsx`)
- Product Details → Quick View: opens quick view (evidence: `src/components/shop/ProductPage.tsx`)
- Product Details → Product Catalog: loads product (evidence: `src/components/shop/ProductPage.tsx`)
- Product Card → Cart & Wishlist State: updates cart (evidence: `src/components/shop/ProductCard.tsx`)
- Product Card → Product Catalog: formats price (evidence: `src/components/shop/ProductCard.tsx`)
- Quick View → Cart & Wishlist State: updates cart (evidence: `src/components/shop/QuickView.tsx`)
- Quick View → Product Catalog: formats price (evidence: `src/components/shop/QuickView.tsx`)
- Cart Drawer → Cart & Wishlist State: reads cart (evidence: `src/components/shop/CartDrawer.tsx`)
- Cart Drawer → Product Catalog: uses products (evidence: `src/components/shop/CartDrawer.tsx`)
- Checkout → Cart & Wishlist State: uses cart (evidence: `src/components/shop/CheckoutPage.tsx`)
- Checkout → Product Catalog: uses products (evidence: `src/components/shop/CheckoutPage.tsx`)
- Reveal Animation → Visibility Hook: observes visibility (evidence: `src/components/Reveal.tsx`)
