# farhanchowdhury738/portfolio architecture

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

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

## Overview

This repository is a personal portfolio website. Visitors browse its sections, inspect project and resume details, read blog posts, and find contact information. The principal runtime workflow is the JavaScript portfolio controller loading portfolio data and initializing interactions; the separate blog module fetches and renders posts, including hash-based post details and sharing. The README documents responsive layout, themes, and navigation, but the excerpts do not show the HTML wiring for those features or the full section-loading calls.

Main entry points: [`js/main.js`](https://github.com/farhanchowdhury738/portfolio/blob/main/js/main.js) (Portfolio Controller), [`index.html`](https://github.com/farhanchowdhury738/portfolio/blob/main/index.html) (Portfolio Entry), [`js/blog.js`](https://github.com/farhanchowdhury738/portfolio/blob/main/js/blog.js) (Blog Renderer), [`components/navbar.html`](https://github.com/farhanchowdhury738/portfolio/blob/main/components/navbar.html) (Navigation Bar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio Site"]
  node_entry["Portfolio Entry<br/>[index.html]"]
  node_controller["Portfolio Controller<br/>[main.js]"]
  node_navbar["Navigation Bar<br/>[navbar.html]"]
  node_sidebar["Responsive Sidebar<br/>[sidebar.html]"]
  node_footer["Footer<br/>[footer.html]"]
end

subgraph group_portfolio["Portfolio Content"]
  node_home["Home Section<br/>[home.html]"]
  node_about["About Section<br/>[about.html]"]
  node_projects["Projects Section<br/>[projects.html]"]
  node_resume["Resume Section<br/>[resume.html]"]
  node_contact["Contact Section<br/>[contact.html]"]
end

subgraph group_blog["Blog"]
  node_blog_section["Blog Section<br/>[blog.html]"]
  node_blog_runtime["Blog Renderer<br/>[blog.js]"]
end

subgraph group_data["Content Data"]
  node_project_data["Project Records<br/>[projects.json]"]
  node_certificate_data["Certificates<br/>[certificates.json]"]
  node_volunteer_data["Volunteering Records<br/>[volunteering.json]"]
  node_post_data["Post Records<br/>[posts.json]"]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_entry
node_entry -.->|"initializes"| node_controller
node_controller -->|"fetches"| node_project_data
node_controller -->|"fetches"| node_certificate_data
node_controller -->|"fetches"| node_volunteer_data
node_controller -->|"invokes"| node_blog_runtime
node_blog_runtime -->|"fetches"| node_post_data
node_controller -.->|"loads"| node_home
node_controller -.->|"loads"| node_about
node_controller -.->|"loads"| node_projects
node_controller -.->|"loads"| node_resume
node_controller -.->|"loads"| node_contact
node_controller -.->|"loads"| node_blog_section
node_controller -.->|"loads"| node_navbar
node_controller -.->|"loads"| node_sidebar
node_controller -.->|"loads"| node_footer

click node_entry "https://github.com/farhanchowdhury738/portfolio/blob/main/index.html"
click node_controller "https://github.com/farhanchowdhury738/portfolio/blob/main/js/main.js"
click node_navbar "https://github.com/farhanchowdhury738/portfolio/blob/main/components/navbar.html"
click node_sidebar "https://github.com/farhanchowdhury738/portfolio/blob/main/components/sidebar.html"
click node_footer "https://github.com/farhanchowdhury738/portfolio/blob/main/components/footer.html"
click node_home "https://github.com/farhanchowdhury738/portfolio/blob/main/sections/home.html"
click node_about "https://github.com/farhanchowdhury738/portfolio/blob/main/sections/about.html"
click node_projects "https://github.com/farhanchowdhury738/portfolio/blob/main/sections/projects.html"
click node_resume "https://github.com/farhanchowdhury738/portfolio/blob/main/sections/resume.html"
click node_contact "https://github.com/farhanchowdhury738/portfolio/blob/main/sections/contact.html"
click node_project_data "https://github.com/farhanchowdhury738/portfolio/blob/main/data/projects.json"
click node_certificate_data "https://github.com/farhanchowdhury738/portfolio/blob/main/data/certificates.json"
click node_volunteer_data "https://github.com/farhanchowdhury738/portfolio/blob/main/data/volunteering.json"
click node_blog_section "https://github.com/farhanchowdhury738/portfolio/blob/main/sections/blog.html"
click node_blog_runtime "https://github.com/farhanchowdhury738/portfolio/blob/main/js/blog.js"
click node_post_data "https://github.com/farhanchowdhury738/portfolio/blob/main/data/posts.json"

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_entry,node_controller,node_navbar,node_sidebar,node_footer toneBlue
class node_home,node_about,node_projects,node_resume,node_contact toneAmber
class node_blog_section,node_blog_runtime toneMint
class node_project_data,node_certificate_data,node_volunteer_data,node_post_data toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio Site

- [Portfolio Entry](https://github.com/farhanchowdhury738/portfolio/blob/main/index.html): `index.html`
- [Portfolio Controller](https://github.com/farhanchowdhury738/portfolio/blob/main/js/main.js): `js/main.js`
- [Navigation Bar](https://github.com/farhanchowdhury738/portfolio/blob/main/components/navbar.html): `components/navbar.html`
- [Responsive Sidebar](https://github.com/farhanchowdhury738/portfolio/blob/main/components/sidebar.html): `components/sidebar.html`
- [Footer](https://github.com/farhanchowdhury738/portfolio/blob/main/components/footer.html): `components/footer.html`

### Portfolio Content

- [Home Section](https://github.com/farhanchowdhury738/portfolio/blob/main/sections/home.html): `sections/home.html`
- [About Section](https://github.com/farhanchowdhury738/portfolio/blob/main/sections/about.html): `sections/about.html`
- [Projects Section](https://github.com/farhanchowdhury738/portfolio/blob/main/sections/projects.html): `sections/projects.html`
- [Resume Section](https://github.com/farhanchowdhury738/portfolio/blob/main/sections/resume.html): `sections/resume.html`
- [Contact Section](https://github.com/farhanchowdhury738/portfolio/blob/main/sections/contact.html): `sections/contact.html`

### Blog

- [Blog Section](https://github.com/farhanchowdhury738/portfolio/blob/main/sections/blog.html): `sections/blog.html`
- [Blog Renderer](https://github.com/farhanchowdhury738/portfolio/blob/main/js/blog.js): `js/blog.js`

### Content Data

- [Project Records](https://github.com/farhanchowdhury738/portfolio/blob/main/data/projects.json): `data/projects.json`
- [Certificates](https://github.com/farhanchowdhury738/portfolio/blob/main/data/certificates.json): `data/certificates.json`
- [Volunteering Records](https://github.com/farhanchowdhury738/portfolio/blob/main/data/volunteering.json): `data/volunteering.json`
- [Post Records](https://github.com/farhanchowdhury738/portfolio/blob/main/data/posts.json): `data/posts.json`

### Other components

- **Visitor**

## Connections

- Visitor → Portfolio Entry: visits (evidence: `README.md`)
- Portfolio Entry → Portfolio Controller: initializes
- Portfolio Controller → Project Records: fetches (evidence: `js/main.js`)
- Portfolio Controller → Certificates: fetches (evidence: `js/main.js`)
- Portfolio Controller → Volunteering Records: fetches (evidence: `js/main.js`)
- Portfolio Controller → Blog Renderer: invokes (evidence: `js/main.js`)
- Blog Renderer → Post Records: fetches (evidence: `js/blog.js`)
- Portfolio Controller → Home Section: loads
- Portfolio Controller → About Section: loads
- Portfolio Controller → Projects Section: loads
- Portfolio Controller → Resume Section: loads
- Portfolio Controller → Contact Section: loads
- Portfolio Controller → Blog Section: loads
- Portfolio Controller → Navigation Bar: loads
- Portfolio Controller → Responsive Sidebar: loads
- Portfolio Controller → Footer: loads
