# davidsamuelps/recurseit architecture

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

- Interactive diagram: https://gitdiagram.com/davidsamuelps/recurseit
- Repository: https://github.com/davidsamuelps/recurseit

## Overview

##### Project type and purpose
- This is a static‐site blog built with Hugo (a Go-based static site generator).
- The goal is to migrate content from WordPress into Hugo, manage it in Markdown under `content/`, apply a custom theme under `themes/m10c-27-02-2024/`, and output a static site under `public/`.

##### File structure
- Top-level:
- `config.toml` — global Hugo config
- `archetypes/` — content templates for new posts
- `content/` — your Markdown blog posts and pages
- `static/` — raw assets (images, fonts, etc.) copied verbatim
- `resources/` — Hugo processed assets (SCSS → CSS, image processing)
- `public/` — generated HTML/CSS/JS ready to deploy
- `themes/m10c-27-02-2024/` — custom theme with assets, layouts, scripts
- Under the theme:
- `layouts/` — Hugo templates (baseof, single, list, partials)
- `assets/` & `resources/` — SCSS source & generated CSS
- `exampleSite/` — sample config and content for theme testing

##### README
- Confirms the repo’s purpose: migrating from WordPress to Hugo.
- No additional architectural notes, so infer a simple static pipeline.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer
    DEV["Developer Workstation"]:::external

    %% Version Control
    subgraph "Version Control (Git Repo)"
        lock[".hugo_build.lock"]:::source
        readme["README.md"]:::source
        config["config.toml"]:::source
    end

    %% Content Source
    subgraph "Content Source"
        archetypes["archetypes/"]:::source
        contentSrc["content/"]:::source
    end

    %% Custom Theme
    subgraph "Custom Theme"
        themeRoot["themes/m10c-27-02-2024/"]:::source
        layouts["layouts/"]:::source
        themeAssets["assets/ (SCSS)"]:::source
        scripts["scripts/"]:::source
        themeStatic["static/"]:::source
        themeConfig["theme.toml"]:::source
    end

    %% Static Assets
    subgraph "Static Assets"
        staticDir["static/"]:::source
    end

    %% Build Processes
    subgraph "Hugo Build Process"
        hugo["Hugo CLI Build"]:::build
        pipeline["Resource Pipeline"]:::build
    end

    %% Generated Output
    subgraph "Generated Output"
        public["public/"]:::output
    end

    %% Hosting & Client
    host["Hosting/CDN"]:::external
    client["End-User Browser"]:::external

    %% Workflow Connections
    DEV -->|commits changes| lock
    DEV --> readme
    DEV --> config

    lock -->|push to repo| archetypes
    lock --> contentSrc
    lock --> themeRoot
    lock --> staticDir

    themeRoot --> layouts
    themeRoot --> themeAssets
    themeRoot --> scripts
    themeRoot --> themeStatic
    themeRoot --> themeConfig

    config --> hugo
    archetypes --> hugo
    contentSrc --> hugo
    staticDir --> hugo
    themeRoot --> hugo

    hugo --> pipeline
    pipeline --> public

    public -->|deploy| host
    host -->|serve| client

    %% Click Events
    click lock "https://github.com/davidsamuelps/recurseit/blob/main/.hugo_build.lock"
    click readme "https://github.com/davidsamuelps/recurseit/blob/main/README.md"
    click config "https://github.com/davidsamuelps/recurseit/blob/main/config.toml"
    click archetypes "https://github.com/davidsamuelps/recurseit/blob/main/archetypes/default.md"
    click contentSrc "https://github.com/davidsamuelps/recurseit/tree/main/content/"
    click themeRoot "https://github.com/davidsamuelps/recurseit/tree/main/themes/m10c-27-02-2024/"
    click layouts "https://github.com/davidsamuelps/recurseit/tree/main/themes/m10c-27-02-2024/layouts/"
    click themeAssets "https://github.com/davidsamuelps/recurseit/tree/main/themes/m10c-27-02-2024/assets/"
    click scripts "https://github.com/davidsamuelps/recurseit/tree/main/themes/m10c-27-02-2024/scripts/"
    click themeStatic "https://github.com/davidsamuelps/recurseit/tree/main/themes/m10c-27-02-2024/static/"
    click themeConfig "https://github.com/davidsamuelps/recurseit/blob/main/themes/m10c-27-02-2024/theme.toml"
    click staticDir "https://github.com/davidsamuelps/recurseit/tree/main/static/"
    click pipeline "https://github.com/davidsamuelps/recurseit/tree/main/resources/_gen/assets/scss/css/"
    click public "https://github.com/davidsamuelps/recurseit/tree/main/public/"

    %% Styles
    classDef source fill:#D0E7FF,stroke:#0366d6,color:#000
    classDef build  fill:#DFFFE0,stroke:#228B22,color:#000
    classDef output fill:#FFE5B4,stroke:#FF8C00,color:#000
    classDef external fill:#E0E0E0,stroke:#808080,color:#000
```
