# jobin-s/personal-website architecture

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

- Interactive diagram: https://gitdiagram.com/jobin-s/personal-website
- Repository: https://github.com/jobin-s/personal-website

## Overview

##### Project type & purpose (from README + file tree)
This is a **static personal website** with **no backend**:
- `index.html` → single-page (or entry) document
- `style.css` → styling
- `README.md` → minimal description (“personal website”)

No signs of:
- JavaScript application code (no `script.js`)
- build tooling (no `package.json`, `vite.config.*`, etc.)
- server code (no `server/`, `api/`)
- hosting/deployment config (no `netlify.toml`, `.github/workflows/`, etc.)

##### Web Browser
- HTML parser / DOM
- CSS parser / style engine
- Rendering / layout engine

##### Static hosting origin
- Examples: GitHub Pages / Netlify / Vercel static / S3 static hosting / local filesystem
##### CDN (optional but common)
- If using GitHub Pages behind a CDN, Cloudflare, etc.

##### Deployment mechanism
- Manual upload, git push to Pages, CI workflow (only include if it exists)

##### Runtime request/response flow
- **User → Browser**: navigation / click / type URL
- **Browser → Hosting/CDN → Origin**: `GET /index.html`
- **Browser → Hosting/CDN → Origin**: `GET /style.css` (triggered by `<link rel="stylesheet" ...>` in HTML)
- **Origin/Hosting → Browser**: returns the files (HTTP 200)

##### Resource dependency flow (inside the page)
- **`index.html` → `style.css`**: “links stylesheet”
- **Browser (HTML parser) → DOM**
- **Browser (CSS engine) → CSSOM**
- **DOM + CSSOM → Render Tree → Layout/Paint → Pixels**

- caching headers (if any)
- content types (`text/html`, `text/css`)
- responsive behavior (media queries) if relevant (but only if present)

##### Architectural patterns / principles to call out
- **Static site architecture**
- **Separation of concerns**:
- structure/content in `index.html`
- presentation in `style.css`
- **Client-side rendering** (browser does all rendering; no server-side compute)

Do *not* show APIs, databases, authentication, queues, etc., unless they exist (they currently do not).

Focus: how the user gets the site.
- Person: User
- Container: Browser
- Container: CDN (optional)
- Container: Static Hosting Origin
- Components: `index.html`, `style.css` (as artifacts served by origin)

Focus: how `index.html` + `style.css` become a rendered page.
- `index.html` → DOM
- `style.css` → CSSOM
- DOM + CSSOM → Render Tree → Layout/Paint

##### What to label explicitly (technologies, files, responsibilities)
Use very explicit labels since the project is small:
- “HTML5 document (`index.html`)"
- “CSS stylesheet (`style.css`)"
- “User agent (Chrome/Firefox/Safari)”
- “Static file server (GitHub Pages / local file:// / Nginx)”
- “HTTP GET /index.html, /style.css” (if hosted)
- “DOM/CSSOM/Render tree pipeline” (browser internals)

##### “Don’t overthink it” checklist (but still detailed)
Everything that truly exists:
- the two site files
- the browser as the execution environment
- the hosting mechanism (even if “local file system”)
- the dependency edge: HTML → CSS
- the request edges (if HTTP hosted)

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Runtime / Delivery Diagram
  %% =========================
  subgraph "Runtime / Delivery (Static Site)"
    U["User"]:::person
    B["Web Browser (User Agent)"]:::client

    subgraph "Delivery Path"
      CDN["CDN (Optional)"]:::delivery
      ORIGIN["Static Hosting Origin (serves static files)"]:::delivery

      subgraph "Static Artifacts (Served Files)"
        HTML["HTML5 Document (index.html)"]:::artifact
        CSS["CSS Stylesheet (style.css)"]:::artifact
      end
    end
  end

  %% =========================
  %% Page Composition Diagram
  %% =========================
  subgraph "Page Composition (Inside the Browser)"
    subgraph "Parsing & Rendering Pipeline"
      HTMLP["HTML Parser"]:::client
      DOM["DOM (Document Object Model)"]:::client
      CSSP["CSS Parser / Style Engine"]:::client
      CSSOM["CSSOM (CSS Object Model)"]:::client
      RT["Render Tree"]:::client
      LP["Layout / Paint"]:::client
      PX["Pixels (Rendered Page)"]:::client
    end
  end

  %% =========================
  %% Legend
  %% =========================
  subgraph "Legend"
    L1["Blue: Client / Runtime"]:::client
    L2["Green: Hosting / Delivery"]:::delivery
    L3["Gray: Static Artifacts (Files)"]:::artifact
    L4["Orange: Person"]:::person
  end

  %% =========================
  %% Connections (Delivery)
  %% =========================
  U -->|"navigate/type_URL"| B
  B -->|"HTTP_GET_/index.html"| CDN
  CDN -->|"forward_request"| ORIGIN
  ORIGIN -->|"HTTP_200_text/html"| B

  B -->|"HTTP_GET_/style.css"| CDN
  CDN -->|"forward_request"| ORIGIN
  ORIGIN -->|"HTTP_200_text/css"| B

  ORIGIN -->|"serves"| HTML
  ORIGIN -->|"serves"| CSS

  %% =========================
  %% Connections (Resource dependency)
  %% =========================
  HTML -->|"links_stylesheet"| CSS

  %% =========================
  %% Connections (Browser pipeline)
  %% =========================
  HTML -->|"parsed_by"| HTMLP
  HTMLP -->|"builds"| DOM

  CSS -->|"parsed_by"| CSSP
  CSSP -->|"builds"| CSSOM

  DOM -->|"combine"| RT
  CSSOM -->|"combine"| RT
  RT -->|"produces"| LP
  LP -->|"rasterizes_to"| PX

  %% =========================
  %% Click Events (from mapping)
  %% =========================
  click HTML "https://github.com/jobin-s/personal-website/blob/master/index.html"
  click CSS "https://github.com/jobin-s/personal-website/blob/master/style.css"

  %% Optional contextual artifact
  README["Project README (purpose/notes)"]:::artifact
  click README "https://github.com/jobin-s/personal-website/blob/master/README.md"

  %% =========================
  %% Styles
  %% =========================
  classDef person fill:#f59e0b,stroke:#92400e,stroke-width:1px,color:#111827;
  classDef client fill:#60a5fa,stroke:#1e3a8a,stroke-width:1px,color:#0b1220;
  classDef delivery fill:#34d399,stroke:#065f46,stroke-width:1px,color:#052e2b;
  classDef artifact fill:#e5e7eb,stroke:#374151,stroke-width:1px,color:#111827;
```
