# kawser0x/portfolio architecture

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

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

## Overview

This is a personal software-engineer portfolio: visitors browse an assembled home page or dedicated profile sections, inspect skills and featured projects, and can initiate contact. The App Router home module composes the main sections; the root layout supplies shared navigation and footer. Contact submission in the sampled component posts to Web3Forms, while a separate contact API route exists in the tree. The README also documents theme persistence and competitive-programming highlights. Some route and API internals were not excerpted, so connections to them are limited to visible imports or documented behavior.

Main entry points: [`src/component/Navbar.jsx`](https://github.com/kawser0x/portfolio/blob/main/src/component/Navbar.jsx) (Navigation and theme), [`src/app/page.js`](https://github.com/kawser0x/portfolio/blob/main/src/app/page.js) (Home composition), [`src/app/layout.js`](https://github.com/kawser0x/portfolio/blob/main/src/app/layout.js) (Root layout), [`src/app/hero/page.jsx`](https://github.com/kawser0x/portfolio/blob/main/src/app/hero/page.jsx) (Hero and profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Shared site shell"]
  node_layout["Root layout<br/>[layout.js]"]
  node_navbar["Navigation and theme<br/>[Navbar.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_browser_storage[("Browser localStorage")]
end

subgraph group_portfolio["Portfolio content"]
  node_home["Home composition<br/>[page.js]"]
  node_hero["Hero and profiles<br/>[page.jsx]"]
  node_approach["Work approach<br/>[Approach.jsx]"]
  node_about["About page<br/>[page.jsx]"]
  node_skills["Skills showcase<br/>[Skills.jsx]"]
  node_skills_page["Skills route<br/>[page.jsx]"]
  node_projects["Project showcase<br/>[Projects.jsx]"]
  node_projects_page["Projects route<br/>[page.jsx]"]
end

subgraph group_contact["Contact flow"]
  node_contact_page["Contact route<br/>[page.jsx]"]
  node_contact["Contact form and details<br/>[Contact.jsx]"]
  node_web3forms["Web3Forms"]
  node_contact_api["Contact API route<br/>[route.js]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens site"| node_layout
node_layout -->|"renders"| node_navbar
node_layout -->|"renders"| node_footer
node_layout -->|"wraps route"| node_home
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_approach
node_home -->|"renders"| node_skills
node_home -->|"renders"| node_projects
node_home -->|"renders"| node_contact
node_navbar -->|"reads and writes theme"| node_browser_storage
node_hero -->|"links to"| node_projects_page
node_hero -->|"links to"| node_contact_page
node_navbar -->|"links to"| node_about
node_navbar -->|"links to"| node_skills_page
node_navbar -->|"links to"| node_projects_page
node_navbar -->|"links to"| node_contact_page
node_skills_page -->|"renders"| node_skills
node_projects_page -->|"renders"| node_projects
node_contact_page -->|"renders"| node_contact
node_contact -->|"posts submission"| node_web3forms

click node_layout "https://github.com/kawser0x/portfolio/blob/main/src/app/layout.js"
click node_navbar "https://github.com/kawser0x/portfolio/blob/main/src/component/Navbar.jsx"
click node_footer "https://github.com/kawser0x/portfolio/blob/main/src/component/Footer.jsx"
click node_home "https://github.com/kawser0x/portfolio/blob/main/src/app/page.js"
click node_hero "https://github.com/kawser0x/portfolio/blob/main/src/app/hero/page.jsx"
click node_approach "https://github.com/kawser0x/portfolio/blob/main/src/component/Approach.jsx"
click node_about "https://github.com/kawser0x/portfolio/blob/main/src/app/about/page.jsx"
click node_skills "https://github.com/kawser0x/portfolio/blob/main/src/component/Skills.jsx"
click node_skills_page "https://github.com/kawser0x/portfolio/blob/main/src/app/skills/page.jsx"
click node_projects "https://github.com/kawser0x/portfolio/blob/main/src/component/Projects.jsx"
click node_projects_page "https://github.com/kawser0x/portfolio/blob/main/src/app/projects/page.jsx"
click node_contact_page "https://github.com/kawser0x/portfolio/blob/main/src/app/contact/page.jsx"
click node_contact "https://github.com/kawser0x/portfolio/blob/main/src/component/Contact.jsx"
click node_contact_api "https://github.com/kawser0x/portfolio/blob/main/src/app/api/contact/route.js"

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_layout,node_navbar,node_footer,node_browser_storage toneBlue
class node_home,node_hero,node_approach,node_about,node_skills,node_skills_page,node_projects,node_projects_page toneAmber
class node_contact_page,node_contact,node_web3forms,node_contact_api toneMint
class node_visitor toneIndigo
```

## Components

### Shared site shell

- [Root layout](https://github.com/kawser0x/portfolio/blob/main/src/app/layout.js): `src/app/layout.js`
- [Navigation and theme](https://github.com/kawser0x/portfolio/blob/main/src/component/Navbar.jsx): `src/component/Navbar.jsx`
- [Footer](https://github.com/kawser0x/portfolio/blob/main/src/component/Footer.jsx): `src/component/Footer.jsx`
- **Browser localStorage**

### Portfolio content

- [Home composition](https://github.com/kawser0x/portfolio/blob/main/src/app/page.js): `src/app/page.js`
- [Hero and profiles](https://github.com/kawser0x/portfolio/blob/main/src/app/hero/page.jsx): `src/app/hero/page.jsx`
- [Work approach](https://github.com/kawser0x/portfolio/blob/main/src/component/Approach.jsx): `src/component/Approach.jsx`
- [About page](https://github.com/kawser0x/portfolio/blob/main/src/app/about/page.jsx): `src/app/about/page.jsx`
- [Skills showcase](https://github.com/kawser0x/portfolio/blob/main/src/component/Skills.jsx): `src/component/Skills.jsx`
- [Skills route](https://github.com/kawser0x/portfolio/blob/main/src/app/skills/page.jsx): `src/app/skills/page.jsx`
- [Project showcase](https://github.com/kawser0x/portfolio/blob/main/src/component/Projects.jsx): `src/component/Projects.jsx`
- [Projects route](https://github.com/kawser0x/portfolio/blob/main/src/app/projects/page.jsx): `src/app/projects/page.jsx`

### Contact flow

- [Contact route](https://github.com/kawser0x/portfolio/blob/main/src/app/contact/page.jsx): `src/app/contact/page.jsx`
- [Contact form and details](https://github.com/kawser0x/portfolio/blob/main/src/component/Contact.jsx): `src/component/Contact.jsx`
- **Web3Forms**
- [Contact API route](https://github.com/kawser0x/portfolio/blob/main/src/app/api/contact/route.js): `src/app/api/contact/route.js`

### Other components

- **Visitor**

## Connections

- Visitor → Root layout: opens site (evidence: `src/app/layout.js`)
- Root layout → Navigation and theme: renders (evidence: `src/app/layout.js`)
- Root layout → Footer: renders (evidence: `src/app/layout.js`)
- Root layout → Home composition: wraps route (evidence: `src/app/layout.js`)
- Home composition → Hero and profiles: renders (evidence: `src/app/page.js`)
- Home composition → Work approach: renders (evidence: `src/app/page.js`)
- Home composition → Skills showcase: renders (evidence: `src/app/page.js`)
- Home composition → Project showcase: renders (evidence: `src/app/page.js`)
- Home composition → Contact form and details: renders (evidence: `src/app/page.js`)
- Navigation and theme → Browser localStorage: reads and writes theme (evidence: `src/component/Navbar.jsx`)
- Hero and profiles → Projects route: links to (evidence: `src/app/hero/page.jsx`)
- Hero and profiles → Contact route: links to (evidence: `src/app/hero/page.jsx`)
- Navigation and theme → About page: links to (evidence: `src/component/Navbar.jsx`)
- Navigation and theme → Skills route: links to (evidence: `src/component/Navbar.jsx`)
- Navigation and theme → Projects route: links to (evidence: `src/component/Navbar.jsx`)
- Navigation and theme → Contact route: links to (evidence: `src/component/Navbar.jsx`)
- Skills route → Skills showcase: renders (evidence: `src/app/skills/page.jsx`)
- Projects route → Project showcase: renders (evidence: `src/app/projects/page.jsx`)
- Contact route → Contact form and details: renders (evidence: `src/app/contact/page.jsx`)
- Contact form and details → Web3Forms: posts submission (evidence: `src/component/Contact.jsx`)
