# suhilyahia/jawahiralreem architecture

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

- Interactive diagram: https://gitdiagram.com/suhilyahia/jawahiralreem
- Repository: https://github.com/suhilyahia/jawahiralreem

## Overview

Jawahir Alreem is a bilingual, multi-page brand and product showcase for a Saudi cosmetics manufacturer. Visitors navigate from the shared site shell to brand-history, product-catalog, category, comparison/quality, and contact experiences; catalog browsing supports search, filtering, sorting, quick views, and WhatsApp ordering. The graph reflects documented capabilities and relationships visible in the provided excerpts and SOURCE INDEX; unsampled modules are represented only at the level supported by the tree and README.

Main entry points: [`src/App.jsx`](https://github.com/suhilyahia/jawahiralreem/blob/main/src/App.jsx) (Page Router), [`src/pages/sections`](https://github.com/suhilyahia/jawahiralreem/tree/main/src/pages/sections) (Home Sections), [`src/pages/ProductsPage.jsx`](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/ProductsPage.jsx) (Product Catalog), [`src/components/ui/ProductCard.jsx`](https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/ui/ProductCard.jsx) (Product Cards and Preview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site and Routing"]
  node_router["Page Router<br/>[App.jsx]"]
  node_site_shell["Site Shell<br/>[Layout.jsx]"]
  node_not_found["Not Found Page<br/>[NotFoundPage.jsx]"]
end

subgraph group_experience["Brand Experiences"]
  node_home["Home Page<br/>[HomePage.jsx]"]
  node_home_sections["Home Sections"]
  node_about["About and History<br/>[AboutPage.jsx]"]
  node_why_us["Quality and Comparison<br/>[WhyUsPage.jsx]"]
end

subgraph group_catalog["Catalog and Contact"]
  node_categories["Category Showcase<br/>[CategoriesPage.jsx]"]
  node_products["Product Catalog<br/>[ProductsPage.jsx]"]
  node_contact["Contact Page<br/>[ContactPage.jsx]"]
end

subgraph group_shared["Shared Content and UI"]
  node_language["Language and Direction"]
  node_product_data["Product Data<br/>[products.js]"]
  node_category_data["Category Data<br/>[categories.js]"]
  node_feature_data["Features and Reviews<br/>[features.js]"]
  node_history_data["Timeline and Values<br/>[timeline.js]"]
  node_faq_data["FAQ Data<br/>[faq.js]"]
  node_product_ui["Product Cards and Preview<br/>[ProductCard.jsx]"]
  node_contact_form["Contact Form<br/>[ContactForm.jsx]"]
  node_site_config["Site Configuration<br/>[site.js]"]
end

node_visitor(("Visitor"))
node_store{{"Official Store"}}
node_whatsapp{{"WhatsApp"}}

node_visitor -->|"opens pages"| node_router
node_router -->|"wraps routes"| node_site_shell
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_about
node_router -->|"routes to"| node_products
node_router -->|"routes to"| node_categories
node_router -->|"routes to"| node_why_us
node_router -->|"routes to"| node_contact
node_router -->|"routes fallback"| node_not_found
node_home -->|"renders sections"| node_home_sections
node_home -->|"uses FAQs"| node_faq_data
node_about -->|"reads timeline"| node_history_data
node_about -->|"reads details"| node_site_config
node_home_sections -->|"reads products"| node_product_data
node_home_sections -->|"reads features"| node_feature_data
node_home_sections -->|"renders cards"| node_product_ui
node_products -->|"reads products"| node_product_data
node_products -->|"renders cards"| node_product_ui
node_categories -->|"reads categories"| node_category_data
node_categories -->|"reads products"| node_product_data
node_why_us -->|"reads content"| node_feature_data
node_contact -->|"reads FAQs"| node_faq_data
node_contact -->|"renders form"| node_contact_form
node_product_ui -.->|"links to store"| node_store
node_product_ui -.->|"offers ordering"| node_whatsapp
node_contact_form -.->|"sends inquiry"| node_whatsapp
node_site_shell -.->|"provides language"| node_language
node_products -.->|"supports bilingual UI"| node_language

click node_router "https://github.com/suhilyahia/jawahiralreem/blob/main/src/App.jsx"
click node_site_shell "https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/layout/Layout.jsx"
click node_home "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/HomePage.jsx"
click node_home_sections "https://github.com/suhilyahia/jawahiralreem/tree/main/src/pages/sections"
click node_about "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/AboutPage.jsx"
click node_why_us "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/WhyUsPage.jsx"
click node_categories "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/CategoriesPage.jsx"
click node_products "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/ProductsPage.jsx"
click node_contact "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/ContactPage.jsx"
click node_not_found "https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/NotFoundPage.jsx"
click node_language "https://github.com/suhilyahia/jawahiralreem/blob/main/src/context/LanguageContext.jsx"
click node_product_data "https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/products.js"
click node_category_data "https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/categories.js"
click node_feature_data "https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/features.js"
click node_history_data "https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/timeline.js"
click node_faq_data "https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/faq.js"
click node_product_ui "https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/ui/ProductCard.jsx"
click node_contact_form "https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/ui/ContactForm.jsx"
click node_site_config "https://github.com/suhilyahia/jawahiralreem/blob/main/src/config/site.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_router,node_site_shell,node_not_found toneBlue
class node_home,node_home_sections,node_about,node_why_us toneAmber
class node_categories,node_products,node_contact toneMint
class node_language,node_product_data,node_category_data,node_feature_data,node_history_data,node_faq_data,node_product_ui,node_contact_form,node_site_config toneRose
class node_visitor,node_store,node_whatsapp toneIndigo
```

## Components

### Site and Routing

- [Page Router](https://github.com/suhilyahia/jawahiralreem/blob/main/src/App.jsx): `src/App.jsx`
- [Site Shell](https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/layout/Layout.jsx): `src/components/layout/Layout.jsx`
- [Not Found Page](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/NotFoundPage.jsx): `src/pages/NotFoundPage.jsx`

### Brand Experiences

- [Home Page](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Home Sections](https://github.com/suhilyahia/jawahiralreem/tree/main/src/pages/sections): `src/pages/sections`
- [About and History](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/AboutPage.jsx): `src/pages/AboutPage.jsx`
- [Quality and Comparison](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/WhyUsPage.jsx): `src/pages/WhyUsPage.jsx`

### Catalog and Contact

- [Category Showcase](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/CategoriesPage.jsx): `src/pages/CategoriesPage.jsx`
- [Product Catalog](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/ProductsPage.jsx): `src/pages/ProductsPage.jsx`
- [Contact Page](https://github.com/suhilyahia/jawahiralreem/blob/main/src/pages/ContactPage.jsx): `src/pages/ContactPage.jsx`

### Shared Content and UI

- [Language and Direction](https://github.com/suhilyahia/jawahiralreem/blob/main/src/context/LanguageContext.jsx): `src/context/LanguageContext.jsx`
- [Product Data](https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/products.js): `src/data/products.js`
- [Category Data](https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/categories.js): `src/data/categories.js`
- [Features and Reviews](https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/features.js): `src/data/features.js`
- [Timeline and Values](https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/timeline.js): `src/data/timeline.js`
- [FAQ Data](https://github.com/suhilyahia/jawahiralreem/blob/main/src/data/faq.js): `src/data/faq.js`
- [Product Cards and Preview](https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/ui/ProductCard.jsx): `src/components/ui/ProductCard.jsx`
- [Contact Form](https://github.com/suhilyahia/jawahiralreem/blob/main/src/components/ui/ContactForm.jsx): `src/components/ui/ContactForm.jsx`
- [Site Configuration](https://github.com/suhilyahia/jawahiralreem/blob/main/src/config/site.js): `src/config/site.js`

### Other components

- **Visitor**
- **Official Store**
- **WhatsApp**

## Connections

- Visitor → Page Router: opens pages (evidence: `src/App.jsx`)
- Page Router → Site Shell: wraps routes (evidence: `src/App.jsx`)
- Page Router → Home Page: routes to (evidence: `src/App.jsx`)
- Page Router → About and History: routes to (evidence: `src/App.jsx`)
- Page Router → Product Catalog: routes to (evidence: `src/App.jsx`)
- Page Router → Category Showcase: routes to (evidence: `src/App.jsx`)
- Page Router → Quality and Comparison: routes to (evidence: `src/App.jsx`)
- Page Router → Contact Page: routes to (evidence: `src/App.jsx`)
- Page Router → Not Found Page: routes fallback (evidence: `src/App.jsx`)
- Home Page → Home Sections: renders sections (evidence: `src/pages/HomePage.jsx`)
- Home Page → FAQ Data: uses FAQs (evidence: `src/pages/HomePage.jsx`)
- About and History → Timeline and Values: reads timeline (evidence: `src/pages/AboutPage.jsx`)
- About and History → Site Configuration: reads details (evidence: `src/pages/AboutPage.jsx`)
- Home Sections → Product Data: reads products (evidence: `src/pages/sections/ProductsSection.jsx`)
- Home Sections → Features and Reviews: reads features (evidence: `src/pages/sections/WhyUsSection.jsx`)
- Home Sections → Product Cards and Preview: renders cards (evidence: `src/pages/sections/ProductsSection.jsx`)
- Product Catalog → Product Data: reads products (evidence: `src/pages/ProductsPage.jsx`)
- Product Catalog → Product Cards and Preview: renders cards (evidence: `src/pages/ProductsPage.jsx`)
- Category Showcase → Category Data: reads categories (evidence: `src/pages/CategoriesPage.jsx`)
- Category Showcase → Product Data: reads products (evidence: `src/pages/CategoriesPage.jsx`)
- Quality and Comparison → Features and Reviews: reads content (evidence: `src/pages/WhyUsPage.jsx`)
- Contact Page → FAQ Data: reads FAQs (evidence: `src/pages/ContactPage.jsx`)
- Contact Page → Contact Form: renders form (evidence: `src/pages/ContactPage.jsx`)
- Product Cards and Preview → Official Store: links to store (evidence: `README.md`)
- Product Cards and Preview → WhatsApp: offers ordering (evidence: `README.md`)
- Contact Form → WhatsApp: sends inquiry (evidence: `README.md`)
- Site Shell → Language and Direction: provides language (evidence: `README.md`)
- Product Catalog → Language and Direction: supports bilingual UI (evidence: `README.md`)
