# himavincent/my-portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a simple, static portfolio website built with HTML, SCSS/CSS and minimal JavaScript.
- Its primary purpose is to serve personal branding content (resume PDF, work samples) to visitors.

##### File structure
- Top-level files:
- README.md – project description
- index.html – single entry-point HTML file
- style.css + style.css.map – compiled stylesheet and source-map
- Directories:
- assets/ – static assets (e.g., PDF resume)
- scss/ – Sass partials and main .scss (global, mixins, variables, normalize, media-queries)
- No backend, serverless/design: all files are served statically.

##### README for additional insights
- Confirms it is a “starter project” showcasing core frontend skills.
- No build tool or JS framework noted, so assume a simple Sass compilation step (e.g. `sass scss:./`).

##### Main components
a. Client (Browser)
b. Static Hosting Server / CDN
c. Build Process (Sass compiler) – development step only
d. Static Assets – HTML, CSS, source maps, resume PDF, images (if any)

##### Relationships and interactions
- Developer runs Sass compiler → outputs style.css + style.css.map
- Deployment: upload index.html, style.css, assets to static host (GitHub Pages, Netlify, etc.)
- Browser requests index.html → then fetches style.css and assets as linked resources

##### Architectural patterns / design principles
- No dynamic logic – purely static, lean front end
- SCSS partialization (variables, mixins, normalize) for maintainability and DRY styles
- Source maps for debugging in development

##### Technologies / frameworks
- HTML5
- Sass/SCSS
- (Optional) Static hosting service (GitHub Pages, Netlify, Vercel)
- (Optional) Sass CLI or Node-based build tool (e.g. npm scripts)

##### Additional detail to capture
- If using a specific hosting platform, note that’s where HTTPS, caching, and CDN live

## Diagram (Mermaid)

```mermaid
flowchart TD
    direction TB

    subgraph "Developer Workstation"
        direction TB
        SCSS["scss/ (SCSS Source Directory)"]:::build
        Sass["Sass Compiler"]:::build
        CSS["style.css (Compiled Stylesheet)"]:::build
        Map["style.css.map (Source Map)"]:::build
    end

    subgraph "Static Hosting / CDN"
        direction TB
        Host["Static Hosting / CDN"]:::hosting
        HTML["index.html"]:::hosting
        AssetsDir["assets/ (Static Assets Directory)"]:::hosting
        Resume["hima-resume.pdf (Resume PDF)"]:::hosting
    end

    subgraph "Client Browser"
        direction TB
        Client["Browser"]:::client
    end

    SCSS -->|"compile scss to css"| Sass
    Sass -->|"outputs style.css"| CSS
    Sass -->|"outputs style.css.map"| Map
    Map -.->|"debugging aid"| Sass

    CSS -->|"upload style.css"| Host
    HTML -->|"upload index.html"| Host
    AssetsDir -->|"upload assets"| Host

    Host -->|"HTTP GET /index.html"| Client
    Host -->|"HTTP GET /style.css"| Client
    Host -->|"HTTP GET /assets/hima-resume.pdf"| Client

    click HTML "https://github.com/himavincent/my-portfolio/blob/main/index.html"
    click SCSS "https://github.com/himavincent/my-portfolio/tree/main/scss/"
    click CSS "https://github.com/himavincent/my-portfolio/blob/main/style.css"
    click Map "https://github.com/himavincent/my-portfolio/blob/main/style.css.map"
    click AssetsDir "https://github.com/himavincent/my-portfolio/tree/main/assets/"
    click Resume "https://github.com/himavincent/my-portfolio/blob/main/assets/hima-resume.pdf"

    classDef build fill:#add8e6,stroke:#000,stroke-width:1px
    classDef hosting fill:#90ee90,stroke:#000,stroke-width:1px
    classDef client fill:#ffffe0,stroke:#000,stroke-width:1px
```
