# saijogeorge/blog architecture

> Architecture diagram of the GitHub repository saijogeorge/blog, 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/saijogeorge/blog
- Repository: https://github.com/saijogeorge/blog

## Overview

##### Project Type & Purpose
- This is a purely static, file-based personal portfolio site (“SaijoGeorge.github.io”) hosted on GitHub Pages.
- It aggregates dozens of self-contained micro-tools (each in its own directory), plus one Gatsby-based React app under `json-ld-schema-generator`.

##### File Structure Analysis
- Top-level: static HTML pages (`index.html`, `contact.html`, `projects.html`, etc.), global assets (`css/`, `js/`, `images/`).
- Many sibling directories (e.g. `dummy-credit-card-generator/`, `price-to-hours-worked/`, `ai-art-styles/`, etc.): each contains its own HTML, CSS, JS, fonts and images—completely self-contained micro front-ends.
- One subproject built with Gatsby/React: `json-ld-schema-generator/` featuring typical Gatsby directories (`src/`, `public/`, `.cache/`, page-data, static assets, Workbox).

##### README Insights
- Confirms it’s a personal portfolio site bundling multiple static tools.
- No backend code or API definitions—no server-side components beyond GitHub Pages hosting.

a. Client Layer:
- Web Browser/User Agent
- Mobile/Tablet/Desktop
b. Delivery Layer:
- GitHub Pages (acts as a static file server + CDN)
- Optional CDN layer (e.g. Cloudflare) in front of GitHub Pages
c. Storage Layer:
- GitHub repository storing all static assets
- Build artifacts (Gatsby output under `json-ld-schema-generator`)
d. Build Pipeline (for Gatsby app only):
- Source (`json-ld-schema-generator/src/`) → Node.js/Gatsby CLI → Static HTML/CSS/JS → `public/` → Deploy to Pages
e. Individual Micro-tool Modules:
- Each tool directory contains standalone assets that GitHub Pages serves directly—no runtime interactions between them.

##### Relationships & Data Flow
- Browser requests URL → DNS resolves to GitHub Pages CDN → CDN fetches static files from the repo → serves HTML/CSS/JS → browser renders.
- For Gatsby-based tool: build pipeline runs at deploy time; output is static, then delivered like other tools.

##### Architectural Patterns & Principles
- JAMstack: pre-built markup, served over CDN, decoupled from any server-side runtime.
- Micro-frontend style: each tool is an isolated static “app” folder.
- Single responsibility: directories grouped by project name, assets colocated.
- Cacheable assets: `css/`, `js/`, images, and hashed filenames for cache busting (e.g., in `css-puns/`).

##### Technologies & Frameworks
- GitHub Pages for hosting
- Vanilla HTML/CSS/JS for most tools
- Gatsby (React, GraphQL, Workbox) for the `json-ld-schema-generator` tool
- Build tools: Node.js, Webpack (for Gatsby), Babel, plugins for offline support

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client Layer"
        UB["User Browsers<br>(Mobile/Desktop)"]:::user
    end

    subgraph "Delivery Layer"
        CDN["GitHub Pages CDN<br>(Optional Cloudflare)"]:::hosting
    end

    subgraph "Storage Layer"
        subgraph "GitHub Repository"
            GSA["Global Static Site Assets"]:::staticAsset

            subgraph "Micro-tool Modules"
                DCC["dummy-credit-card-generator"]:::staticAsset
                PTH["price-to-hours-worked"]:::staticAsset
                AIS["ai-art-styles"]:::staticAsset
                BMT["best-marketing-tools"]:::staticAsset
                WB["website-builders"]:::staticAsset
                OT["Other Tools"]:::staticAsset
            end

            subgraph "JSON-LD Schema Generator"
                SRC["Source Code (src/)"]:::staticAsset
                BP["Gatsby Build Pipeline"]:::build
                OUT["Static Output"]:::staticAsset
            end
        end
    end

    UB -->|"Requests URL"| CDN
    CDN -->|"Serves Static Files"| GSA
    CDN -->|"Serves Static Files"| DCC
    CDN -->|"Serves Static Files"| PTH
    CDN -->|"Serves Static Files"| AIS
    CDN -->|"Serves Static Files"| BMT
    CDN -->|"Serves Static Files"| WB
    CDN -->|"Serves Static Files"| OT
    CDN -->|"Serves Static Files"| OUT

    SRC -->|"gatsby build"| BP
    BP -->|"Generates"| OUT

    click DCC "https://github.com/saijogeorge/blog/tree/gh-pages/dummy-credit-card-generator/"
    click PTH "https://github.com/saijogeorge/blog/tree/gh-pages/price-to-hours-worked/"
    click AIS "https://github.com/saijogeorge/blog/tree/gh-pages/ai-art-styles/"
    click BMT "https://github.com/saijogeorge/blog/tree/gh-pages/best-marketing-tools/"
    click WB "https://github.com/saijogeorge/blog/tree/gh-pages/website-builders/"
    click SRC "https://github.com/saijogeorge/blog/tree/gh-pages/json-ld-schema-generator/src/"
    click OUT "https://github.com/saijogeorge/blog/tree/gh-pages/json-ld-schema-generator/"

    classDef staticAsset fill:#D0E8FF,stroke:#004A91,color:#000
    classDef build fill:#DFFFE0,stroke:#267326,color:#000
    classDef hosting fill:#FFE5B4,stroke:#B35C00,color:#000
    classDef user fill:#F0F0F0,stroke:#666,color:#000
```
