# firoapo01/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/firoapo01/portfolio
- Repository: https://github.com/firoapo01/portfolio

## Overview

OmniStack is a Next.js portfolio that presents a developer’s work, services, process, background, and contact options. A visitor enters through the homepage or navigation, explores project listings and case studies or other portfolio pages, then can follow contact or service calls to action. The App Router pages compose page wrappers and content sections; those sections render shared project, service, profile, and process data. The README documents a broad desert-themed motion system, including particle, dune, haze, calligraphy, cursor, transition, and hover effects. Some feature-to-component mappings are based on README descriptions because those component files were not sampled.

Main entry points: [`src/app/page.tsx`](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/page.tsx) (Home page), [`src/components/layout/PageWrapper.tsx`](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/PageWrapper.tsx) (Page wrapper), [`src/lib/motion.ts`](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/lib/motion.ts) (Motion variants), [`src/sections/FeaturedProjects.tsx`](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/FeaturedProjects.tsx) (Featured projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portfolio experience"]
  node_home["Home page<br/>[page.tsx]"]
  node_about["About page<br/>[page.tsx]"]
  node_projects["Projects page<br/>[page.tsx]"]
  node_case["Case study page<br/>[page.tsx]"]
  node_services["Services page<br/>[page.tsx]"]
  node_process["Process page<br/>[page.tsx]"]
  node_contact["Contact page<br/>[page.tsx]"]
  node_resume["Resume page<br/>[page.tsx]"]
end

subgraph group_content["Portfolio content"]
  node_hero["Hero section<br/>[Hero.tsx]"]
  node_featured["Featured projects"]
  node_casecontent["Case study content"]
  node_servicecontent["Service details"]
  node_processcontent["Process details<br/>[ProcessContent.tsx]"]
  node_aboutcontent["About content<br/>[AboutContent.tsx]"]
  node_contactcontent["Contact content<br/>[ContactContent.tsx]"]
end

subgraph group_motion["Desert motion system"]
  node_particles["Sand particles<br/>[SandParticles.tsx]"]
  node_dunes["Dune silhouettes<br/>[DesertDunes.tsx]"]
  node_haze["Heat haze<br/>[HeatHaze.tsx]"]
  node_calligraphy["Arabic calligraphy"]
  node_cursor["Cursor orb<br/>[CursorOrb.tsx]"]
  node_transitions["Page transitions<br/>[PageTransition.tsx]"]
  node_cardeffects["Card effects<br/>[CardEffects.tsx]"]
  node_button["Desert button<br/>[DesertButton.tsx]"]
end

subgraph group_shared["Shared data and UI"]
  node_wrapper["Page wrapper<br/>[PageWrapper.tsx]"]
  node_nav["Navigation<br/>[Navbar.tsx]"]
  node_data_projects["Project catalog<br/>[projects.ts]"]
  node_data_services["Service catalog<br/>[services.ts]"]
  node_data_process["Process stages<br/>[process.ts]"]
  node_data_profile["Profile and contact data<br/>[profile.ts]"]
  node_motionlib["Motion variants<br/>[motion.ts]"]
end

node_visitor(("Portfolio visitor"))

node_visitor -->|"opens"| node_home
node_visitor -.->|"browses"| node_nav
node_home -->|"renders"| node_wrapper
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_featured
node_about -->|"renders"| node_wrapper
node_about -->|"renders"| node_aboutcontent
node_projects -->|"renders"| node_wrapper
node_projects -->|"reads"| node_data_projects
node_case -->|"renders"| node_wrapper
node_case -->|"renders"| node_casecontent
node_case -->|"reads"| node_data_projects
node_services -->|"renders"| node_servicecontent
node_servicecontent -->|"reads"| node_data_services
node_process -->|"renders"| node_processcontent
node_processcontent -->|"reads"| node_data_process
node_contact -->|"renders"| node_contactcontent
node_contactcontent -->|"reads"| node_data_profile
node_featured -->|"reads"| node_data_projects
node_hero -->|"reads"| node_data_profile
node_wrapper -->|"wraps with"| node_transitions
node_nav -->|"uses"| node_button
node_featured -->|"uses"| node_cardeffects
node_featured -->|"uses"| node_motionlib
node_servicecontent -->|"uses"| node_cardeffects
node_servicecontent -->|"uses"| node_motionlib
node_casecontent -->|"uses"| node_motionlib
node_aboutcontent -->|"reads"| node_data_profile
node_aboutcontent -->|"uses"| node_motionlib
node_contactcontent -->|"uses"| node_motionlib
node_home -.->|"includes"| node_particles
node_home -.->|"includes"| node_dunes
node_home -.->|"includes"| node_haze
node_home -.->|"includes"| node_calligraphy
node_home -.->|"includes"| node_cursor
node_home -.->|"uses"| node_cardeffects
node_home -.->|"uses"| node_button

click node_home "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/page.tsx"
click node_about "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/about/page.tsx"
click node_projects "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/projects/page.tsx"
click node_case "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/projects/%5Bslug%5D/page.tsx"
click node_services "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/services/page.tsx"
click node_process "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/process/page.tsx"
click node_contact "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/contact/page.tsx"
click node_resume "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/resume/page.tsx"
click node_wrapper "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/PageWrapper.tsx"
click node_nav "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/Navbar.tsx"
click node_hero "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/Hero.tsx"
click node_featured "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/FeaturedProjects.tsx"
click node_casecontent "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/CaseStudyContent.tsx"
click node_servicecontent "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/ServicesContent.tsx"
click node_processcontent "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/ProcessContent.tsx"
click node_aboutcontent "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/AboutContent.tsx"
click node_contactcontent "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/ContactContent.tsx"
click node_data_projects "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/projects.ts"
click node_data_services "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/services.ts"
click node_data_process "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/process.ts"
click node_data_profile "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/profile.ts"
click node_particles "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/SandParticles.tsx"
click node_dunes "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/DesertDunes.tsx"
click node_haze "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/HeatHaze.tsx"
click node_calligraphy "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/CalligraphyElement.tsx"
click node_cursor "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/CursorOrb.tsx"
click node_transitions "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/PageTransition.tsx"
click node_cardeffects "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/CardEffects.tsx"
click node_button "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/DesertButton.tsx"
click node_motionlib "https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/lib/motion.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_home,node_about,node_projects,node_case,node_services,node_process,node_contact,node_resume toneBlue
class node_hero,node_featured,node_casecontent,node_servicecontent,node_processcontent,node_aboutcontent,node_contactcontent toneAmber
class node_particles,node_dunes,node_haze,node_calligraphy,node_cursor,node_transitions,node_cardeffects,node_button toneMint
class node_wrapper,node_nav,node_data_projects,node_data_services,node_data_process,node_data_profile,node_motionlib toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio experience

- [Home page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/page.tsx): `src/app/page.tsx`
- [About page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/about/page.tsx): `src/app/about/page.tsx`
- [Projects page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/projects/page.tsx): `src/app/projects/page.tsx`
- [Case study page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/projects/%5Bslug%5D/page.tsx): `src/app/projects/[slug]/page.tsx`
- [Services page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/services/page.tsx): `src/app/services/page.tsx`
- [Process page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/process/page.tsx): `src/app/process/page.tsx`
- [Contact page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/contact/page.tsx): `src/app/contact/page.tsx`
- [Resume page](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/app/resume/page.tsx): `src/app/resume/page.tsx`

### Portfolio content

- [Hero section](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/Hero.tsx): `src/sections/Hero.tsx`
- [Featured projects](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/FeaturedProjects.tsx): `src/sections/FeaturedProjects.tsx`
- [Case study content](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/CaseStudyContent.tsx): `src/sections/CaseStudyContent.tsx`
- [Service details](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/ServicesContent.tsx): `src/sections/ServicesContent.tsx`
- [Process details](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/ProcessContent.tsx): `src/sections/ProcessContent.tsx`
- [About content](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/AboutContent.tsx): `src/sections/AboutContent.tsx`
- [Contact content](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/sections/ContactContent.tsx): `src/sections/ContactContent.tsx`

### Desert motion system

- [Sand particles](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/SandParticles.tsx): `src/components/SandParticles.tsx`
- [Dune silhouettes](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/DesertDunes.tsx): `src/components/DesertDunes.tsx`
- [Heat haze](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/HeatHaze.tsx): `src/components/HeatHaze.tsx`
- [Arabic calligraphy](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/CalligraphyElement.tsx): `src/components/CalligraphyElement.tsx`
- [Cursor orb](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/CursorOrb.tsx): `src/components/CursorOrb.tsx`
- [Page transitions](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/PageTransition.tsx): `src/components/layout/PageTransition.tsx`
- [Card effects](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/CardEffects.tsx): `src/components/CardEffects.tsx`
- [Desert button](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/DesertButton.tsx): `src/components/DesertButton.tsx`

### Shared data and UI

- [Page wrapper](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/PageWrapper.tsx): `src/components/layout/PageWrapper.tsx`
- [Navigation](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/components/layout/Navbar.tsx): `src/components/layout/Navbar.tsx`
- [Project catalog](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/projects.ts): `src/data/projects.ts`
- [Service catalog](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/services.ts): `src/data/services.ts`
- [Process stages](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/process.ts): `src/data/process.ts`
- [Profile and contact data](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/data/profile.ts): `src/data/profile.ts`
- [Motion variants](https://github.com/firoapo01/portfolio/blob/claude/clever-bardeen-6cmqpv/src/lib/motion.ts): `src/lib/motion.ts`

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → Home page: opens (evidence: `README.md`)
- Portfolio visitor → Navigation: browses
- Home page → Page wrapper: renders (evidence: `src/app/page.tsx`)
- Home page → Hero section: renders (evidence: `src/app/page.tsx`)
- Home page → Featured projects: renders (evidence: `src/app/page.tsx`)
- About page → Page wrapper: renders (evidence: `src/app/about/page.tsx`)
- About page → About content: renders (evidence: `src/app/about/page.tsx`)
- Projects page → Page wrapper: renders (evidence: `src/app/projects/page.tsx`)
- Projects page → Project catalog: reads (evidence: `src/app/projects/page.tsx`)
- Case study page → Page wrapper: renders (evidence: `src/app/projects/[slug]/page.tsx`)
- Case study page → Case study content: renders (evidence: `src/app/projects/[slug]/page.tsx`)
- Case study page → Project catalog: reads (evidence: `src/app/projects/[slug]/page.tsx`)
- Services page → Service details: renders (evidence: `src/app/services/page.tsx`)
- Service details → Service catalog: reads (evidence: `src/sections/ServicesContent.tsx`)
- Process page → Process details: renders (evidence: `src/app/process/page.tsx`)
- Process details → Process stages: reads (evidence: `src/sections/ProcessContent.tsx`)
- Contact page → Contact content: renders (evidence: `src/app/contact/page.tsx`)
- Contact content → Profile and contact data: reads (evidence: `src/sections/ContactContent.tsx`)
- Featured projects → Project catalog: reads (evidence: `src/sections/FeaturedProjects.tsx`)
- Hero section → Profile and contact data: reads (evidence: `src/sections/Hero.tsx`)
- Page wrapper → Page transitions: wraps with (evidence: `src/components/layout/PageWrapper.tsx`)
- Navigation → Desert button: uses (evidence: `src/components/layout/Navbar.tsx`)
- Featured projects → Card effects: uses (evidence: `src/sections/FeaturedProjects.tsx`)
- Featured projects → Motion variants: uses (evidence: `src/sections/FeaturedProjects.tsx`)
- Service details → Card effects: uses (evidence: `src/sections/ServicesContent.tsx`)
- Service details → Motion variants: uses (evidence: `src/sections/ServicesContent.tsx`)
- Case study content → Motion variants: uses (evidence: `src/sections/CaseStudyContent.tsx`)
- About content → Profile and contact data: reads (evidence: `src/sections/AboutContent.tsx`)
- About content → Motion variants: uses (evidence: `src/sections/AboutContent.tsx`)
- Contact content → Motion variants: uses (evidence: `src/sections/ContactContent.tsx`)
- Home page → Sand particles: includes (evidence: `README.md`)
- Home page → Dune silhouettes: includes (evidence: `README.md`)
- Home page → Heat haze: includes (evidence: `README.md`)
- Home page → Arabic calligraphy: includes (evidence: `README.md`)
- Home page → Cursor orb: includes (evidence: `README.md`)
- Home page → Card effects: uses (evidence: `README.md`)
- Home page → Desert button: uses (evidence: `README.md`)
