# hameed-codes/agency.ai-react-frontend-web-page architecture

> Architecture diagram of the GitHub repository hameed-codes/agency.ai-react-frontend-web-page, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hameed-codes/agency.ai-react-frontend-web-page
- Repository: https://github.com/hameed-codes/agency.ai-react-frontend-web-page

## Overview

Agency.ai is a React agency landing page. The browser renders a sequence of promotional sections, lets visitors browse services and portfolio work, and provides a contact form that submits to Web3Forms with toast feedback. Theme selection is shared between the app, navigation and footer, with OS preference detection and localStorage persistence. The graph reflects the shown imports and calls; the newsletter is a displayed form with no submission behavior shown. Other section implementations were not sampled, so their internal behavior is not inferred.

Main entry points: [`src/App.jsx`](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/App.jsx) (Page composition), [`src/components/Navbar.jsx`](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Navbar.jsx) (Navbar), [`src/components/Contact.jsx`](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Contact.jsx) (Contact form), [`src/components/Services.jsx`](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Services.jsx) (Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_react_mount["React mount<br/>[main.jsx]"]
  node_app["Page composition<br/>[App.jsx]"]
  node_assets["Page assets<br/>[assets.js]"]
end

subgraph group_content["Agency content"]
  node_hero["Hero section<br/>[Hero.jsx]"]
  node_trusted["Trusted by"]
  node_services["Services<br/>[Services.jsx]"]
  node_service_card["Service card<br/>[ServiceCard.jsx]"]
  node_work["Our work<br/>[OurWork.jsx]"]
  node_team["Team<br/>[Team.jsx]"]
  node_title["Section title<br/>[Title.jsx]"]
end

subgraph group_interaction["Navigation and theme"]
  node_navbar["Navbar<br/>[Navbar.jsx]"]
  node_theme_toggle["Theme toggle<br/>[ThemeToggleBtn.jsx]"]
end

subgraph group_contact["Contact and shared UI"]
  node_contact["Contact form<br/>[Contact.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_toaster["Toast host<br/>[App.jsx]"]
end

node_visitor(("Visitor"))
node_web3forms{{"Web3Forms API"}}
node_toast{{"Toast notifications"}}

node_visitor -->|"opens page"| node_react_mount
node_react_mount -->|"renders"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_trusted
node_app -->|"renders"| node_services
node_app -->|"renders"| node_work
node_app -->|"renders"| node_team
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_toaster
node_navbar -->|"renders"| node_theme_toggle
node_theme_toggle -->|"updates theme"| node_navbar
node_navbar -->|"links to"| node_services
node_navbar -->|"links to"| node_work
node_navbar -->|"links to"| node_contact
node_services -->|"renders"| node_service_card
node_services -->|"renders"| node_title
node_work -->|"renders"| node_title
node_team -->|"renders"| node_title
node_contact -->|"renders"| node_title
node_contact -->|"submits form"| node_web3forms
node_contact -->|"shows result"| node_toast

click node_react_mount "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/main.jsx"
click node_app "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/App.jsx"
click node_navbar "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Navbar.jsx"
click node_theme_toggle "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/ThemeToggleBtn.jsx"
click node_hero "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Hero.jsx"
click node_trusted "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/TrustedBySection.jsx"
click node_services "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Services.jsx"
click node_service_card "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/ServiceCard.jsx"
click node_work "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/OurWork.jsx"
click node_team "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Team.jsx"
click node_contact "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Contact.jsx"
click node_footer "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Footer.jsx"
click node_title "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Title.jsx"
click node_assets "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/assets/assets.js"
click node_toaster "https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/App.jsx"

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_react_mount,node_app,node_assets toneBlue
class node_hero,node_trusted,node_services,node_service_card,node_work,node_team,node_title toneAmber
class node_navbar,node_theme_toggle,node_web3forms toneMint
class node_contact,node_footer,node_toaster toneRose
class node_visitor,node_toast toneIndigo
```

## Components

### App runtime

- [React mount](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/main.jsx): `src/main.jsx`
- [Page composition](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/App.jsx): `src/App.jsx`
- [Page assets](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/assets/assets.js): `src/assets/assets.js`

### Agency content

- [Hero section](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`
- [Trusted by](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/TrustedBySection.jsx): `src/components/TrustedBySection.jsx`
- [Services](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Services.jsx): `src/components/Services.jsx`
- [Service card](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/ServiceCard.jsx): `src/components/ServiceCard.jsx`
- [Our work](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/OurWork.jsx): `src/components/OurWork.jsx`
- [Team](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Team.jsx): `src/components/Team.jsx`
- [Section title](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Title.jsx): `src/components/Title.jsx`

### Navigation and theme

- [Navbar](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Theme toggle](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/ThemeToggleBtn.jsx): `src/components/ThemeToggleBtn.jsx`

### Contact and shared UI

- [Contact form](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Contact.jsx): `src/components/Contact.jsx`
- [Footer](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/components/Footer.jsx): `src/components/Footer.jsx`
- [Toast host](https://github.com/hameed-codes/agency.ai-react-frontend-web-page/blob/main/src/App.jsx): `src/App.jsx`

### Other components

- **Visitor**
- **Web3Forms API**
- **Toast notifications**

## Connections

- Visitor → React mount: opens page
- React mount → Page composition: renders (evidence: `src/main.jsx`)
- Page composition → Navbar: renders (evidence: `src/App.jsx`)
- Page composition → Hero section: renders (evidence: `src/App.jsx`)
- Page composition → Trusted by: renders (evidence: `src/App.jsx`)
- Page composition → Services: renders (evidence: `src/App.jsx`)
- Page composition → Our work: renders (evidence: `src/App.jsx`)
- Page composition → Team: renders (evidence: `src/App.jsx`)
- Page composition → Contact form: renders (evidence: `src/App.jsx`)
- Page composition → Footer: renders (evidence: `src/App.jsx`)
- Page composition → Toast host: renders (evidence: `src/App.jsx`)
- Navbar → Theme toggle: renders (evidence: `src/components/Navbar.jsx`)
- Theme toggle → Navbar: updates theme (evidence: `src/components/Navbar.jsx`)
- Navbar → Services: links to (evidence: `src/components/Navbar.jsx`)
- Navbar → Our work: links to (evidence: `src/components/Navbar.jsx`)
- Navbar → Contact form: links to (evidence: `src/components/Navbar.jsx`)
- Services → Service card: renders (evidence: `src/components/Services.jsx`)
- Services → Section title: renders (evidence: `src/components/Services.jsx`)
- Our work → Section title: renders (evidence: `src/components/OurWork.jsx`)
- Team → Section title: renders (evidence: `src/components/Team.jsx`)
- Contact form → Section title: renders (evidence: `src/components/Contact.jsx`)
- Contact form → Web3Forms API: submits form (evidence: `src/components/Contact.jsx`)
- Contact form → Toast notifications: shows result (evidence: `src/components/Contact.jsx`)
