# sikandarsubhani/sikandar-next-portfolio architecture

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

## Overview

This repository is a personal portfolio and blog site. Visitors browse a landing page of profile, skills, projects, and experience, can read MDX blog posts, and can submit a contact form to an API route. The graph separates page orchestration, portfolio content, blog rendering and parsing, and contact handling. Source evidence is strongest for the page imports, MDX calls, and contact request; unsampled route internals and other integrations are not inferred.

Main entry points: [`app/page.tsx`](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/page.tsx) (Home page), [`lib/mdx.ts`](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/lib/mdx.ts) (MDX post access), [`app/blog/page.tsx`](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/blog/page.tsx) (Blog index route), [`app/blog/[slug]/page.tsx`](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/blog/%5Bslug%5D/page.tsx) (Post detail route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Site presentation"]
  node_home["Home page<br/>[page.tsx]"]
  node_site_shell["Site shell<br/>[layout.tsx]"]
  node_navigation["Navigation<br/>[Navbar.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
end

subgraph group_portfolio["Portfolio content"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_skill_data["Skill data<br/>[skills.ts]"]
  node_projects["Projects<br/>[Projects.tsx]"]
  node_project_data["Project data<br/>[projects.ts]"]
  node_experience["Experience<br/>[Experience.tsx]"]
  node_experience_data["Experience data<br/>[experience.ts]"]
  node_home_blog["Blog section<br/>[Blog.tsx]"]
end

subgraph group_blog["Blog publishing"]
  node_blog_index["Blog index route<br/>[page.tsx]"]
  node_blog_list["Post listing<br/>[BlogList.tsx]"]
  node_blog_detail_route["Post detail route<br/>[page.tsx]"]
  node_blog_post["Post reader<br/>[BlogPost.tsx]"]
  node_mdx["MDX post access<br/>[mdx.ts]"]
  node_sitemap["Sitemap<br/>[sitemap.ts]"]
end

subgraph group_contact["Contact flow"]
  node_contact_form["Contact form<br/>[Contact.tsx]"]
  node_contact_api["Contact API<br/>[route.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"opens"| node_blog_index
node_visitor -->|"opens"| node_blog_detail_route
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_about
node_home -->|"renders"| node_skills
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_experience
node_home -->|"renders"| node_home_blog
node_home -->|"renders"| node_contact_form
node_site_shell -->|"renders"| node_navigation
node_site_shell -->|"renders"| node_footer
node_skills -->|"reads"| node_skill_data
node_projects -->|"reads"| node_project_data
node_experience -->|"reads"| node_experience_data
node_blog_index -->|"loads posts"| node_mdx
node_blog_index -->|"renders"| node_blog_list
node_blog_list -->|"uses post data"| node_mdx
node_blog_detail_route -->|"loads post"| node_mdx
node_blog_detail_route -->|"renders"| node_blog_post
node_blog_post -->|"uses post type"| node_mdx
node_sitemap -->|"reads posts"| node_mdx
node_contact_form -->|"posts form"| node_contact_api

click node_home "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/page.tsx"
click node_site_shell "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/layout.tsx"
click node_navigation "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/layout/Navbar.tsx"
click node_footer "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/layout/Footer.tsx"
click node_hero "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Hero.tsx"
click node_about "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/About.tsx"
click node_skills "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Skills.tsx"
click node_skill_data "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/data/skills.ts"
click node_projects "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Projects.tsx"
click node_project_data "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/data/projects.ts"
click node_experience "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Experience.tsx"
click node_experience_data "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/data/experience.ts"
click node_home_blog "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Blog.tsx"
click node_blog_index "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/blog/page.tsx"
click node_blog_list "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/blog/BlogList.tsx"
click node_blog_detail_route "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/blog/%5Bslug%5D/page.tsx"
click node_blog_post "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/blog/BlogPost.tsx"
click node_mdx "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/lib/mdx.ts"
click node_sitemap "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/sitemap.ts"
click node_contact_form "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Contact.tsx"
click node_contact_api "https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/api/contact/route.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_site_shell,node_navigation,node_footer toneBlue
class node_hero,node_about,node_skills,node_skill_data,node_projects,node_project_data,node_experience,node_experience_data,node_home_blog toneAmber
class node_blog_index,node_blog_list,node_blog_detail_route,node_blog_post,node_mdx,node_sitemap toneMint
class node_contact_form,node_contact_api toneRose
class node_visitor toneIndigo
```

## Components

### Site presentation

- [Home page](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/page.tsx): `app/page.tsx`
- [Site shell](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/layout.tsx): `app/layout.tsx`
- [Navigation](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/layout/Navbar.tsx): `components/layout/Navbar.tsx`
- [Footer](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/layout/Footer.tsx): `components/layout/Footer.tsx`

### Portfolio content

- [Hero](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Hero.tsx): `components/sections/Hero.tsx`
- [About](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/About.tsx): `components/sections/About.tsx`
- [Skills](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Skills.tsx): `components/sections/Skills.tsx`
- [Skill data](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/data/skills.ts): `data/skills.ts`
- [Projects](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Projects.tsx): `components/sections/Projects.tsx`
- [Project data](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/data/projects.ts): `data/projects.ts`
- [Experience](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Experience.tsx): `components/sections/Experience.tsx`
- [Experience data](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/data/experience.ts): `data/experience.ts`
- [Blog section](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Blog.tsx): `components/sections/Blog.tsx`

### Blog publishing

- [Blog index route](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/blog/page.tsx): `app/blog/page.tsx`
- [Post listing](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/blog/BlogList.tsx): `components/blog/BlogList.tsx`
- [Post detail route](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/blog/%5Bslug%5D/page.tsx): `app/blog/[slug]/page.tsx`
- [Post reader](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/blog/BlogPost.tsx): `components/blog/BlogPost.tsx`
- [MDX post access](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/lib/mdx.ts): `lib/mdx.ts`
- [Sitemap](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/sitemap.ts): `app/sitemap.ts`

### Contact flow

- [Contact form](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/components/sections/Contact.tsx): `components/sections/Contact.tsx`
- [Contact API](https://github.com/sikandarsubhani/sikandar-next-portfolio/blob/main/app/api/contact/route.ts): `app/api/contact/route.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Home page: opens (evidence: `app/page.tsx`)
- Visitor → Blog index route: opens (evidence: `app/blog/page.tsx`)
- Visitor → Post detail route: opens (evidence: `app/blog/[slug]/page.tsx`)
- Home page → Hero: renders (evidence: `app/page.tsx`)
- Home page → About: renders (evidence: `app/page.tsx`)
- Home page → Skills: renders (evidence: `app/page.tsx`)
- Home page → Projects: renders (evidence: `app/page.tsx`)
- Home page → Experience: renders (evidence: `app/page.tsx`)
- Home page → Blog section: renders (evidence: `app/page.tsx`)
- Home page → Contact form: renders (evidence: `app/page.tsx`)
- Site shell → Navigation: renders (evidence: `app/layout.tsx`)
- Site shell → Footer: renders (evidence: `app/layout.tsx`)
- Skills → Skill data: reads (evidence: `components/sections/Skills.tsx`)
- Projects → Project data: reads (evidence: `components/sections/Projects.tsx`)
- Experience → Experience data: reads (evidence: `components/sections/Experience.tsx`)
- Blog index route → MDX post access: loads posts (evidence: `app/blog/page.tsx`)
- Blog index route → Post listing: renders (evidence: `app/blog/page.tsx`)
- Post listing → MDX post access: uses post data (evidence: `components/blog/BlogList.tsx`)
- Post detail route → MDX post access: loads post (evidence: `app/blog/[slug]/page.tsx`)
- Post detail route → Post reader: renders (evidence: `app/blog/[slug]/page.tsx`)
- Post reader → MDX post access: uses post type (evidence: `components/blog/BlogPost.tsx`)
- Sitemap → MDX post access: reads posts (evidence: `app/sitemap.ts`)
- Contact form → Contact API: posts form (evidence: `components/sections/Contact.tsx`)
