# mohamedbrzan/brzan-web-solutions architecture

> Architecture diagram of the GitHub repository mohamedbrzan/brzan-web-solutions, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohamedbrzan/brzan-web-solutions
- Repository: https://github.com/mohamedbrzan/brzan-web-solutions

## Overview

This is a React portfolio and professional-services website. Visitors browse profile, services, project and blog content, then can contact or request a booking; the app routes these experiences inside a shared site layout. Blog and project content are served by in-repository data modules, while booking and newsletter actions include HTTP requests to an external mail endpoint. The graph reflects sampled source and SOURCE INDEX references; unsampled page and section details are represented only where their connections are supported.

Main entry points: [`src/App.tsx`](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/App.tsx) (Route application), [`src/pages/BlogPost.tsx`](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/BlogPost.tsx) (Blog article), [`src/pages/Portfolio.tsx`](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Portfolio.tsx) (Portfolio page), [`src/pages/Blog.tsx`](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Blog.tsx) (Blog index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing and shell"]
  node_app["Route application<br/>[App.tsx]"]
  node_layout["Shared site shell<br/>[Layout.tsx]"]
  node_privacy["Privacy policy<br/>[PrivacyPolicy.tsx]"]
  node_notfound["Not-found page<br/>[NotFound.tsx]"]
end

subgraph group_content["Portfolio and publishing"]
  node_home["Home page<br/>[Home.tsx]"]
  node_portfolio["Portfolio page<br/>[Portfolio.tsx]"]
  node_projects["Project catalog<br/>[projectService.ts]"]
  node_projectcard["Project display<br/>[ProjectCard.tsx]"]
  node_blog["Blog index<br/>[Blog.tsx]"]
  node_blogdata["Blog content<br/>[blogService.ts]"]
  node_blogpost["Blog article<br/>[BlogPost.tsx]"]
  node_markdown["Markdown renderer"]
end

subgraph group_services["Services and profile"]
  node_about["About page<br/>[About.tsx]"]
  node_servicespage["Services page<br/>[Services.tsx]"]
  node_servicecatalog["Service offerings<br/>[MainServices.tsx]"]
  node_servicecard["Service display<br/>[ServiceCard.tsx]"]
end

subgraph group_engagement["Visitor engagement"]
  node_booking["Booking page<br/>[Booking.tsx]"]
  node_bookingoptions["Booking options<br/>[BookingOptions.tsx]"]
  node_bookingform["Booking form<br/>[BookingForm.tsx]"]
  node_contact["Contact page<br/>[Contact.tsx]"]
  node_contactform["Contact form<br/>[ContactForm.tsx]"]
end

node_visitor(("Site visitor"))
node_mailapi["Mail endpoint"]

node_visitor -->|"opens site"| node_app
node_app -->|"wraps routes"| node_layout
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_portfolio
node_app -->|"routes to"| node_about
node_app -->|"routes to"| node_servicespage
node_app -->|"routes to"| node_blog
node_app -->|"routes to"| node_blogpost
node_app -->|"routes to"| node_booking
node_app -->|"routes to"| node_contact
node_app -->|"routes to"| node_privacy
node_app -->|"routes to"| node_notfound
node_portfolio -->|"loads projects"| node_projects
node_portfolio -->|"renders projects"| node_projectcard
node_blog -->|"loads posts"| node_blogdata
node_blog -.->|"links articles"| node_blogpost
node_blogpost -->|"loads article"| node_blogdata
node_blogpost -->|"renders content"| node_markdown
node_blogpost -->|"submits subscription"| node_mailapi
node_servicespage -->|"renders offerings"| node_servicecatalog
node_servicecatalog -->|"renders cards"| node_servicecard
node_booking -.->|"shows options"| node_bookingoptions
node_bookingoptions -->|"renders form"| node_bookingform
node_bookingform -->|"submits booking"| node_mailapi
node_contact -->|"renders form"| node_contactform

click node_app "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/App.tsx"
click node_layout "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/Layout.tsx"
click node_home "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Home.tsx"
click node_portfolio "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Portfolio.tsx"
click node_projects "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/services/projectService.ts"
click node_projectcard "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/ProjectCard.tsx"
click node_blog "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Blog.tsx"
click node_blogdata "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/services/blogService.ts"
click node_blogpost "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/BlogPost.tsx"
click node_markdown "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/MarkdownRenderer.tsx"
click node_about "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/About.tsx"
click node_servicespage "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Services.tsx"
click node_servicecatalog "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/sections/services/MainServices.tsx"
click node_servicecard "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/ServiceCard.tsx"
click node_booking "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Booking.tsx"
click node_bookingoptions "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/sections/booking/BookingOptions.tsx"
click node_bookingform "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/BookingForm.tsx"
click node_contact "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Contact.tsx"
click node_contactform "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/ContactForm.tsx"
click node_privacy "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/PrivacyPolicy.tsx"
click node_notfound "https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/NotFound.tsx"

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_layout,node_privacy,node_notfound toneBlue
class node_home,node_portfolio,node_projects,node_projectcard,node_blog,node_blogdata,node_blogpost,node_markdown toneAmber
class node_about,node_servicespage,node_servicecatalog,node_servicecard toneMint
class node_booking,node_bookingoptions,node_bookingform,node_contact,node_contactform toneRose
class node_visitor,node_mailapi toneIndigo
```

## Components

### Routing and shell

- [Route application](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/App.tsx): `src/App.tsx`
- [Shared site shell](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/Layout.tsx): `src/components/Layout.tsx`
- [Privacy policy](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/PrivacyPolicy.tsx): `src/pages/PrivacyPolicy.tsx`
- [Not-found page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/NotFound.tsx): `src/pages/NotFound.tsx`

### Portfolio and publishing

- [Home page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Portfolio page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Portfolio.tsx): `src/pages/Portfolio.tsx`
- [Project catalog](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/services/projectService.ts): `src/services/projectService.ts`
- [Project display](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/ProjectCard.tsx): `src/components/ProjectCard.tsx`
- [Blog index](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Blog.tsx): `src/pages/Blog.tsx`
- [Blog content](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/services/blogService.ts): `src/services/blogService.ts`
- [Blog article](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/BlogPost.tsx): `src/pages/BlogPost.tsx`
- [Markdown renderer](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/MarkdownRenderer.tsx): `src/components/MarkdownRenderer.tsx`

### Services and profile

- [About page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/About.tsx): `src/pages/About.tsx`
- [Services page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Services.tsx): `src/pages/Services.tsx`
- [Service offerings](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/sections/services/MainServices.tsx): `src/sections/services/MainServices.tsx`
- [Service display](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/ServiceCard.tsx): `src/components/ServiceCard.tsx`

### Visitor engagement

- [Booking page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Booking.tsx): `src/pages/Booking.tsx`
- [Booking options](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/sections/booking/BookingOptions.tsx): `src/sections/booking/BookingOptions.tsx`
- [Booking form](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/BookingForm.tsx): `src/components/BookingForm.tsx`
- [Contact page](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/pages/Contact.tsx): `src/pages/Contact.tsx`
- [Contact form](https://github.com/mohamedbrzan/brzan-web-solutions/blob/main/src/components/ContactForm.tsx): `src/components/ContactForm.tsx`

### Other components

- **Site visitor**
- **Mail endpoint**

## Connections

- Site visitor → Route application: opens site
- Route application → Shared site shell: wraps routes (evidence: `src/App.tsx`)
- Route application → Home page: routes to (evidence: `src/App.tsx`)
- Route application → Portfolio page: routes to (evidence: `src/App.tsx`)
- Route application → About page: routes to (evidence: `src/App.tsx`)
- Route application → Services page: routes to (evidence: `src/App.tsx`)
- Route application → Blog index: routes to (evidence: `src/App.tsx`)
- Route application → Blog article: routes to (evidence: `src/App.tsx`)
- Route application → Booking page: routes to (evidence: `src/App.tsx`)
- Route application → Contact page: routes to (evidence: `src/App.tsx`)
- Route application → Privacy policy: routes to (evidence: `src/App.tsx`)
- Route application → Not-found page: routes to (evidence: `src/App.tsx`)
- Portfolio page → Project catalog: loads projects (evidence: `src/pages/Portfolio.tsx`)
- Portfolio page → Project display: renders projects (evidence: `src/pages/Portfolio.tsx`)
- Blog index → Blog content: loads posts (evidence: `src/pages/Blog.tsx`)
- Blog index → Blog article: links articles
- Blog article → Blog content: loads article (evidence: `src/pages/BlogPost.tsx`)
- Blog article → Markdown renderer: renders content (evidence: `src/pages/BlogPost.tsx`)
- Blog article → Mail endpoint: submits subscription (evidence: `src/pages/BlogPost.tsx`)
- Services page → Service offerings: renders offerings (evidence: `src/pages/Services.tsx`)
- Service offerings → Service display: renders cards (evidence: `src/sections/services/MainServices.tsx`)
- Booking page → Booking options: shows options
- Booking options → Booking form: renders form (evidence: `src/sections/booking/BookingOptions.tsx`)
- Booking form → Mail endpoint: submits booking (evidence: `src/components/BookingForm.tsx`)
- Contact page → Contact form: renders form (evidence: `src/pages/Contact.tsx`)
