# ahmedkhaleel2004/portfolio architecture

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

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

## Overview

This is a Next.js personal portfolio. A visitor requests the home or legacy route, the app renders profile content from local project, experience, and site configuration modules, and interactive client components enhance navigation, previews, email copying, and skills browsing. The home page also links to external projects and social profiles. The tree and sampled files support the main rendering and interaction paths; layout, navigation, footer, and some metadata behavior are represented only by their documented paths.

Main entry points: [`app/page.tsx`](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/page.tsx) (Portfolio Home), [`app/layout.tsx`](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/layout.tsx) (Site Shell), [`app/old`](https://github.com/ahmedkhaleel2004/portfolio/tree/main/app/old) (Legacy Pages), [`proxy.ts`](https://github.com/ahmedkhaleel2004/portfolio/blob/main/proxy.ts) (Route Proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rendering["Page Rendering"]
  node_site_shell["Site Shell<br/>[layout.tsx]"]
  node_route_proxy["Route Proxy<br/>[proxy.ts]"]
  node_home_page["Portfolio Home<br/>[page.tsx]"]
  node_legacy_pages["Legacy Pages"]
end

subgraph group_content["Portfolio Content"]
  node_project_catalog["Project Catalog<br/>[projects.ts]"]
  node_experience_catalog["Experience Catalog<br/>[experience.ts]"]
  node_site_config["Site Configuration<br/>[site.ts]"]
end

subgraph group_interaction["Interactive UI"]
  node_preview_tooltip["Project Previews<br/>[PreviewTooltip.tsx]"]
  node_copy_email["Email Copying<br/>[CopyEmail.tsx]"]
  node_client_word["Word Cycling<br/>[ClientWord.tsx]"]
  node_tech_view["Skills Browser<br/>[ClientTechView.tsx]"]
  node_tech_section["Skills Sections<br/>[TechSection.tsx]"]
end

subgraph group_navigation["Navigation"]
  node_site_navigation["Site Navigation<br/>[Navbar.tsx]"]
  node_nav_button["Navigation Button"]
  node_footer["Site Footer<br/>[Footer.tsx]"]
end

node_visitor(("Portfolio Visitor"))
node_external_destinations["External Destinations"]

node_visitor -->|"requests"| node_route_proxy
node_visitor -->|"visits"| node_home_page
node_visitor -->|"visits"| node_legacy_pages
node_route_proxy -->|"passes request"| node_site_shell
node_home_page -->|"reads projects"| node_project_catalog
node_home_page -->|"reads experience"| node_experience_catalog
node_home_page -->|"reads profile"| node_site_config
node_home_page -->|"renders previews"| node_preview_tooltip
node_home_page -->|"renders contact"| node_copy_email
node_home_page -.->|"links projects"| node_external_destinations
node_site_shell -->|"renders navigation"| node_site_navigation
node_site_shell -->|"renders footer"| node_footer
node_site_navigation -->|"renders buttons"| node_nav_button
node_legacy_pages -->|"renders cycling text"| node_client_word
node_legacy_pages -->|"renders skills"| node_tech_view
node_tech_view -->|"shows section"| node_tech_section

click node_site_shell "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/layout.tsx"
click node_route_proxy "https://github.com/ahmedkhaleel2004/portfolio/blob/main/proxy.ts"
click node_home_page "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/page.tsx"
click node_legacy_pages "https://github.com/ahmedkhaleel2004/portfolio/tree/main/app/old"
click node_project_catalog "https://github.com/ahmedkhaleel2004/portfolio/blob/main/lib/projects.ts"
click node_experience_catalog "https://github.com/ahmedkhaleel2004/portfolio/blob/main/lib/experience.ts"
click node_site_config "https://github.com/ahmedkhaleel2004/portfolio/blob/main/lib/site.ts"
click node_preview_tooltip "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/PreviewTooltip.tsx"
click node_copy_email "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/CopyEmail.tsx"
click node_client_word "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/ClientWord.tsx"
click node_tech_view "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/ClientTechView.tsx"
click node_tech_section "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/TechSection.tsx"
click node_site_navigation "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/Navbar.tsx"
click node_nav_button "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/ClientNavButton.tsx"
click node_footer "https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/Footer.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_site_shell,node_route_proxy,node_home_page,node_legacy_pages toneBlue
class node_project_catalog,node_experience_catalog,node_site_config toneAmber
class node_preview_tooltip,node_copy_email,node_client_word,node_tech_view,node_tech_section toneMint
class node_site_navigation,node_nav_button,node_footer toneRose
class node_visitor,node_external_destinations toneIndigo
```

## Components

### Page Rendering

- [Site Shell](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/layout.tsx): `app/layout.tsx`
- [Route Proxy](https://github.com/ahmedkhaleel2004/portfolio/blob/main/proxy.ts): `proxy.ts`
- [Portfolio Home](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/page.tsx): `app/page.tsx`
- [Legacy Pages](https://github.com/ahmedkhaleel2004/portfolio/tree/main/app/old): `app/old`

### Portfolio Content

- [Project Catalog](https://github.com/ahmedkhaleel2004/portfolio/blob/main/lib/projects.ts): `lib/projects.ts`
- [Experience Catalog](https://github.com/ahmedkhaleel2004/portfolio/blob/main/lib/experience.ts): `lib/experience.ts`
- [Site Configuration](https://github.com/ahmedkhaleel2004/portfolio/blob/main/lib/site.ts): `lib/site.ts`

### Interactive UI

- [Project Previews](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/PreviewTooltip.tsx): `app/components/PreviewTooltip.tsx`
- [Email Copying](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/CopyEmail.tsx): `app/components/CopyEmail.tsx`
- [Word Cycling](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/ClientWord.tsx): `app/components/ClientWord.tsx`
- [Skills Browser](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/ClientTechView.tsx): `app/components/ClientTechView.tsx`
- [Skills Sections](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/TechSection.tsx): `app/components/TechSection.tsx`

### Navigation

- [Site Navigation](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/Navbar.tsx): `app/components/Navbar.tsx`
- [Navigation Button](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/ClientNavButton.tsx): `app/components/ClientNavButton.tsx`
- [Site Footer](https://github.com/ahmedkhaleel2004/portfolio/blob/main/app/components/Footer.tsx): `app/components/Footer.tsx`

### Other components

- **Portfolio Visitor**
- **External Destinations**

## Connections

- Portfolio Visitor → Route Proxy: requests
- Portfolio Visitor → Portfolio Home: visits
- Portfolio Visitor → Legacy Pages: visits
- Route Proxy → Site Shell: passes request
- Portfolio Home → Project Catalog: reads projects
- Portfolio Home → Experience Catalog: reads experience
- Portfolio Home → Site Configuration: reads profile
- Portfolio Home → Project Previews: renders previews
- Portfolio Home → Email Copying: renders contact
- Portfolio Home → External Destinations: links projects
- Site Shell → Site Navigation: renders navigation
- Site Shell → Site Footer: renders footer
- Site Navigation → Navigation Button: renders buttons
- Legacy Pages → Word Cycling: renders cycling text
- Legacy Pages → Skills Browser: renders skills
- Skills Browser → Skills Sections: shows section
