# aali2k7/portfolio architecture

> Architecture diagram of the GitHub repository aali2k7/portfolio, 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/aali2k7/portfolio
- Repository: https://github.com/aali2k7/portfolio

## Overview

This is a Next.js personal portfolio presenting Aali Rahman’s identity, cinematic introduction, engineering work, career, research, skills, personal interests, milestones, and contact links. A visitor enters the home page, encounters the scroll-driven hero, then browses editorial sections and follows project, publication, or contact links. The graph reflects the page composition and source-index references; unsampled sections are represented by their documented subsystem paths, without asserting unverified internal behavior.

Main entry points: [`app/page.tsx`](https://github.com/aali2k7/portfolio/blob/main/app/page.tsx) (Home composition), [`data/siteConfig.ts`](https://github.com/aali2k7/portfolio/blob/main/data/siteConfig.ts) (Site configuration), [`components/hero/HeroSection.tsx`](https://github.com/aali2k7/portfolio/blob/main/components/hero/HeroSection.tsx) (Cinematic hero), [`components/editorial/EditorialProjectsSection.tsx`](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialProjectsSection.tsx) (Project showcase)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and motion"]
  node_home["Home composition<br/>[page.tsx]"]
  node_scroll["Smooth scrolling"]
end

subgraph group_identity["Identity and navigation"]
  node_hero["Cinematic hero<br/>[HeroSection.tsx]"]
  node_hero_video["Hero background video"]
  node_signature["Signature reveal"]
  node_header["Header navigation<br/>[Header.tsx]"]
  node_menu["Fullscreen menu<br/>[FullscreenMenu.tsx]"]
end

subgraph group_portfolio["Portfolio showcases"]
  node_intro["Editorial introduction"]
  node_projects["Project showcase"]
  node_project_chapter["Project chapter<br/>[ProjectChapter.tsx]"]
  node_experience["Experience timeline"]
  node_research["Research publication"]
  node_stack["Technical stack"]
  node_perspective["Personal perspective"]
  node_milestones["Milestones"]
  node_contact["Contact section"]
end

subgraph group_content["Portfolio content data"]
  node_site_config["Site configuration<br/>[siteConfig.ts]"]
  node_project_data["Project data<br/>[projects.ts]"]
  node_experience_data["Experience data<br/>[experience.ts]"]
  node_research_data["Research data<br/>[research.ts]"]
  node_stack_data["Stack data<br/>[stack.ts]"]
  node_personal_data["Personal data<br/>[personal.ts]"]
  node_portfolio_types["Portfolio types<br/>[portfolio.ts]"]
end

node_visitor(("Visitor"))
node_doi(("Publication DOI"))

node_visitor -->|"opens"| node_home
node_home -->|"wraps page"| node_scroll
node_home -->|"renders"| node_header
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_intro
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_experience
node_home -->|"renders"| node_research
node_home -->|"renders"| node_stack
node_home -->|"renders"| node_perspective
node_home -->|"renders"| node_milestones
node_home -->|"renders"| node_contact
node_hero -->|"renders"| node_hero_video
node_hero -->|"renders"| node_signature
node_header -->|"renders"| node_menu
node_hero -->|"reads config"| node_site_config
node_menu -->|"reads config"| node_site_config
node_intro -->|"reads config"| node_site_config
node_projects -->|"reads projects"| node_project_data
node_projects -->|"renders chapters"| node_project_chapter
node_experience -->|"reads timeline"| node_experience_data
node_research -->|"reads publication"| node_research_data
node_stack -->|"reads skills"| node_stack_data
node_perspective -->|"reads interests"| node_personal_data
node_milestones -->|"reads milestones"| node_personal_data
node_contact -->|"reads config"| node_site_config
node_project_data -->|"uses types"| node_portfolio_types
node_site_config -->|"uses types"| node_portfolio_types
node_research -->|"links paper"| node_doi

click node_home "https://github.com/aali2k7/portfolio/blob/main/app/page.tsx"
click node_scroll "https://github.com/aali2k7/portfolio/blob/main/components/common/SmoothScrollProvider.tsx"
click node_hero "https://github.com/aali2k7/portfolio/blob/main/components/hero/HeroSection.tsx"
click node_hero_video "https://github.com/aali2k7/portfolio/blob/main/components/hero/HeroBackgroundVideo.tsx"
click node_signature "https://github.com/aali2k7/portfolio/blob/main/components/signature/SignatureReveal.tsx"
click node_header "https://github.com/aali2k7/portfolio/blob/main/components/navigation/Header.tsx"
click node_menu "https://github.com/aali2k7/portfolio/blob/main/components/navigation/FullscreenMenu.tsx"
click node_intro "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialIntroSection.tsx"
click node_projects "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialProjectsSection.tsx"
click node_project_chapter "https://github.com/aali2k7/portfolio/blob/main/components/projects/ProjectChapter.tsx"
click node_experience "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialExperienceSection.tsx"
click node_research "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialResearchSection.tsx"
click node_stack "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialStackSection.tsx"
click node_perspective "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialPerspectiveSection.tsx"
click node_milestones "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialMilestonesSection.tsx"
click node_contact "https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialContactSection.tsx"
click node_site_config "https://github.com/aali2k7/portfolio/blob/main/data/siteConfig.ts"
click node_project_data "https://github.com/aali2k7/portfolio/blob/main/data/projects.ts"
click node_experience_data "https://github.com/aali2k7/portfolio/blob/main/data/experience.ts"
click node_research_data "https://github.com/aali2k7/portfolio/blob/main/data/research.ts"
click node_stack_data "https://github.com/aali2k7/portfolio/blob/main/data/stack.ts"
click node_personal_data "https://github.com/aali2k7/portfolio/blob/main/data/personal.ts"
click node_portfolio_types "https://github.com/aali2k7/portfolio/blob/main/types/portfolio.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_scroll toneBlue
class node_hero,node_hero_video,node_signature,node_header,node_menu toneAmber
class node_intro,node_projects,node_project_chapter,node_experience,node_research,node_stack,node_perspective,node_milestones,node_contact toneMint
class node_site_config,node_project_data,node_experience_data,node_research_data,node_stack_data,node_personal_data,node_portfolio_types toneRose
class node_visitor,node_doi toneIndigo
```

## Components

### Entry and motion

- [Home composition](https://github.com/aali2k7/portfolio/blob/main/app/page.tsx): `app/page.tsx`
- [Smooth scrolling](https://github.com/aali2k7/portfolio/blob/main/components/common/SmoothScrollProvider.tsx): `components/common/SmoothScrollProvider.tsx`

### Identity and navigation

- [Cinematic hero](https://github.com/aali2k7/portfolio/blob/main/components/hero/HeroSection.tsx): `components/hero/HeroSection.tsx`
- [Hero background video](https://github.com/aali2k7/portfolio/blob/main/components/hero/HeroBackgroundVideo.tsx): `components/hero/HeroBackgroundVideo.tsx`
- [Signature reveal](https://github.com/aali2k7/portfolio/blob/main/components/signature/SignatureReveal.tsx): `components/signature/SignatureReveal.tsx`
- [Header navigation](https://github.com/aali2k7/portfolio/blob/main/components/navigation/Header.tsx): `components/navigation/Header.tsx`
- [Fullscreen menu](https://github.com/aali2k7/portfolio/blob/main/components/navigation/FullscreenMenu.tsx): `components/navigation/FullscreenMenu.tsx`

### Portfolio showcases

- [Editorial introduction](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialIntroSection.tsx): `components/editorial/EditorialIntroSection.tsx`
- [Project showcase](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialProjectsSection.tsx): `components/editorial/EditorialProjectsSection.tsx`
- [Project chapter](https://github.com/aali2k7/portfolio/blob/main/components/projects/ProjectChapter.tsx): `components/projects/ProjectChapter.tsx`
- [Experience timeline](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialExperienceSection.tsx): `components/editorial/EditorialExperienceSection.tsx`
- [Research publication](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialResearchSection.tsx): `components/editorial/EditorialResearchSection.tsx`
- [Technical stack](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialStackSection.tsx): `components/editorial/EditorialStackSection.tsx`
- [Personal perspective](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialPerspectiveSection.tsx): `components/editorial/EditorialPerspectiveSection.tsx`
- [Milestones](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialMilestonesSection.tsx): `components/editorial/EditorialMilestonesSection.tsx`
- [Contact section](https://github.com/aali2k7/portfolio/blob/main/components/editorial/EditorialContactSection.tsx): `components/editorial/EditorialContactSection.tsx`

### Portfolio content data

- [Site configuration](https://github.com/aali2k7/portfolio/blob/main/data/siteConfig.ts): `data/siteConfig.ts`
- [Project data](https://github.com/aali2k7/portfolio/blob/main/data/projects.ts): `data/projects.ts`
- [Experience data](https://github.com/aali2k7/portfolio/blob/main/data/experience.ts): `data/experience.ts`
- [Research data](https://github.com/aali2k7/portfolio/blob/main/data/research.ts): `data/research.ts`
- [Stack data](https://github.com/aali2k7/portfolio/blob/main/data/stack.ts): `data/stack.ts`
- [Personal data](https://github.com/aali2k7/portfolio/blob/main/data/personal.ts): `data/personal.ts`
- [Portfolio types](https://github.com/aali2k7/portfolio/blob/main/types/portfolio.ts): `types/portfolio.ts`

### Other components

- **Visitor**
- **Publication DOI**

## Connections

- Visitor → Home composition: opens (evidence: `README.md`)
- Home composition → Smooth scrolling: wraps page (evidence: `app/page.tsx`)
- Home composition → Header navigation: renders (evidence: `app/page.tsx`)
- Home composition → Cinematic hero: renders (evidence: `app/page.tsx`)
- Home composition → Editorial introduction: renders (evidence: `app/page.tsx`)
- Home composition → Project showcase: renders (evidence: `app/page.tsx`)
- Home composition → Experience timeline: renders (evidence: `app/page.tsx`)
- Home composition → Research publication: renders (evidence: `app/page.tsx`)
- Home composition → Technical stack: renders (evidence: `app/page.tsx`)
- Home composition → Personal perspective: renders (evidence: `app/page.tsx`)
- Home composition → Milestones: renders (evidence: `app/page.tsx`)
- Home composition → Contact section: renders (evidence: `app/page.tsx`)
- Cinematic hero → Hero background video: renders (evidence: `components/hero/HeroSection.tsx`)
- Cinematic hero → Signature reveal: renders (evidence: `components/hero/HeroSection.tsx`)
- Header navigation → Fullscreen menu: renders (evidence: `components/navigation/Header.tsx`)
- Cinematic hero → Site configuration: reads config (evidence: `components/hero/HeroSection.tsx`)
- Fullscreen menu → Site configuration: reads config (evidence: `components/navigation/FullscreenMenu.tsx`)
- Editorial introduction → Site configuration: reads config (evidence: `components/editorial/EditorialIntroSection.tsx`)
- Project showcase → Project data: reads projects (evidence: `components/editorial/EditorialProjectsSection.tsx`)
- Project showcase → Project chapter: renders chapters
- Experience timeline → Experience data: reads timeline (evidence: `components/editorial/EditorialExperienceSection.tsx`)
- Research publication → Research data: reads publication (evidence: `components/editorial/EditorialResearchSection.tsx`)
- Technical stack → Stack data: reads skills (evidence: `components/editorial/EditorialStackSection.tsx`)
- Personal perspective → Personal data: reads interests (evidence: `components/editorial/EditorialPerspectiveSection.tsx`)
- Milestones → Personal data: reads milestones (evidence: `components/editorial/EditorialMilestonesSection.tsx`)
- Contact section → Site configuration: reads config (evidence: `components/editorial/EditorialContactSection.tsx`)
- Project data → Portfolio types: uses types (evidence: `data/projects.ts`)
- Site configuration → Portfolio types: uses types (evidence: `data/siteConfig.ts`)
- Research publication → Publication DOI: links paper (evidence: `components/editorial/EditorialResearchSection.tsx`)
