# bardofsprites/bardmandev architecture

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

- Interactive diagram: https://gitdiagram.com/bardofsprites/bardmandev
- Repository: https://github.com/bardofsprites/bardmandev

## Overview

##### Project type and purpose
– This is a static personal website built with Hugo using Org-mode content files, CSS, and no JavaScript.
– The README confirms it is “Bardmandev,” a personal site rendered by Hugo and deployed (via Vercel).

##### File structure
– Top-level directories:
- content/ – all Org-mode source pages (.org) organized into sections (notes, general, technology, etc.).
- layouts/ – Hugo templates and shortcodes to render content.
- themes/lugo/ – the custom theme with its own layouts, partials, static assets, and archetypes.
- resources/ – generated assets (SCSS → CSS) that Hugo pipelines.
- static/ – raw static assets (fonts, images, PDFs, CSS).
- config.toml – Hugo site configuration.
- archetypes/ – default front-matter templates for new content.
- shell.nix – development environment specification.
- vercel.json – deployment config for Vercel.

##### README for additional insights
– Confirms technologies (Hugo, Org-mode, CSS, no JS).

- content → Hugo
- layouts/themes → Hugo
- SCSS pipeline → Hugo resources
- static/ → output
- Hugo → public/ → Vercel
- Blue for source (content, SCSS, templates)
- Green for build engine (Hugo)
- Gray for assets (images, fonts, PDFs)
- Orange for hosting (Vercel)

##### Detailed component breakdown (examples)
– Content Sources:
– grouped by sections (notes, general, technology)
– Templates & Theme:
– Asset Pipeline:
– Build & Config:
– Deployment:

##### Detail without over-modularizing
– Represent each logical component; group sub-folders under their parent if too granular.
– Show how Hugo ties content, templates, and assets into the final static site.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Authoring Layer
    subgraph "Authoring" 
        CS["Content Sources\n(content/*.org)"]:::source
        AR["Archetype Templates\n(archetypes/default.md)"]:::source
        SN["Dev Environment\n(shell.nix)"]:::source
    end

    %% Templates & Theme Layer
    subgraph "Templates & Theme"
        LY["Hugo Layouts\n(layouts/)"]:::template
        TDL["Theme Layouts\n(themes/lugo/layouts/_default/)"]:::template
        TPR["Theme Partials\n(themes/lugo/layouts/partials/)"]:::template
        TSC["Theme Shortcodes\n(themes/lugo/layouts/shortcodes/)"]:::template
        TAR["Theme Archetypes\n(themes/lugo/archetypes/default.md)"]:::template
        TCG["Theme Config\n(themes/lugo/config.toml)"]:::template
    end

    %% Assets Layer
    subgraph "Assets"
        RS["Resource Pipeline Output\n(resources/_gen/assets/scss/)"]:::asset
        SF["Static Fonts\n(static/fonts/)"]:::asset
        SI["Static Images\n(static/img/)"]:::asset
        SP["Static PDFs\n(static/pdfs/)"]:::asset
        SCO["Static CSS Overrides\n(static/old-style.css\nstatic/sidebar.css\nstatic/style.css)"]:::asset
        TSA["Theme Static Assets\n(themes/lugo/static/style.css)"]:::asset
    end

    %% Build Engine Layer
    subgraph "Build Engine"
        HG["Hugo Binary + Config\n(config.toml)"]:::build
    end

    %% Output & Hosting Layer
    subgraph "Output & Hosting"
        PUB["Public Output\n(public/)"]:::output
        VZ["Vercel CDN\n(Vercel)"]:::output
    end

    %% Connections
    CS -->|"ingest content"| HG
    AR -->|"apply archetypes"| HG
    SN -->|"dev env"| HG
    LY -->|"use layouts"| HG
    TDL -->|"use theme layouts"| HG
    TPR -->|"use partials"| HG
    TSC -->|"use shortcodes"| HG
    TAR -->|"use theme archetypes"| HG
    TCG -->|"use theme config"| HG
    RS -->|"compile SCSS"| HG
    SF -->|"copy fonts"| HG
    SI -->|"copy images"| HG
    SP -->|"copy PDFs"| HG
    SCO -->|"copy CSS overrides"| HG
    TSA -->|"copy theme CSS"| HG
    HG -->|"generate site"| PUB
    PUB -->|"deploy"| VZ

    %% Click Events
    click CS "https://github.com/bardofsprites/bardmandev/tree/master/content/"
    click AR "https://github.com/bardofsprites/bardmandev/blob/master/archetypes/default.md"
    click SN "https://github.com/bardofsprites/bardmandev/blob/master/shell.nix"
    click LY "https://github.com/bardofsprites/bardmandev/tree/master/layouts/"
    click TDL "https://github.com/bardofsprites/bardmandev/tree/master/themes/lugo/layouts/_default/"
    click TPR "https://github.com/bardofsprites/bardmandev/tree/master/themes/lugo/layouts/partials/"
    click TSC "https://github.com/bardofsprites/bardmandev/tree/master/themes/lugo/layouts/shortcodes/"
    click TAR "https://github.com/bardofsprites/bardmandev/blob/master/themes/lugo/archetypes/default.md"
    click TCG "https://github.com/bardofsprites/bardmandev/blob/master/themes/lugo/config.toml"
    click RS "https://github.com/bardofsprites/bardmandev/tree/master/resources/_gen/assets/scss/"
    click SF "https://github.com/bardofsprites/bardmandev/tree/master/static/fonts/"
    click SI "https://github.com/bardofsprites/bardmandev/tree/master/static/img/"
    click SP "https://github.com/bardofsprites/bardmandev/tree/master/static/pdfs/"
    click TSA "https://github.com/bardofsprites/bardmandev/blob/master/themes/lugo/static/style.css"

    %% Styles
    classDef source fill:#E0F7FA,stroke:#006064,color:#006064
    classDef template fill:#E3F2FD,stroke:#0D47A1,color:#0D47A1
    classDef asset fill:#F5F5F5,stroke:#9E9E9E,color:#424242
    classDef build fill:#E8F5E9,stroke:#1B5E20,color:#1B5E20
    classDef output fill:#FFF3E0,stroke:#E65100,color:#E65100
```
