# muhammadnoman2/my-portfolio architecture

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

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

## Overview

1. This repository is a Next.js App Router project for a largely single-page, content-driven site. The file structure suggests a portfolio/marketing-style experience rather than a multi-page CRUD app or backend service.

2. The top-level application boundary is `app/`. `app/layout.tsx` defines the root shell and global metadata/styling, `app/page.tsx` is the main composition point, and `app/globals.css` provides the global theme/reset layer. In architecture terms, the page is assembled from reusable sections inside a single route.

3. The primary UI is broken into section modules under `components/sections/`: `Hero`, `About`, `Skills`, `Experience`, `Projects`, `Testimonials`, and `Contact`. These are the main content domains that would appear as blocks on the page and are the key units to use when drawing the page structure.

4. Shared content is centralized in `constants/data.ts`. That file likely serves as the content/data source for multiple sections, keeping copy, lists, and card data out of the visual components. This is the main data flow: constants feed sections, sections render UI.

5. The design system is split into two layers:
   - `components/ui/` contains reusable primitives like `button`, `card`, `input`, `textarea`, `badge`, and `separator`.
   - `components/icons.tsx` centralizes iconography.
   This is consistent with a shadcn/ui-style component setup, supported by `components.json`.

6. Motion and interaction are a distinct subsystem. `components/animations/` contains reusable animation wrappers and effects such as `AnimatedSection`, `Reveal`, `StaggerContainer`, `AnimeHeading`, `AnimeCounter`, and `MagneticButton`. These are likely used by the section components to add entrance animations and micro-interactions.

7. There is also a dedicated motion utility layer in `lib/motion.ts`, which likely holds shared animation variants/configuration, and `hooks/useLenis.ts`, which suggests smooth scrolling behavior via Lenis. This means scrolling/animation behavior is intentionally abstracted away from page content.

8. The layout/chrome is separated into `components/layout/Navbar.tsx` and `components/layout/Footer.tsx`. These frame the page and likely provide section navigation and site identity, while the main content remains inside the section components.

9. `components/ui/SkillTicker.tsx` is a specialized presentation component used by the skills area. It indicates that the skills section is not just static text; it includes an animated or continuously scrolling visual element.

10. The `Contact` section includes form primitives from `components/ui/input.tsx` and `textarea.tsx`, but there is no API route or server action visible in the tree. Architecturally, that means contact handling is either purely client-side, uses an external service, or is incomplete in this repo snapshot.

11. Static/SEO assets are in `public/manifest.json`, `robots.txt`, and `sitemap.xml`. That indicates the site is configured for discoverability and possibly PWA/browser metadata, which is important when diagramming the deployment surface.

12. Tooling and runtime boundaries are standard Next.js/TypeScript:
   - TypeScript config in `tsconfig.json`
   - linting via `eslint.config.mjs`
   - styling via `postcss.config.mjs`
   - build/runtime via Next.js in the Node/Vercel ecosystem
   The README also references `next/font`, so font loading is handled by the framework rather than custom CSS assets.

13. Deployment automation exists in `.github/workflows/deploy.yml`, so there is a CI/CD path independent of local development. The README points to Vercel as the primary deployment target, so the likely production flow is GitHub push → workflow/build → Vercel-hosted site.

14. Overall, the architecture is best drawn as: a thin Next.js application shell, a single-page composition layer, shared content/constants, reusable UI primitives, and a separate animation/smooth-scroll subsystem. There is no visible database, server API, or external data ingestion layer, so the system is mostly static/presentation-focused.

