# vishnuhas/my-portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a static, single‐page personal portfolio website built with plain HTML5, CSS3, and JavaScript.
- Purpose: to showcase the author’s skills, projects, experience, and provide a contact form and résumé download.

##### File structure
- Top-level files:
- index.html – the single HTML entry point
- app.js (or script.js) – page interactivity (e.g., mobile menu toggle, form validation)
- VishnuNResume.pdf (or assets/resume.pdf) – downloadable résumé
- No backend code or database directories – it’s purely static, likely hosted on GitHub Pages, Netlify, or an S3 bucket.

##### README for additional insights
- Defines the main page sections: Hero, About Me, Skills, Projects, Education, Experience, Contact.
- Mentions a responsive design and a contact form (which implies a form‐handling integration or a third-party endpoint).

##### Main components
a. Browser (Client)
b. Static File Host (Web Server / CDN)
c. Static Assets:
- index.html
- style.css
- app.js
- assets/images/*
- resume.pdf
d. External Service (optional) for form handling (e.g., Formspree, Netlify Forms, email API)

##### Relationships & data flow
- The Browser sends an HTTP GET to the Static File Host.
- The Host responds with index.html, which references style.css and app.js.
- Browser retrieves CSS & JS, renders UI sections.
- When the user clicks “Download Résumé,” the browser GETs resume.pdf.
- On Contact form submission, app.js POSTs form data to the External Service endpoint.

##### Architectural patterns and design principles
- Single-Page Application (SPA) style – all content in one HTML scaffold, sections shown/hidden by CSS and JS.
- Static-site hosting – no runtime server logic.
- Progressive enhancement – HTML first, CSS styling, then JS for interactivity.

##### Key technologies to call out
- HTML5 for semantic markup and page sections.
- CSS3 for responsive grid/flex layouts, media queries, gradients.
- Vanilla JavaScript for DOM manipulation and form logic.
- Hosting/CDN (e.g., GitHub Pages or Netlify).
- Optional third-party form backend (Formspree/Netlify Forms).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser Client Node
    BROWSER["Browser (Client)"]:::browser

    subgraph "Browser UI Sections"
        direction TB
        B1["Hero"]:::browser
        B2["About Me"]:::browser
        B3["Skills"]:::browser
        B4["Projects"]:::browser
        B5["Education"]:::browser
        B6["Experience"]:::browser
        B7["Contact"]:::browser
    end

    %% Static Host
    subgraph "Static File Host / CDN" 
        direction TB
        H1["index.html"]:::host
        H2["style.css"]:::host
        H3["app.js"]:::host
        H4["assets/images/*"]:::asset
        H5["VishnuNResume.pdf"]:::asset
        H6["README.md"]:::host
    end

    %% External Service
    E1["External Form-Handler\n(Netlify Forms)"]:::external

    %% Data Flows
    BROWSER -->|"GET /index.html"| H1
    H1 -->|"200 OK\nindex.html"| BROWSER
    BROWSER -->|"GET /style.css"| H2
    H2 -->|"200 OK\nstyle.css"| BROWSER
    BROWSER -->|"GET /app.js"| H3
    H3 -->|"200 OK\napp.js"| BROWSER
    BROWSER -->|"GET assets/images/*"| H4
    H4 -->|"200 OK\nimages"| BROWSER
    BROWSER -->|"GET /VishnuNResume.pdf"| H5
    H5 -->|"200 OK\nresume.pdf"| BROWSER
    BROWSER -->|"POST /form"| E1
    E1 -->|"200 OK\nsubmission"| BROWSER

    %% Click Events
    click H1 "https://github.com/vishnuhas/my-portfolio/blob/main/index.html"
    click H2 "https://github.com/vishnuhas/my-portfolio/blob/main/style.css"
    click H3 "https://github.com/vishnuhas/my-portfolio/blob/main/app.js"
    click H5 "https://github.com/vishnuhas/my-portfolio/blob/main/VishnuNResume.pdf"
    click H6 "https://github.com/vishnuhas/my-portfolio/blob/main/README.md"

    %% Styles
    classDef browser fill:#cce5ff,stroke:#004085,stroke-width:2px;
    classDef host fill:#d4edda,stroke:#155724,stroke-width:2px;
    classDef asset fill:#e2e3e5,stroke:#6c757d,stroke-width:2px;
    classDef external fill:#fff3cd,stroke:#856404,stroke-width:2px;
```
