# emmanuel-kisakye/lulu-kaya architecture

> Architecture diagram of the GitHub repository emmanuel-kisakye/lulu-kaya, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emmanuel-kisakye/lulu-kaya
- Repository: https://github.com/emmanuel-kisakye/lulu-kaya

## Overview

Lulu Kaya is a perfume storefront and brand-information site. Visitors discover scents and product sizes, browse retail or wholesale offerings, and interact with an order form; the site also presents perfume education, business, loyalty, contact, location, and order-completion pages. The sampled code shows a Next.js page-and-component architecture with shared site data and client-side shopping interactions, but no server-side order processing or persistent commerce backend. Edges reflect imports and calls shown in excerpts or the source index; unsampled page behavior is not inferred.

Main entry points: [`app/shop/shop-mode-link.tsx`](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/shop-mode-link.tsx) (Shop mode link), [`app/site-data.json`](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-data.json) (Site data), [`app/page.tsx`](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/page.tsx) (Home page), [`app/signature-scent-carousel.tsx`](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/signature-scent-carousel.tsx) (Scent cards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and education"]
  node_home["Home page<br/>[page.tsx]"]
  node_hero["Hero navigation<br/>[hero-section.tsx]"]
  node_reviews["Client reviews<br/>[client-reviews.tsx]"]
  node_size_visualizer["Size visualizer"]
  node_scent_carousel["Scent cards"]
  node_image_card["Image overlay card"]
  node_perfume_guide["Perfume guide<br/>[page.tsx]"]
  node_guide_content["Guide content"]
end

subgraph group_commerce["Shopping and ordering"]
  node_shop_page["Shop page<br/>[page.tsx]"]
  node_order_form["Order form"]
  node_shop_mode["Shop mode link<br/>[shop-mode-link.tsx]"]
  node_order_complete["Order complete<br/>[page.tsx]"]
end

subgraph group_brand["Brand and support"]
  node_business["Business and wholesale<br/>[page.tsx]"]
  node_commission["Commission information<br/>[page.tsx]"]
  node_loyalty["Loyalty points<br/>[page.tsx]"]
  node_contact["Contact page<br/>[page.tsx]"]
  node_contact_form["Contact form<br/>[contact-form.tsx]"]
  node_location["Location page<br/>[page.tsx]"]
end

subgraph group_shared["Shared site shell"]
  node_layout["App layout<br/>[layout.tsx]"]
  node_header["Site header<br/>[site-header.tsx]"]
  node_footer["Site footer<br/>[site-footer.tsx]"]
  node_site_data["Site data<br/>[site-data.json]"]
end

node_visitor(("Visitor"))
node_maps["Google Maps"]

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_reviews
node_home -->|"renders"| node_size_visualizer
node_home -->|"renders"| node_scent_carousel
node_scent_carousel -->|"renders"| node_image_card
node_perfume_guide -->|"renders"| node_guide_content
node_perfume_guide -->|"uses type"| node_scent_carousel
node_guide_content -->|"renders"| node_scent_carousel
node_shop_page -->|"renders"| node_order_form
node_order_form -->|"renders"| node_scent_carousel
node_shop_page -->|"reads"| node_site_data
node_order_form -->|"listens for event"| node_shop_mode
node_visitor -->|"opens"| node_shop_page
node_visitor -->|"opens"| node_business
node_business -->|"renders"| node_shop_mode
node_business -->|"reads"| node_site_data
node_visitor -->|"opens"| node_commission
node_commission -->|"reads"| node_site_data
node_visitor -->|"opens"| node_loyalty
node_loyalty -->|"reads"| node_site_data
node_loyalty -->|"renders"| node_shop_mode
node_visitor -->|"opens"| node_contact
node_contact -->|"renders"| node_contact_form
node_contact -->|"reads"| node_site_data
node_visitor -->|"opens"| node_location
node_contact -->|"embeds"| node_maps
node_visitor -->|"opens"| node_order_complete
node_order_complete -->|"reads"| node_site_data
node_order_complete -->|"renders"| node_shop_mode
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_footer
node_header -->|"renders"| node_shop_mode
node_footer -->|"renders"| node_shop_mode

click node_home "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/page.tsx"
click node_hero "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/hero-section.tsx"
click node_reviews "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/client-reviews.tsx"
click node_size_visualizer "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/product-size-visualizer.tsx"
click node_scent_carousel "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/signature-scent-carousel.tsx"
click node_image_card "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/image-overlay-card.tsx"
click node_perfume_guide "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/know-your-perfume/page.tsx"
click node_guide_content "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/know-your-perfume/know-your-perfume-content.tsx"
click node_shop_page "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/page.tsx"
click node_order_form "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/shop-order-form.tsx"
click node_shop_mode "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/shop-mode-link.tsx"
click node_order_complete "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/order-complete/page.tsx"
click node_business "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/business/page.tsx"
click node_commission "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/commission/page.tsx"
click node_loyalty "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/loyalty-points/page.tsx"
click node_contact "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/contact/page.tsx"
click node_contact_form "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/contact/contact-form.tsx"
click node_location "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/location/page.tsx"
click node_layout "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/layout.tsx"
click node_header "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-header.tsx"
click node_footer "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-footer.tsx"
click node_site_data "https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-data.json"

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_home,node_hero,node_reviews,node_size_visualizer,node_scent_carousel,node_image_card,node_perfume_guide,node_guide_content toneBlue
class node_shop_page,node_order_form,node_shop_mode,node_order_complete toneAmber
class node_business,node_commission,node_loyalty,node_contact,node_contact_form,node_location toneMint
class node_layout,node_header,node_footer,node_site_data toneRose
class node_visitor,node_maps toneIndigo
```

## Components

### Discovery and education

- [Home page](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/page.tsx): `app/page.tsx`
- [Hero navigation](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/hero-section.tsx): `app/hero-section.tsx`
- [Client reviews](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/client-reviews.tsx): `app/client-reviews.tsx`
- [Size visualizer](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/product-size-visualizer.tsx): `app/product-size-visualizer.tsx`
- [Scent cards](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/signature-scent-carousel.tsx): `app/signature-scent-carousel.tsx`
- [Image overlay card](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/image-overlay-card.tsx): `app/image-overlay-card.tsx`
- [Perfume guide](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/know-your-perfume/page.tsx): `app/know-your-perfume/page.tsx`
- [Guide content](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/know-your-perfume/know-your-perfume-content.tsx): `app/know-your-perfume/know-your-perfume-content.tsx`

### Shopping and ordering

- [Shop page](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/page.tsx): `app/shop/page.tsx`
- [Order form](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/shop-order-form.tsx): `app/shop/shop-order-form.tsx`
- [Shop mode link](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/shop/shop-mode-link.tsx): `app/shop/shop-mode-link.tsx`
- [Order complete](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/order-complete/page.tsx): `app/order-complete/page.tsx`

### Brand and support

- [Business and wholesale](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/business/page.tsx): `app/business/page.tsx`
- [Commission information](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/commission/page.tsx): `app/commission/page.tsx`
- [Loyalty points](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/loyalty-points/page.tsx): `app/loyalty-points/page.tsx`
- [Contact page](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/contact/page.tsx): `app/contact/page.tsx`
- [Contact form](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/contact/contact-form.tsx): `app/contact/contact-form.tsx`
- [Location page](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/location/page.tsx): `app/location/page.tsx`

### Shared site shell

- [App layout](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/layout.tsx): `app/layout.tsx`
- [Site header](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-header.tsx): `app/site-header.tsx`
- [Site footer](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-footer.tsx): `app/site-footer.tsx`
- [Site data](https://github.com/emmanuel-kisakye/lulu-kaya/blob/main/app/site-data.json): `app/site-data.json`

### Other components

- **Visitor**
- **Google Maps**

## Connections

- Visitor → Home page: opens
- Home page → Hero navigation: renders (evidence: `app/page.tsx`)
- Home page → Client reviews: renders (evidence: `app/page.tsx`)
- Home page → Size visualizer: renders (evidence: `app/page.tsx`)
- Home page → Scent cards: renders (evidence: `app/page.tsx`)
- Scent cards → Image overlay card: renders (evidence: `app/signature-scent-carousel.tsx`)
- Perfume guide → Guide content: renders (evidence: `app/know-your-perfume/page.tsx`)
- Perfume guide → Scent cards: uses type (evidence: `app/know-your-perfume/page.tsx`)
- Guide content → Scent cards: renders (evidence: `app/know-your-perfume/know-your-perfume-content.tsx`)
- Shop page → Order form: renders (evidence: `app/shop/page.tsx`)
- Order form → Scent cards: renders (evidence: `app/shop/shop-order-form.tsx`)
- Shop page → Site data: reads (evidence: `app/shop/page.tsx`)
- Order form → Shop mode link: listens for event (evidence: `app/shop/shop-order-form.tsx`)
- Visitor → Shop page: opens
- Visitor → Business and wholesale: opens
- Business and wholesale → Shop mode link: renders (evidence: `app/business/page.tsx`)
- Business and wholesale → Site data: reads (evidence: `app/business/page.tsx`)
- Visitor → Commission information: opens
- Commission information → Site data: reads (evidence: `app/commission/page.tsx`)
- Visitor → Loyalty points: opens
- Loyalty points → Site data: reads (evidence: `app/loyalty-points/page.tsx`)
- Loyalty points → Shop mode link: renders (evidence: `app/loyalty-points/page.tsx`)
- Visitor → Contact page: opens
- Contact page → Contact form: renders (evidence: `app/contact/page.tsx`)
- Contact page → Site data: reads (evidence: `app/contact/page.tsx`)
- Visitor → Location page: opens
- Contact page → Google Maps: embeds (evidence: `app/contact/page.tsx`)
- Visitor → Order complete: opens
- Order complete → Site data: reads (evidence: `app/order-complete/page.tsx`)
- Order complete → Shop mode link: renders (evidence: `app/order-complete/page.tsx`)
- App layout → Site header: renders (evidence: `app/layout.tsx`)
- App layout → Site footer: renders (evidence: `app/layout.tsx`)
- Site header → Shop mode link: renders (evidence: `app/site-header.tsx`)
- Site footer → Shop mode link: renders (evidence: `app/site-footer.tsx`)
