# twinemukama/lucys-beauty-parlour-frontend architecture

> Architecture diagram of the GitHub repository twinemukama/lucys-beauty-parlour-frontend, 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/twinemukama/lucys-beauty-parlour-frontend
- Repository: https://github.com/twinemukama/lucys-beauty-parlour-frontend

## Overview

Lucy’s Beauty Parlour is a salon website with appointment booking, service and portfolio browsing, and an admin area for managing appointments and catalog content. A customer selects a service, checks availability, and submits a booking; staff review appointments and maintain menu and portfolio items. The map follows documented routes and sampled imports/calls. Several admin components and API modules are represented from the source index rather than inspected in full, so their internal behavior is kept at subsystem level.

Main entry points: [`src/pages/AdminDashboard.tsx`](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/AdminDashboard.tsx) (Admin dashboard), [`src/apis/bookings.ts`](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/bookings.ts) (Booking and admin API), [`src/App.tsx`](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/App.tsx) (React app and routes), [`src/pages/Index.tsx`](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/Index.tsx) (Salon landing page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application routes"]
  node_app["React app and routes<br/>[App.tsx]"]
end

subgraph group_customer["Customer experience"]
  node_landing["Salon landing page<br/>[Index.tsx]"]
  node_sitecontent["Salon information sections"]
  node_servicebrowse["Services and pricing<br/>[Services.tsx]"]
  node_gallery["Portfolio gallery"]
  node_booking["Appointment booking<br/>[BookingDialog.tsx]"]
end

subgraph group_admin["Salon administration"]
  node_adminlogin["Admin sign-in<br/>[AdminLogin.tsx]"]
  node_dashboard["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_appointmentviews["Appointment views"]
  node_customerrecords["Customer appointment details"]
  node_appointmentedit["Appointment editing"]
  node_menuadmin["Menu management"]
  node_portfolioadmin["Portfolio management"]
end

subgraph group_data["API access"]
  node_bookingapi["Booking and admin API<br/>[bookings.ts]"]
  node_menuapi["Menu APIs<br/>[menuItems.ts]"]
  node_adminmenuapi["Admin menu APIs<br/>[adminMenuItems.ts]"]
  node_portfolioapi["Portfolio API<br/>[portfolioItems.ts]"]
  node_adminportfolioapi["Admin portfolio API"]
end

subgraph group_ui["Shared UI"]
  node_uikit["Reusable UI primitives"]
  node_toast["Toast state and notifications<br/>[use-toast.ts]"]
end

node_visitor(("Customer or staff"))
node_backend{{"Salon backend service"}}

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_adminlogin
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_gallery
node_landing -->|"renders"| node_sitecontent
node_landing -->|"renders"| node_servicebrowse
node_gallery -->|"loads items"| node_portfolioapi
node_gallery -->|"opens booking"| node_booking
node_booking -->|"checks availability"| node_bookingapi
node_booking -->|"submits appointment"| node_bookingapi
node_adminlogin -->|"authenticates"| node_bookingapi
node_dashboard -->|"loads and updates"| node_bookingapi
node_dashboard -->|"renders"| node_appointmentviews
node_dashboard -->|"renders"| node_customerrecords
node_dashboard -->|"renders"| node_appointmentedit
node_dashboard -->|"renders"| node_menuadmin
node_dashboard -->|"renders"| node_portfolioadmin
node_appointmentviews -->|"manages appointments"| node_bookingapi
node_customerrecords -->|"reads appointment"| node_bookingapi
node_appointmentedit -->|"updates appointment"| node_bookingapi
node_menuadmin -->|"lists menu items"| node_menuapi
node_menuadmin -->|"changes menu items"| node_adminmenuapi
node_portfolioadmin -->|"lists portfolio"| node_portfolioapi
node_portfolioadmin -->|"changes portfolio"| node_adminportfolioapi
node_bookingapi -->|"calls backend"| node_backend
node_menuapi -.->|"calls backend"| node_backend
node_adminmenuapi -.->|"calls backend"| node_backend
node_portfolioapi -.->|"calls backend"| node_backend
node_adminportfolioapi -.->|"calls backend"| node_backend
node_dashboard -.->|"reports actions"| node_toast

click node_app "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/App.tsx"
click node_landing "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/Index.tsx"
click node_sitecontent "https://github.com/twinemukama/lucys-beauty-parlour-frontend/tree/main/src/components"
click node_servicebrowse "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/Services.tsx"
click node_gallery "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/ServicesGallery.tsx"
click node_booking "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/BookingDialog.tsx"
click node_adminlogin "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/AdminLogin.tsx"
click node_dashboard "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/AdminDashboard.tsx"
click node_appointmentviews "https://github.com/twinemukama/lucys-beauty-parlour-frontend/tree/main/src/components/admin"
click node_customerrecords "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/CustomerDetailsDialog.tsx"
click node_appointmentedit "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/EditAppointmentDialog.tsx"
click node_menuadmin "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/MenuItemsManager.tsx"
click node_portfolioadmin "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/PortfolioItemsManager.tsx"
click node_bookingapi "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/bookings.ts"
click node_menuapi "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/menuItems.ts"
click node_adminmenuapi "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/adminMenuItems.ts"
click node_portfolioapi "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/portfolioItems.ts"
click node_adminportfolioapi "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/adminPortfolioItems.ts"
click node_uikit "https://github.com/twinemukama/lucys-beauty-parlour-frontend/tree/main/src/components/ui"
click node_toast "https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/hooks/use-toast.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 toneBlue
class node_landing,node_sitecontent,node_servicebrowse,node_gallery,node_booking toneAmber
class node_adminlogin,node_dashboard,node_appointmentviews,node_customerrecords,node_appointmentedit,node_menuadmin,node_portfolioadmin toneMint
class node_bookingapi,node_menuapi,node_adminmenuapi,node_portfolioapi,node_adminportfolioapi toneRose
class node_uikit,node_toast,node_visitor,node_backend toneIndigo
```

## Components

### Application routes

- [React app and routes](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/App.tsx): `src/App.tsx`

### Customer experience

- [Salon landing page](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/Index.tsx): `src/pages/Index.tsx`
- [Salon information sections](https://github.com/twinemukama/lucys-beauty-parlour-frontend/tree/main/src/components): `src/components`
- [Services and pricing](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/Services.tsx): `src/components/Services.tsx`
- [Portfolio gallery](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/ServicesGallery.tsx): `src/pages/ServicesGallery.tsx`
- [Appointment booking](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/BookingDialog.tsx): `src/components/BookingDialog.tsx`

### Salon administration

- [Admin sign-in](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/AdminLogin.tsx): `src/pages/AdminLogin.tsx`
- [Admin dashboard](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/pages/AdminDashboard.tsx): `src/pages/AdminDashboard.tsx`
- [Appointment views](https://github.com/twinemukama/lucys-beauty-parlour-frontend/tree/main/src/components/admin): `src/components/admin`
- [Customer appointment details](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/CustomerDetailsDialog.tsx): `src/components/admin/CustomerDetailsDialog.tsx`
- [Appointment editing](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/EditAppointmentDialog.tsx): `src/components/admin/EditAppointmentDialog.tsx`
- [Menu management](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/MenuItemsManager.tsx): `src/components/admin/MenuItemsManager.tsx`
- [Portfolio management](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/components/admin/PortfolioItemsManager.tsx): `src/components/admin/PortfolioItemsManager.tsx`

### API access

- [Booking and admin API](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/bookings.ts): `src/apis/bookings.ts`
- [Menu APIs](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/menuItems.ts): `src/apis/menuItems.ts`
- [Admin menu APIs](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/adminMenuItems.ts): `src/apis/adminMenuItems.ts`
- [Portfolio API](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/portfolioItems.ts): `src/apis/portfolioItems.ts`
- [Admin portfolio API](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/apis/adminPortfolioItems.ts): `src/apis/adminPortfolioItems.ts`

### Shared UI

- [Reusable UI primitives](https://github.com/twinemukama/lucys-beauty-parlour-frontend/tree/main/src/components/ui): `src/components/ui`
- [Toast state and notifications](https://github.com/twinemukama/lucys-beauty-parlour-frontend/blob/main/src/hooks/use-toast.ts): `src/hooks/use-toast.ts`

### Other components

- **Customer or staff**
- **Salon backend service**

## Connections

- Customer or staff → React app and routes: opens (evidence: `src/App.tsx`)
- React app and routes → Salon landing page: routes to (evidence: `src/App.tsx`)
- React app and routes → Admin sign-in: routes to (evidence: `src/App.tsx`)
- React app and routes → Admin dashboard: routes to (evidence: `src/App.tsx`)
- React app and routes → Portfolio gallery: routes to (evidence: `src/App.tsx`)
- Salon landing page → Salon information sections: renders (evidence: `src/pages/Index.tsx`)
- Salon landing page → Services and pricing: renders (evidence: `src/pages/Index.tsx`)
- Portfolio gallery → Portfolio API: loads items (evidence: `src/pages/ServicesGallery.tsx`)
- Portfolio gallery → Appointment booking: opens booking (evidence: `src/pages/ServicesGallery.tsx`)
- Appointment booking → Booking and admin API: checks availability (evidence: `src/components/BookingDialog.tsx`)
- Appointment booking → Booking and admin API: submits appointment (evidence: `src/components/BookingDialog.tsx`)
- Admin sign-in → Booking and admin API: authenticates (evidence: `src/pages/AdminLogin.tsx`)
- Admin dashboard → Booking and admin API: loads and updates (evidence: `src/pages/AdminDashboard.tsx`)
- Admin dashboard → Appointment views: renders (evidence: `src/pages/AdminDashboard.tsx`)
- Admin dashboard → Customer appointment details: renders (evidence: `src/pages/AdminDashboard.tsx`)
- Admin dashboard → Appointment editing: renders (evidence: `src/pages/AdminDashboard.tsx`)
- Admin dashboard → Menu management: renders (evidence: `src/pages/AdminDashboard.tsx`)
- Admin dashboard → Portfolio management: renders (evidence: `src/pages/AdminDashboard.tsx`)
- Appointment views → Booking and admin API: manages appointments (evidence: `src/components/admin/AppointmentList.tsx`)
- Customer appointment details → Booking and admin API: reads appointment (evidence: `src/components/admin/CustomerDetailsDialog.tsx`)
- Appointment editing → Booking and admin API: updates appointment (evidence: `src/components/admin/EditAppointmentDialog.tsx`)
- Menu management → Menu APIs: lists menu items (evidence: `src/components/admin/MenuItemsManager.tsx`)
- Menu management → Admin menu APIs: changes menu items (evidence: `src/components/admin/MenuItemsManager.tsx`)
- Portfolio management → Portfolio API: lists portfolio (evidence: `src/components/admin/PortfolioItemsManager.tsx`)
- Portfolio management → Admin portfolio API: changes portfolio (evidence: `src/components/admin/PortfolioItemsManager.tsx`)
- Booking and admin API → Salon backend service: calls backend (evidence: `src/apis/bookings.ts`)
- Menu APIs → Salon backend service: calls backend
- Admin menu APIs → Salon backend service: calls backend
- Portfolio API → Salon backend service: calls backend
- Admin portfolio API → Salon backend service: calls backend
- Admin dashboard → Toast state and notifications: reports actions