Main entry points: [`app/page.tsx`](https://github.com/muhammadnoman2/my-portfolio/blob/main/app/page.tsx) (Home page), [`constants/data.ts`](https://github.com/muhammadnoman2/my-portfolio/blob/main/constants/data.ts) (Content data), [`components/animations/AnimatedSection.tsx`](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/animations/AnimatedSection.tsx) (Animations), [`app/layout.tsx`](https://github.com/muhammadnoman2/my-portfolio/blob/main/app/layout.tsx) (Root layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_app["App shell"]
  node_node_layout["Root layout<br/>Next.js layout<br/>[layout.tsx]"]
  node_node_page["Home page<br/>Route composition<br/>[page.tsx]"]
  node_node_globals["Global styles<br/>CSS theme<br/>[globals.css]"]
end

subgraph group_group_content["Page content"]
  node_node_navbar["Navbar<br/>Layout chrome<br/>[Navbar.tsx]"]
  node_node_footer["Footer<br/>Layout chrome<br/>[Footer.tsx]"]
  node_node_hero["Hero<br/>Section<br/>[Hero.tsx]"]
  node_node_about["About<br/>Section<br/>[About.tsx]"]
  node_node_skills["Skills<br/>Section<br/>[Skills.tsx]"]
  node_node_experience["Experience<br/>Section<br/>[Experience.tsx]"]
  node_node_projects["Projects<br/>Section<br/>[Projects.tsx]"]
  node_node_testimonials["Testimonials<br/>Section<br/>[Testimonials.tsx]"]
  node_node_contact["Contact<br/>Section<br/>[Contact.tsx]"]
end

subgraph group_group_ui["Shared UI"]
  node_node_data["Content data<br/>Shared content<br/>[data.ts]"]
  node_node_skillticker["Skill ticker<br/>Animated widget<br/>[SkillTicker.tsx]"]
  node_node_ui_primitives["UI primitives<br/>Component kit<br/>[button.tsx]"]
  node_node_icons["Icons<br/>Icon set<br/>[icons.tsx]"]
end

subgraph group_group_motion["Motion layer"]
  node_node_animations["Animations<br/>Motion components"]
  node_node_motion["Motion config<br/>Motion utilities<br/>[motion.ts]"]
  node_node_lenis["Smooth scroll<br/>Scroll hook<br/>[useLenis.ts]"]
end

subgraph group_group_support["Support"]
  node_node_manifest["Web manifest<br/>PWA metadata<br/>[manifest.json]"]
  node_node_ci["Deploy workflow<br/>CI/CD<br/>[deploy.yml]"]
end

node_node_layout -->|"loads"| node_node_globals
node_node_layout -->|"wraps"| node_node_page
node_node_page -->|"includes"| node_node_navbar
node_node_page -->|"includes"| node_node_hero
node_node_page -->|"includes"| node_node_about
node_node_page -->|"includes"| node_node_skills
node_node_page -->|"includes"| node_node_experience
node_node_page -->|"includes"| node_node_projects
node_node_page -->|"includes"| node_node_testimonials
node_node_page -->|"includes"| node_node_contact
node_node_page -->|"includes"| node_node_footer
node_node_hero -->|"reads"| node_node_data
node_node_about -->|"reads"| node_node_data
node_node_skills -->|"reads"| node_node_data
node_node_skills -->|"uses"| node_node_skillticker
node_node_experience -->|"reads"| node_node_data
node_node_projects -->|"reads"| node_node_data
node_node_testimonials -->|"reads"| node_node_data
node_node_contact -->|"uses"| node_node_ui_primitives
node_node_contact -->|"reads"| node_node_data
node_node_navbar -->|"uses"| node_node_animations
node_node_hero -->|"uses"| node_node_animations
node_node_skills -->|"uses"| node_node_animations
node_node_projects -->|"uses"| node_node_animations
node_node_contact -->|"uses"| node_node_animations
node_node_animations -->|"relies on"| node_node_motion
node_node_lenis -->|"coordinates"| node_node_motion
node_node_page -->|"enables"| node_node_lenis
node_node_layout -->|"publishes"| node_node_manifest
node_node_layout -->|"shares"| node_node_icons
node_node_ci -->|"builds"| node_node_page

click node_node_layout "https://github.com/muhammadnoman2/my-portfolio/blob/main/app/layout.tsx"
click node_node_page "https://github.com/muhammadnoman2/my-portfolio/blob/main/app/page.tsx"
click node_node_globals "https://github.com/muhammadnoman2/my-portfolio/blob/main/app/globals.css"
click node_node_navbar "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/layout/Navbar.tsx"
click node_node_footer "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/layout/Footer.tsx"
click node_node_hero "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Hero.tsx"
click node_node_about "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/About.tsx"
click node_node_skills "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Skills.tsx"
click node_node_experience "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Experience.tsx"
click node_node_projects "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Projects.tsx"
click node_node_testimonials "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Testimonials.tsx"
click node_node_contact "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Contact.tsx"
click node_node_data "https://github.com/muhammadnoman2/my-portfolio/blob/main/constants/data.ts"
click node_node_skillticker "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/ui/SkillTicker.tsx"
click node_node_ui_primitives "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/ui/button.tsx"
click node_node_icons "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/icons.tsx"
click node_node_animations "https://github.com/muhammadnoman2/my-portfolio/blob/main/components/animations/AnimatedSection.tsx"
click node_node_motion "https://github.com/muhammadnoman2/my-portfolio/blob/main/lib/motion.ts"
click node_node_lenis "https://github.com/muhammadnoman2/my-portfolio/blob/main/hooks/useLenis.ts"
click node_node_manifest "https://github.com/muhammadnoman2/my-portfolio/blob/main/public/manifest.json"
click node_node_ci "https://github.com/muhammadnoman2/my-portfolio/blob/main/.github/workflows/deploy.yml"

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_node_layout,node_node_page,node_node_globals toneBlue
class node_node_navbar,node_node_footer,node_node_hero,node_node_about,node_node_skills,node_node_experience,node_node_projects,node_node_testimonials,node_node_contact toneAmber
class node_node_data,node_node_skillticker,node_node_ui_primitives,node_node_icons toneMint
class node_node_animations,node_node_motion,node_node_lenis toneRose
class node_node_manifest,node_node_ci toneIndigo
```

## Components

### App shell

Next.js App Router entry points and global styling.

- [Root layout](https://github.com/muhammadnoman2/my-portfolio/blob/main/app/layout.tsx): Next.js layout · Defines the global shell, metadata, and shared styling for the app. · `app/layout.tsx`
- [Home page](https://github.com/muhammadnoman2/my-portfolio/blob/main/app/page.tsx): Route composition · Assembles the single-page experience from shared sections. · `app/page.tsx`
- [Global styles](https://github.com/muhammadnoman2/my-portfolio/blob/main/app/globals.css): CSS theme · Global reset and site-wide styling layer. · `app/globals.css`

### Page content

Single-page sections that make up the portfolio experience.

- [Navbar](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/layout/Navbar.tsx): Layout chrome · Top-level navigation and site identity chrome. · `components/layout/Navbar.tsx`
- [Footer](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/layout/Footer.tsx): Layout chrome · Bottom page chrome and closing site information. · `components/layout/Footer.tsx`
- [Hero](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Hero.tsx): Section · Opening section and primary visual introduction. · `components/sections/Hero.tsx`
- [About](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/About.tsx): Section · Personal background and summary content block. · `components/sections/About.tsx`
- [Skills](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Skills.tsx): Section · Capabilities showcase with animated skill presentation. · `components/sections/Skills.tsx`
- [Experience](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Experience.tsx): Section · Work history and timeline-style content. · `components/sections/Experience.tsx`
- [Projects](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Projects.tsx): Section · Portfolio/project showcase content. · `components/sections/Projects.tsx`
- [Testimonials](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Testimonials.tsx): Section · Quotes and social proof content. · `components/sections/Testimonials.tsx`
- [Contact](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/sections/Contact.tsx): Section · Contact form and outreach call-to-action. · `components/sections/Contact.tsx`

### Shared UI

Reusable presentation primitives and data-driven UI pieces.

- [Content data](https://github.com/muhammadnoman2/my-portfolio/blob/main/constants/data.ts): Shared content · Central content source consumed by multiple sections. · `constants/data.ts`
- [Skill ticker](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/ui/SkillTicker.tsx): Animated widget · Specialized skills presentation component. · `components/ui/SkillTicker.tsx`
- [UI primitives](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/ui/button.tsx): Component kit · Reusable shadcn-style inputs, buttons, cards, badges, separators, and textarea. · `components/ui/button.tsx`
- [Icons](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/icons.tsx): Icon set · Centralized iconography used across the site. · `components/icons.tsx`

### Motion layer

Animation wrappers and scroll/motion utilities.

- [Animations](https://github.com/muhammadnoman2/my-portfolio/blob/main/components/animations/AnimatedSection.tsx): Motion components · Reusable animation wrappers and interaction effects. · `components/animations/AnimatedSection.tsx`
- [Motion config](https://github.com/muhammadnoman2/my-portfolio/blob/main/lib/motion.ts): Motion utilities · Shared animation variants and motion helpers. · `lib/motion.ts`
- [Smooth scroll](https://github.com/muhammadnoman2/my-portfolio/blob/main/hooks/useLenis.ts): Scroll hook · Lenis-based smooth scrolling behavior. · `hooks/useLenis.ts`

### Support

Metadata, icons, and deployment/tooling boundaries.

- [Web manifest](https://github.com/muhammadnoman2/my-portfolio/blob/main/public/manifest.json): PWA metadata · Public manifest and site discovery metadata. · `public/manifest.json`
- [Deploy workflow](https://github.com/muhammadnoman2/my-portfolio/blob/main/.github/workflows/deploy.yml): CI/CD · GitHub Actions deployment automation. · `.github/workflows/deploy.yml`

## Connections

- Root layout → Global styles: loads · Root layout applies the global stylesheet.
- Root layout → Home page: wraps · Layout provides the shell around the home route.
- Home page → Navbar: includes · Home page composes the navigation chrome.
- Home page → Hero: includes · Hero is the first major section on the page.
- Home page → About: includes · About section is part of the single-page flow.
- Home page → Skills: includes · Skills section is part of the single-page flow.
- Home page → Experience: includes · Experience section is part of the single-page flow.
- Home page → Projects: includes · Projects section is part of the single-page flow.
- Home page → Testimonials: includes · Testimonials section is part of the single-page flow.
- Home page → Contact: includes · Contact section closes the page content.
- Home page → Footer: includes · Footer anchors the bottom of the page.
- Hero → Content data: reads · Hero content is sourced from shared constants.
- About → Content data: reads · About section uses centralized copy/data.
- Skills → Content data: reads · Skills section uses shared skill and profile data.
- Skills → Skill ticker: uses · Skills section uses the ticker presentation component.
- Experience → Content data: reads · Experience section is driven by shared content.
- Projects → Content data: reads · Projects section is driven by shared content.
- Testimonials → Content data: reads · Testimonials section is driven by shared content.
- Contact → UI primitives: uses · Contact form uses shared input and textarea primitives.
- Contact → Content data: reads · Contact section may use shared contact details or copy.
- Navbar → Animations: uses · Navigation likely uses shared motion wrappers or effects.
- Hero → Animations: uses · Hero uses motion wrappers for entrance and emphasis.
- Skills → Animations: uses · Skills section uses motion-enhanced UI elements.
- Projects → Animations: uses · Projects section uses motion wrappers for reveal effects.
- Contact → Animations: uses · Contact section uses animated interactions where needed.
- Animations → Motion config: relies on · Animation components use shared motion config.
- Smooth scroll → Motion config: coordinates · Smooth scroll behavior is part of the motion layer.
- Home page → Smooth scroll: enables · Page experience is expected to use smooth scrolling.
- Root layout → Web manifest: publishes · App shell contributes to public metadata and manifest surface.
- Root layout → Icons: shares · Layout-level presentation may use centralized icons.
- Deploy workflow → Home page: builds · Deployment workflow builds and ships the Next.js app.
