# rahulp-fx/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a purely static, single‑page personal portfolio website.
- It consists of plain HTML/CSS files (index.html, pages/about.html, pages/contact.html, and corresponding styles) plus an assets folder for images or other media.
- It is deployed to Vercel (a static‑hosting/CDN platform), as indicated by the “Deployed App Link” in the README.

##### File structure
- Top‑level:
- README.md – project info and deployment link
- index.html – homepage
- style.css – global styles
- pages/ – secondary pages (about.html, contact.html) and their CSS
- There are no server or backend directories—this confirms a static‑site architecture.

##### README for additional insights
- The only content is the Vercel deployment URL, which implies a simple CI/CD pipeline on every push to the Git repo.
- No frameworks or build tools are mentioned, so we assume plain HTML/CSS with no compilation step.

a. Main components to include
- Developer local environment (code editor, Git).
- Git repository (e.g., GitHub).
- Vercel CI/CD pipeline.
- Vercel hosting + global CDN.
- End‑user browser.
- Static assets (HTML, CSS, images).
b. Relationships and interactions
1. Developer pushes commits → Git repository
2. Git hook triggers Vercel build → Vercel fetches code
3. Vercel builds (trivially copies) static files → deploys to CDN
4. User browser requests URL → CDN edge node serves the static HTML/CSS/assets
5. Browser renders pages and fetches assets
c. Architectural patterns and design principles
- Static‑site architecture (no backend): high performance, low maintenance.
- CI/CD on push to main branch ensures automated deployment.
- CDN distributed delivery for minimal latency.
d. Relevant technologies, frameworks, or libraries
- HTML5, CSS3
- Vercel hosting & built‑in CDN
- Git/GitHub (or other Git host)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Side
    Developer["Developer Local Environment"]:::dev
    Developer -->|"push code"| GitRepo

    %% Version Control
    GitRepo["GitHub Repository"]:::dev
    GitRepo -->|"trigger build"| VercelBuild

    %% CI/CD Pipeline
    VercelBuild["Vercel Build (CI/CD)"]:::ci
    VercelBuild -->|"deploy static files"| VercelDeploy

    %% Hosting and CDN
    VercelDeploy["Vercel Hosting & CDN"]:::cdn
    VercelDeploy -->|"HTTP GET requests"| UserBrowser

    %% End-user
    UserBrowser["End-User Browser"]:::user
    UserBrowser -->|"renders pages and assets"| UserBrowser

    %% Static File Store under CDN
    subgraph "Static File Store" 
        direction TB
        Index["index.html"] 
        Style["style.css"]
        Assets["assets/"]
        AboutPage["about.html"]
        AboutStyle["about.css"]
        ContactPage["contact.html"]
        ContactStyle["contact.css"]
    end

    VercelDeploy -->|"serves static files"| Index
    VercelDeploy --> Style
    VercelDeploy --> Assets
    VercelDeploy --> AboutPage
    VercelDeploy --> AboutStyle
    VercelDeploy --> ContactPage
    VercelDeploy --> ContactStyle

    %% Click Events
    click Index "https://github.com/rahulp-fx/portfolio/blob/main/index.html"
    click Style "https://github.com/rahulp-fx/portfolio/blob/main/style.css"
    click Assets "https://github.com/rahulp-fx/portfolio/tree/main/assets/"
    click AboutPage "https://github.com/rahulp-fx/portfolio/blob/main/pages/about.html"
    click AboutStyle "https://github.com/rahulp-fx/portfolio/blob/main/pages/about.css"
    click ContactPage "https://github.com/rahulp-fx/portfolio/blob/main/pages/contact.html"
    click ContactStyle "https://github.com/rahulp-fx/portfolio/blob/main/pages/contact.css"

    %% Styles
    classDef dev fill:#cbe8fd,stroke:#4a90e2,stroke-width:2px
    classDef ci fill:#ffd8b8,stroke:#fa8c16,stroke-width:2px
    classDef cdn fill:#d1f7c4,stroke:#52c41a,stroke-width:2px
    classDef user fill:#fff2a8,stroke:#fadb14,stroke-width:2px
```
