# whizzerbeats000-design/gibs-frontend architecture

> Architecture diagram of the GitHub repository whizzerbeats000-design/gibs-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/whizzerbeats000-design/gibs-frontend
- Repository: https://github.com/whizzerbeats000-design/gibs-frontend

## Overview

GIBS is a static, read-only school website: visitors browse programme, campus, admissions, institutional and gallery content, search the catalogue, or make contact. The hash-router dispatches pages; bundled catalogue and institutional data supply the content, while contact/newsletter workflows use mailto rather than a backend. The graph preserves documented capabilities, but some page and helper connections are based on the README or SOURCE INDEX because their implementations were not excerpted.

Main entry points: [`src/App.tsx`](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/App.tsx) (Application shell), [`src/lib/data.ts`](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/data.ts) (Programme catalogue), [`src/pages/Programmes.tsx`](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Programmes.tsx) (Programme browsing), [`src/pages/ProgrammeDetail.tsx`](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/ProgrammeDetail.tsx) (Programme details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_app["Application shell<br/>[App.tsx]"]
  node_router["Hash router<br/>[router.tsx]"]
  node_pages["Site pages"]
  node_home["Home sections"]
  node_seo["Route metadata<br/>[seoMetadata.ts]"]
end

subgraph group_content["Content and discovery"]
  node_catalogue["Programme catalogue<br/>[data.ts]"]
  node_programme_views["Programme browsing<br/>[Programmes.tsx]"]
  node_programme_detail["Programme details"]
  node_programme_content["Programme content"]
  node_campus["Campus locations<br/>[LocationDetail.tsx]"]
  node_gallery["Campus gallery<br/>[Gallery.tsx]"]
  node_search["Site search<br/>[Search.tsx]"]
  node_categories["Category utilities<br/>[categoryUtils.ts]"]
end

subgraph group_engagement["Visitor engagement"]
  node_concierge_ui["Concierge interface<br/>[Concierge.tsx]"]
  node_concierge_logic["Concierge responses<br/>[concierge.ts]"]
  node_contact["Contact and enquiry<br/>[Contact.tsx]"]
end

subgraph group_presentation["Shared presentation"]
  node_chrome["Navigation and footer<br/>[chrome.tsx]"]
  node_page_hero["Page hero<br/>[PageHero.tsx]"]
  node_cards["Programme cards<br/>[cards.tsx]"]
  node_motion["Motion primitives<br/>[motion.tsx]"]
  node_icons["Icon set<br/>[icons.tsx]"]
end

node_visitor(("Website visitor"))
node_mail(("Visitor mail client"))

node_visitor -->|"visits"| node_app
node_app -->|"provides routing"| node_router
node_app -->|"dispatches routes"| node_pages
node_app -->|"renders shell"| node_chrome
node_app -->|"opens search"| node_search
node_app -->|"opens concierge"| node_concierge_ui
node_app -.->|"renders home"| node_home
node_router -->|"syncs metadata"| node_seo
node_programme_views -->|"reads programmes"| node_catalogue
node_programme_views -->|"groups listings"| node_categories
node_programme_views -->|"uses content"| node_programme_content
node_programme_views -->|"renders cards"| node_cards
node_programme_detail -->|"reads programme"| node_catalogue
node_programme_detail -->|"uses content"| node_programme_content
node_programme_detail -->|"renders cards"| node_cards
node_campus -->|"filters schedule"| node_catalogue
node_search -->|"indexes listings"| node_catalogue
node_concierge_ui -->|"requests responses"| node_concierge_logic
node_concierge_logic -->|"uses programme data"| node_catalogue
node_contact -.->|"opens mailto"| node_mail
node_programme_views -.->|"shows listings"| node_visitor
node_programme_detail -.->|"shows details"| node_visitor
node_campus -.->|"shows facilities"| node_visitor
node_gallery -.->|"shows photographs"| node_visitor
node_chrome -->|"offers navigation"| node_visitor
node_page_hero -->|"uses animation"| node_motion
node_cards -->|"reads listings"| node_catalogue

click node_app "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/App.tsx"
click node_router "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/router.tsx"
click node_pages "https://github.com/whizzerbeats000-design/gibs-frontend/tree/main/src/pages"
click node_home "https://github.com/whizzerbeats000-design/gibs-frontend/tree/main/src/sections"
click node_catalogue "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/data.ts"
click node_programme_views "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Programmes.tsx"
click node_programme_detail "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/ProgrammeDetail.tsx"
click node_programme_content "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/programme-content.ts"
click node_campus "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/LocationDetail.tsx"
click node_gallery "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Gallery.tsx"
click node_search "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/Search.tsx"
click node_categories "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/categoryUtils.ts"
click node_concierge_ui "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/Concierge.tsx"
click node_concierge_logic "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/concierge.ts"
click node_contact "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Contact.tsx"
click node_chrome "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/chrome.tsx"
click node_page_hero "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/PageHero.tsx"
click node_cards "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/cards.tsx"
click node_motion "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/motion.tsx"
click node_icons "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/icons.tsx"
click node_seo "https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/seoMetadata.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_router,node_pages,node_home,node_seo,node_mail toneBlue
class node_catalogue,node_programme_views,node_programme_detail,node_programme_content,node_campus,node_gallery,node_search,node_categories toneAmber
class node_concierge_ui,node_concierge_logic,node_contact toneMint
class node_chrome,node_page_hero,node_cards,node_motion,node_icons toneRose
class node_visitor toneIndigo
```

## Components

### Application runtime

- [Application shell](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Hash router](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/router.tsx): `src/lib/router.tsx`
- [Site pages](https://github.com/whizzerbeats000-design/gibs-frontend/tree/main/src/pages): `src/pages`
- [Home sections](https://github.com/whizzerbeats000-design/gibs-frontend/tree/main/src/sections): `src/sections`
- [Route metadata](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/seoMetadata.ts): `src/lib/seoMetadata.ts`

### Content and discovery

- [Programme catalogue](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/data.ts): `src/lib/data.ts`
- [Programme browsing](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Programmes.tsx): `src/pages/Programmes.tsx`
- [Programme details](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/ProgrammeDetail.tsx): `src/pages/ProgrammeDetail.tsx`
- [Programme content](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/programme-content.ts): `src/lib/programme-content.ts`
- [Campus locations](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/LocationDetail.tsx): `src/pages/LocationDetail.tsx`
- [Campus gallery](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Gallery.tsx): `src/pages/Gallery.tsx`
- [Site search](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/Search.tsx): `src/components/Search.tsx`
- [Category utilities](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/categoryUtils.ts): `src/lib/categoryUtils.ts`

### Visitor engagement

- [Concierge interface](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/Concierge.tsx): `src/components/Concierge.tsx`
- [Concierge responses](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/lib/concierge.ts): `src/lib/concierge.ts`
- [Contact and enquiry](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/pages/Contact.tsx): `src/pages/Contact.tsx`

### Shared presentation

- [Navigation and footer](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/chrome.tsx): `src/components/chrome.tsx`
- [Page hero](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/PageHero.tsx): `src/components/PageHero.tsx`
- [Programme cards](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/cards.tsx): `src/components/cards.tsx`
- [Motion primitives](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/motion.tsx): `src/components/motion.tsx`
- [Icon set](https://github.com/whizzerbeats000-design/gibs-frontend/blob/main/src/components/icons.tsx): `src/components/icons.tsx`

### Other components

- **Website visitor**
- **Visitor mail client**

## Connections

- Website visitor → Application shell: visits
- Application shell → Hash router: provides routing (evidence: `src/App.tsx`)
- Application shell → Site pages: dispatches routes (evidence: `src/App.tsx`)
- Application shell → Navigation and footer: renders shell (evidence: `src/App.tsx`)
- Application shell → Site search: opens search (evidence: `src/App.tsx`)
- Application shell → Concierge interface: opens concierge (evidence: `src/App.tsx`)
- Application shell → Home sections: renders home
- Hash router → Route metadata: syncs metadata (evidence: `src/lib/router.tsx`)
- Programme browsing → Programme catalogue: reads programmes (evidence: `src/pages/Programmes.tsx`)
- Programme browsing → Category utilities: groups listings (evidence: `src/pages/Programmes.tsx`)
- Programme browsing → Programme content: uses content (evidence: `src/pages/Programmes.tsx`)
- Programme browsing → Programme cards: renders cards (evidence: `src/pages/Programmes.tsx`)
- Programme details → Programme catalogue: reads programme (evidence: `src/pages/ProgrammeDetail.tsx`)
- Programme details → Programme content: uses content (evidence: `src/pages/ProgrammeDetail.tsx`)
- Programme details → Programme cards: renders cards (evidence: `src/pages/ProgrammeDetail.tsx`)
- Campus locations → Programme catalogue: filters schedule (evidence: `src/pages/LocationDetail.tsx`)
- Site search → Programme catalogue: indexes listings (evidence: `src/components/Search.tsx`)
- Concierge interface → Concierge responses: requests responses (evidence: `src/components/Concierge.tsx`)
- Concierge responses → Programme catalogue: uses programme data (evidence: `src/lib/concierge.ts`)
- Contact and enquiry → Visitor mail client: opens mailto
- Programme browsing → Website visitor: shows listings
- Programme details → Website visitor: shows details
- Campus locations → Website visitor: shows facilities
- Campus gallery → Website visitor: shows photographs
- Navigation and footer → Website visitor: offers navigation (evidence: `src/components/chrome.tsx`)
- Page hero → Motion primitives: uses animation (evidence: `src/components/PageHero.tsx`)
- Programme cards → Programme catalogue: reads listings (evidence: `src/components/cards.tsx`)
