# bhagwandas786/my-portfolio-webpage architecture

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

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

## Overview

##### Project Type and Purpose
- This is a static, single-page portfolio website built with HTML, CSS, and JavaScript.
- It serves as a personal showcase (home, about, skills, projects, blog, contact form).
- It is deployed as static assets (index.html, styles.css, script.js, resume.pdf) to a web host or CDN (e.g., AWS S3 + CloudFront, Netlify, GitHub Pages).

##### File Structure
- Top-level files only; no nested directories.
- index.html: entry point / single-page layout
- styles.css: global styles & responsive design
- script.js: interactive behaviors (smooth scrolling, blog navigation, back-to-top, form handling)
- resume.pdf: downloadable asset
- README.md / LICENSE: documentation
- No backend code; contact form depends on a third-party API (Formspree).
- External styling/animation: Google Fonts, Animate.css CDN links in index.html.

##### Extract Additional Insights from README
- Features: responsive layout, smooth scroll, interactive cards, blog section, contact form.
- External services:
- Google Fonts for typography
- Animate.css for CSS animations
- Formspree for form submissions
- Deployment instructions mention GitHub, S3/Netlify/Vercel.

##### Main Components
a. Client Browser
- Renders HTML, applies CSS, executes JS.
b. Static Asset Host / CDN
- e.g., AWS S3 bucket + CloudFront (or Netlify/GitHub Pages) serving index.html, CSS, JS, PDF.
c. External Services
- Google Fonts API
- Animate.css CDN
- Formspree API endpoint for contact form submissions
d. Developer Workflow (optional)
- GitHub repository → build or direct deploy → static host

##### Interactions and Data Flows
- Browser → (HTTP GET) → Static Host: fetch index.html, styles.css, script.js, resume.pdf
- index.html includes links to external CDNs (Google Fonts, Animate.css)
- script.js triggers
- smooth scrolling, UI animations (client-side only)
- contact form → (HTTPS POST) → Formspree API → email or storage
- Developer pushes code → GitHub → CI/CD (if configured) → Static Host

##### Architectural Patterns & Principles
- Static Single-Page Application (SPA) pattern
- CDN distribution for global performance
- Third-party API integration (Formspree, fonts, CSS libs)
- Separation of concerns:
- Markup (HTML)
- Styling (CSS)
- Behavior (JS)
- Assets (PDF resume)

##### Must-Include
- Annotations for technologies (HTML5, CSS3, JS, Google Fonts, Animate.css, Formspree)
- Optional: CI/CD flow from GitHub to hosting platform

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client Browser
    subgraph "Client Browser"
        Browser["Browser\n(HTML5, CSS3, JS)"]:::client
    end

    %% Static Hosting Infrastructure
    subgraph "Static Hosting (AWS S3 + CloudFront)"
        S3["AWS S3 Bucket"]:::infra
        CF["CloudFront Distribution"]:::infra
        index["index.html"]:::asset
        css["styles.css"]:::asset
        js["script.js"]:::asset
        pdf["resume.pdf"]:::asset
        S3 --> CF
        CF --> index
        CF --> css
        CF --> js
        CF --> pdf
    end

    %% External Services
    subgraph "External Services"
        Fonts["Google Fonts API"]:::external
        Animate["Animate.css CDN"]:::external
        Formspree["Formspree API"]:::external
    end

    %% Developer Workflow
    subgraph "Developer Workflow"
        GitHub["GitHub Repo"]:::dev
        CI["CI/CD Pipeline"]:::dev
        readme["README.md"]:::doc
        license["LICENSE"]:::doc
        GitHub --> CI
        GitHub --> readme
        GitHub --> license
        CI --> CF
    end

    %% Data Flows
    Browser -->|"GET index.html"| CF
    Browser -->|"GET styles.css"| CF
    Browser -->|"GET script.js"| CF
    Browser -->|"GET resume.pdf"| CF
    Browser -->|"Loads Google Fonts"| Fonts
    Browser -->|"Loads Animate.css"| Animate
    Browser -->|"POST form data"| Formspree

    %% Click Events
    click index "https://github.com/bhagwandas786/my-portfolio-webpage/blob/main/index.html"
    click css "https://github.com/bhagwandas786/my-portfolio-webpage/blob/main/styles.css"
    click js "https://github.com/bhagwandas786/my-portfolio-webpage/blob/main/script.js"
    click pdf "https://github.com/bhagwandas786/my-portfolio-webpage/blob/main/resume.pdf"
    click readme "https://github.com/bhagwandas786/my-portfolio-webpage/blob/main/README.md"
    click license "https://github.com/bhagwandas786/my-portfolio-webpage/tree/main/LICENSE"

    %% Styles
    classDef client fill:#D0E6FF,stroke:#0366d6,color:#0366d6
    classDef infra fill:#D6F5D6,stroke:#28a745,color:#28a745
    classDef external fill:#FFE0B2,stroke:#e65100,color:#e65100
    classDef dev fill:#F0F0F0,stroke:#666666,color:#666666
    classDef asset fill:#EEEEEE,stroke:#999999,color:#333333
    classDef doc fill:#FAFAFA,stroke:#AAAAAA,color:#555555
```
