# inosaint/ai architecture

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

- Interactive diagram: https://gitdiagram.com/inosaint/ai
- Repository: https://github.com/inosaint/ai

## Overview

##### What this project is (type + purpose)
From the file tree and README, this is a **static website repository** that serves as a **portfolio/landing site**: “A Collection of all my AI Projects.”

There is **no backend** (no server code, no API layer, no database). The “system” is primarily:
- Static HTML pages (`index.html`, `projects/*/index.html`)
- A shared stylesheet (`styles.css`)
- A directory structure that groups project pages under `projects/`

##### How to read the file structure architecturally
Top-level:
- `index.html` — likely the main landing page that links to sub-project pages
- `styles.css` — global/shared styling
- `projects/` — a “section” containing per-project sub-sites/pages
- `projects/smithy/index.html` — a project page (explicit)

##### Runtime view (what happens in production)
- A user’s browser requests HTML/CSS/assets from a static host
- The landing page links to project pages under `/projects/...`
- The same CSS and public assets are reused across pages
##### Code/package view (how the repo is organized)
- “Site root” page
- “Projects” section
- Shared assets and styling

Optionally (but recommended for completeness):
##### Deployment view (how it gets published)
- Git repo → static hosting (GitHub Pages / Netlify / S3+CloudFront, etc.)
- CDN edge caching (if applicable)

##### Client-side (runtime)
- **User**
- **Web Browser**
- Loads and renders:
- `index.html`
- `styles.css`
- `projects/smithy/index.html`
- `projects/hermes/*` (whatever exists)

##### Hosting / Serving layer (runtime)
- **Static Web Host**
- Serves:
- `/index.html`
- `/styles.css`
- `/projects/**`
- `/public/**`
- **CDN (optional but common)**
- Caches static assets close to users

##### Repo structure (code view)
- **Root Site Module**
- `index.html` (main navigation/hub)
- `styles.css` (shared styling)
- **Projects Module**
- `projects/smithy/index.html` (Smithy page)
- `projects/hermes/` (Hermes page/module)
- **Static Assets Module**

##### External dependencies (only if actually used)
If `index.html` or project pages reference external resources (not visible from tree), represent them explicitly once you confirm:
- External JS/CDN libraries (e.g., unpkg, jsdelivr)
- External APIs (e.g., OpenAI) — *not implied by this repo*, only add if the HTML actually calls them

##### Architectural patterns/design principles evident here
- **Static-site architecture**: no server-side compute, no DB
- **Content modularization by directory**: each project has its own folder under `projects/`
- **Shared styling**: `styles.css` suggests a single styling source used across pages
- **Asset centralization**: `public/` indicates shared assets (common pattern for static sites)

##### Don’t overthink it: maximize component separation
- Separate “HTML pages” from “CSS” from “Assets”
- Separate “Home page” from “Project pages”
- Separate “Hosting origin” from “CDN edge” (if applicable)
- Explicit “Navigation” flows (user clicks link → request new HTML)

That level of separation is the most accurate representation of what this repo actually is.

- Open `index.html` and project pages to see:
- Do they all reference the same `styles.css`?
- Do they use JS files (none shown in tree) or external scripts?
- Do they load assets from `public/`?

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Runtime / Deployment View
  %% =========================
  subgraph "Runtime (Production) - Static Site Delivery"
    direction TB

    U["User"]:::external
    B["Web Browser"]:::runtime

    subgraph "Edge / Origin"
      direction TB
      CDN["CDN / Edge Cache (optional)"]:::runtime
      HOST["Static Web Host (e.g., GitHub Pages / Netlify / S3)"]:::runtime
    end

    U -->|"navigates_to_site_URL"| B
    B -->|"HTTPS_GET /index.html"| CDN
    B -->|"HTTPS_GET /styles.css"| CDN
    B -->|"HTTPS_GET /public/**"| CDN
    B -->|"HTTPS_GET /projects/**"| CDN

    CDN -->|"cache_miss_or_revalidate"| HOST
    HOST -->|"serve_static_files"| CDN
  end

  %% =========================
  %% Repository / Code View
  %% =========================
  subgraph "Repository (Code / Module View)"
    direction TB

    README["README.md (Project Overview)"]:::doc

    subgraph "Site Root"
      direction TB
      HOME["/index.html (Landing / Project Hub)"]:::repo
      CSS["/styles.css (Shared Styling)"]:::repo
    end

    subgraph "Projects Section"
      direction TB
      PROJ["/projects/ (Project Pages)"]:::repo

      subgraph "Smithy Project"
        direction TB
        SMITHY["/projects/smithy/index.html"]:::repo
      end

      subgraph "Hermes Project"
        direction TB
        HERMES["/projects/hermes/ (module directory)"]:::repo
      end
    end

    subgraph "Static Assets"
      direction TB
      PUB["/public/ (images/icons/fonts/etc.)"]:::repo
    end

    %% Code relationships
    HOME -->|"HTML_link_navigation"| PROJ
    HOME -->|"HTML_link_navigation"| SMITHY
    HOME -->|"HTML_link_navigation"| HERMES

    HOME -->|"link_rel_stylesheet"| CSS
    SMITHY -->|"link_rel_stylesheet"| CSS
    HERMES -->|"may_reference_styles"| CSS

    HOME -->|"asset_fetch (img/src,icon,font)"| PUB
    SMITHY -->|"asset_fetch (img/src,icon,font)"| PUB
    HERMES -->|"asset_fetch (img/src,icon,font)"| PUB
  end

  %% =========================
  %% Bridge: Hosting serves repo artifacts
  %% =========================
  HOST -->|"serves"| HOME
  HOST -->|"serves"| CSS
  HOST -->|"serves"| PROJ
  HOST -->|"serves"| PUB

  %% =========================
  %% Click Events (from mapping)
  %% =========================
  click HOME "https://github.com/inosaint/ai/blob/main/index.html"
  click CSS "https://github.com/inosaint/ai/blob/main/styles.css"
  click PROJ "https://github.com/inosaint/ai/tree/main/projects/"
  click SMITHY "https://github.com/inosaint/ai/blob/main/projects/smithy/index.html"
  click HERMES "https://github.com/inosaint/ai/tree/main/projects/hermes/"
  click PUB "https://github.com/inosaint/ai/tree/main/public/"
  click README "https://github.com/inosaint/ai/blob/main/README.md"

  %% =========================
  %% Styles
  %% =========================
  classDef runtime fill:#1f6feb,stroke:#0b2f6b,stroke-width:1.5px,color:#ffffff
  classDef repo fill:#6e7781,stroke:#30363d,stroke-width:1.2px,color:#ffffff
  classDef external fill:#2ea043,stroke:#0f3d1e,stroke-width:1.5px,color:#ffffff
  classDef doc fill:#a371f7,stroke:#3d2466,stroke-width:1.2px,color:#ffffff
```
