# harshgupta2125/my-portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a static portfolio website built with plain HTML, CSS and JavaScript.
- Purpose: showcase the developer’s skills, projects, certificates and provide contact links.
- Deployment: hosted on Netlify with a custom domain and CDN for fast delivery.

##### File structure
- Top-level assets:
- index.html – entry point rendered in the browser
- style.css – global styles
- script.js – any client-side interactivity
- resume.pdf – downloadable asset
- certificates/ – folder of certificate images or PDFs
- README.md contains descriptive content and deployment info.
- No backend code or databases—purely static files served.

##### Key insights from the README
- Project description: personal portfolio, web-dev focus.
- Live site URL on Netlify.
- Contact via LinkedIn or email.
- No mention of dynamic forms or server-side logic.

##### Main components
a. Client (Web Browser)
b. DNS / Custom Domain Registrar
c. CDN / Edge Network (Netlify)
d. Origin Storage (GitHub repository → Netlify build artifacts)
e. Static Assets
- HTML, CSS, JS
- Documents (resume.pdf)
f. External Links & Services
- LinkedIn, Mailto link

##### Relationships & interactions
- Browser → DNS: resolve custom domain to Netlify edge.
- Browser → CDN edge: request index.html and static assets.
- CDN edge → Origin (if cache miss): fetch latest build from Netlify storage.
- Browser loads assets, renders portfolio, and clicking links redirects to external services (LinkedIn, mailto).

##### Important architectural patterns & principles
- Static site hosting with continuous deployment (Git push triggers Netlify build).
- CDN caching for global performance.
- Single-page or multi-page static model—no runtime server.
- Separation of assets into dedicated folders for maintainability.

##### Relevant technologies & frameworks
- HTML5 / CSS3 / vanilla JS
- Netlify (build, deploy, CDN)
- GitHub (source control)
- DNS provider / custom domain
- Optional: Netlify Status badge

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client Side"
        Browser["Browser"]:::client
    end

    Browser -->|"Resolve Domain"| DNS["DNS / Custom Domain"]:::hosting
    DNS -->|"Points to"| CDN["Netlify CDN / Edge"]:::hosting
    Browser -->|"Request Assets"| CDN

    subgraph "Origin & CI/CD"
        GitHub["GitHub Repo"]:::hosting
        Build["Netlify Build Pipeline"]:::hosting
        Origin["Origin Storage (Build Artifacts)"]:::hosting
    end

    GitHub -->|"Push to main"| Build
    Build -->|"Deploy to CDN"| Origin
    CDN -->|"Cache miss / Fetch"| Origin

    subgraph "Static Assets"
        HTML["index.html"]:::assets
        CSS["style.css"]:::assets
        JS["script.js"]:::assets
        Resume["resume.pdf"]:::assets
        Certs["certificates/"]:::assets
        Icons["icons/"]:::assets
    end

    Origin --> HTML
    Origin --> CSS
    Origin --> JS
    Origin --> Resume
    Origin --> Certs
    Origin --> Icons

    subgraph "External Services"
        LinkedIn["LinkedIn"]:::external
        Mailto["Email (mailto)"]:::external
    end

    Browser -->|"Outbound Link"| LinkedIn
    Browser -->|"Outbound Link"| Mailto

    subgraph "Documentation"
        README["README.md"]:::assets
    end

    GitHub --> README

    click HTML "https://github.com/harshgupta2125/my-portfolio/blob/main/index.html"
    click CSS "https://github.com/harshgupta2125/my-portfolio/blob/main/style.css"
    click JS "https://github.com/harshgupta2125/my-portfolio/blob/main/script.js"
    click Resume "https://github.com/harshgupta2125/my-portfolio/blob/main/resume.pdf"
    click Certs "https://github.com/harshgupta2125/my-portfolio/tree/main/certificates/"
    click Icons "https://github.com/harshgupta2125/my-portfolio/tree/main/icons/"
    click README "https://github.com/harshgupta2125/my-portfolio/blob/main/README.md"

    classDef client fill:#CCE5FF,stroke:#3399FF,color:#000
    classDef hosting fill:#E6FFCC,stroke:#33CC33,color:#000
    classDef assets fill:#FFF5CC,stroke:#FFCC33,color:#000
    classDef external fill:#FFE6E6,stroke:#FF3333,color:#000
```
