# hoover900/not-so-epic_source-files architecture

> Architecture diagram of the GitHub repository hoover900/not-so-epic_source-files, 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/hoover900/not-so-epic_source-files
- Repository: https://github.com/hoover900/not-so-epic_source-files

## Overview

##### What this project is (type + purpose)
This repository is **not an application/codebase**; it’s a **design/asset working-files repository** for the “Not so Epic Noir” theme.

Evidence from structure + README:
- README: “Where all the working files … are stored” → implies **source design files**, not compiled/runtime artifacts.
- File types:
- **`.afdesign` / `.aftemplate`** → Affinity Designer working files/templates
- **`.kra`** → Krita working files
- Directories map to asset domains: `UI/`, `controllers/`, `logos/`, `posters/` (organized by platform/console).

##### How to read the file structure (and what to model)
Top-level components are “asset families”:

##### UI/
- Represents the **core UI kit** and templates that likely influence multiple outputs.

##### controllers/
- Per-console controller art sources (Dreamcast, Genesis, PC-Engine, SNES).
- Mostly `.kra` → likely raster/painted controller images.

##### logos/
- Platform/system logos in `.afdesign`.
- Typically vector sources intended for export as SVG/PNG at multiple sizes.

##### posters/
- Poster/background sources, organized by platform (PSX, arcade, dreamcast, etc.).
- Mostly `.kra` → painted/edited backgrounds, platform-specific.

Goal: show how assets are partitioned.
- Nodes:
- `UI/`
- `controllers/<system>/`
- `logos/`
- `posters/<system>/`
- Node with:
- Primary file formats (`.afdesign`, `.aftemplate`, `.kra`)
- Typical exported outputs (even if implied): `PNG`, `SVG`, `JPG`
- Ownership/concerns (“UI kit”, “Controller overlays”, “System logos”, “Platform posters”)

Goal: show how work files become shipped theme assets.

Suggested components + flows:
##### Designer workstation
- Tools:
- Affinity Designer (edits `.afdesign` / `.aftemplate`)
- Krita (edits `.kra`)
##### This Git repository (Working Files)
- Stores editable sources
- “Export assets” produces `PNG/SVG/JPG` variants
##### Theme distribution/packaging repo (external)
- Receives exported assets
##### End user environment (external)
- “Theme engine / frontend” that consumes final assets (keep generic since the repo doesn’t specify)

- Workstation → Git repo (commit/push)
- Git repo → Workstation (pull/checkout)
- Workstation (export) → Distribution repo (add exported assets)
- Distribution repo → End user (release/package)

##### “Per-Asset-Type Detail” (optional but “most detailed”)
- UI asset lifecycle (templates → UI elements → exports)
- Logo lifecycle (vector master → multi-size exports)
- Poster lifecycle (background master → platform variants → exports)
- Controller lifecycle (base art → button overlays → exports)

##### Internal components (in-repo)
- **UI working files** (`UI/*.afdesign`, `UI/*.aftemplate`)
- **Controller artwork sources** (`controllers/*/*.kra`)
- **Logo vector masters** (`logos/*.afdesign`)
- **Poster/background masters** (`posters/*/*.kra`)

##### Tooling components (external but essential)
- **Affinity Designer**
- **Krita**
- **Git client + GitHub (or remote VCS hosting)** (implied by repo)

##### Output/consumers (external)
- **Exported assets** (PNG/SVG/JPG; include as an artifact store node)
- **Theme package/distribution repo** (where exported assets live)
- **Theme runtime/consumer** (the UI/theme system used by end users)

Interactions:
- Editing happens in Affinity/Krita
- Sources are versioned in Git
- Exports are generated from sources
- Exports are integrated into the final theme package consumed by users

##### Architectural patterns/principles visible here (call these out)
Even though it’s not code, there are clear organizing principles worth annotating:

- **Domain-based asset organization**: UI vs logos vs posters vs controllers.
- **Platform/system partitioning**: posters/controllers grouped by console/system folder.
- **Source-of-truth separation**: working files (`.afdesign`, `.kra`) are “masters”; exports are downstream artifacts (likely stored elsewhere).
- **Template-driven design**: presence of `.aftemplate` suggests reusable templates (e.g., poster templates, layout templates).

##### Important note about unknowns (handle explicitly)
The README is minimal, so don’t invent specifics (e.g., exact theme engine). Instead:
- exact output formats and sizes
- naming conventions
- whether exports are stored in a separate repo or generated during release

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Diagram A: Repository / Domain Map
  %% =========================
  subgraph A["A) Repository / Domain Map (static structure)"]
    direction TB

    Repo["Not-so-Epic Noir Working Files Repo\n(Git versioned source-of-truth)"]:::repo

    subgraph A1["Asset families (in-repo)"]
      direction TB

      UI["UI/\n(afdesign, aftemplate, kra)\nConcern: UI kit + templates\nExports: PNG/SVG/JPG"]:::source
      CTRL["controllers/\n(kra)\nConcern: controller artwork (per system)\nExports: PNG/JPG"]:::source
      LOGO["logos/\n(afdesign)\nConcern: platform/system logos (vector masters)\nExports: SVG/PNG"]:::source
      POST["posters/\n(kra)\nConcern: platform posters/backgrounds\nExports: PNG/JPG"]:::source
    end

    Repo -->|"contains"| UI
    Repo -->|"contains"| CTRL
    Repo -->|"contains"| LOGO
    Repo -->|"contains"| POST

    subgraph A2["Organizing principles (notes)"]
      direction TB
      P1["Domain-based asset organization\n(UI vs controllers vs logos vs posters)"]:::note
      P2["Platform/system partitioning\n(controllers/<system>/, posters/<system>/)"]:::note
      P3["Source-of-truth separation\n(working files are masters; exports are downstream)"]:::note
      P4["Template-driven design\n(.aftemplate enables reuse)"]:::note
    end

    Repo -.->|"follows"| P1
    Repo -.->|"follows"| P2
    Repo -.->|"follows"| P3
    UI -.->|"implies"| P4
  end

  %% =========================
  %% Diagram B: Asset Production Pipeline
  %% =========================
  subgraph B["B) Asset Production Pipeline (workflow/dataflow)"]
    direction TB

    subgraph B1["Creators / Tools (external)"]
      direction TB
      WS["Designer Workstation"]:::external
      AD["Affinity Designer\n(edits .afdesign/.aftemplate)"]:::tool
      KR["Krita\n(edits .kra)"]:::tool
      GIT["Git client + Remote VCS hosting\n(e.g., GitHub)"]:::tool

      WS -->|"use"| AD
      WS -->|"use"| KR
      WS -->|"use"| GIT
    end

    subgraph B2["Source repository (this repo)"]
      direction TB
      Repo2["Working Files Repo\n(versioned editable sources)"]:::repo
      UI2["UI/ (masters)"]:::source
      CTRL2["controllers/ (masters)"]:::source
      LOGO2["logos/ (masters)"]:::source
      POST2["posters/ (masters)"]:::source

      Repo2 -->|"stores"| UI2
      Repo2 -->|"stores"| CTRL2
      Repo2 -->|"stores"| LOGO2
      Repo2 -->|"stores"| POST2
    end

    subgraph B3["Export + Distribution (external)"]
      direction TB
      EXP["Export step\n(manual or scripted; TBD)"]:::process
      OUT["Exported assets\n(PNG/SVG/JPG variants)"]:::deliverable
      DIST["Theme packaging/distribution repo\n(external)"]:::externalRepo
      RUNTIME["End user theme runtime/consumer\n(external)"]:::consumer

      EXP -->|"produces"| OUT
      OUT -->|"add/commit"| DIST
      DIST -->|"package/release"| RUNTIME
    end

    WS <-->|"pull/checkout + commit/push"| Repo2
    AD -.->|"edit"| UI2
    AD -.->|"edit"| LOGO2
    KR -.->|"edit"| CTRL2
    KR -.->|"edit"| POST2

    WS -->|"export"| EXP
    Repo2 -.->|"provides masters"| EXP

    subgraph B4["Assumptions / TBD (explicit unknowns)"]
      direction TB
      TBD1["Exact output formats + sizes"]:::note
      TBD2["Naming conventions + resolutions"]:::note
      TBD3["Where exports live (separate repo vs generated at release)"]:::note
    end

    EXP -.->|"depends on"| TBD1
    EXP -.->|"depends on"| TBD2
    DIST -.->|"depends on"| TBD3
  end

  %% =========================
  %% Diagram C: Per-Asset-Type Detail
  %% =========================
  subgraph C["C) Per-Asset-Type Detail (lifecycles)"]
    direction TB

    subgraph C1["UI lifecycle"]
      direction TB
      UI_MASTER["UI working files\n(.afdesign/.aftemplate/.kra)"]:::source
      UI_TPL["Reusable templates\n(.aftemplate)"]:::source
      UI_ELEMS["UI elements\n(buttons/layout/icons)"]:::source
      UI_EXP["UI exports\n(PNG/SVG/JPG)"]:::deliverable

      UI_MASTER -->|"includes"| UI_TPL
      UI_MASTER -->|"includes"| UI_ELEMS
      UI_TPL -->|"drives"| UI_ELEMS
      UI_ELEMS -->|"export"| UI_EXP
    end

    subgraph C2["Logo lifecycle"]
      direction TB
      LOGO_MASTER["Logo vector masters\n(.afdesign)"]:::source
      LOGO_SIZES["Multi-size/logo variants\n(SVG/PNG)"]:::deliverable
      LOGO_MASTER -->|"export"| LOGO_SIZES
    end

    subgraph C3["Poster lifecycle"]
      direction TB
      POST_MASTER["Poster/background masters\n(.kra, per platform)"]:::source
      POST_VARIANTS["Platform variants\n(crops/edits; implied)"]:::process
      POST_EXP["Poster exports\n(PNG/JPG)"]:::deliverable
      POST_MASTER -->|"derive"| POST_VARIANTS
      POST_VARIANTS -->|"export"| POST_EXP
    end

    subgraph C4["Controller lifecycle"]
      direction TB
      CTRL_MASTER["Controller artwork masters\n(.kra, per system)"]:::source
      CTRL_OVER["Button/label overlays\n(implied)"]:::process
      CTRL_EXP["Controller exports\n(PNG/JPG)"]:::deliverable
      CTRL_MASTER -->|"compose"| CTRL_OVER
      CTRL_OVER -->|"export"| CTRL_EXP
    end
  end

  %% =========================
  %% Click Events (from component_mapping)
  %% =========================
  click UI "https://github.com/hoover900/not-so-epic_source-files/tree/master/UI/"
  click CTRL "https://github.com/hoover900/not-so-epic_source-files/tree/master/controllers/"
  click LOGO "https://github.com/hoover900/not-so-epic_source-files/tree/master/logos/"
  click POST "https://github.com/hoover900/not-so-epic_source-files/tree/master/posters/"

  click UI_MASTER "https://github.com/hoover900/not-so-epic_source-files/tree/master/UI/"
  click UI2 "https://github.com/hoover900/not-so-epic_source-files/tree/master/UI/"
  click CTRL2 "https://github.com/hoover900/not-so-epic_source-files/tree/master/controllers/"
  click LOGO2 "https://github.com/hoover900/not-so-epic_source-files/tree/master/logos/"
  click POST2 "https://github.com/hoover900/not-so-epic_source-files/tree/master/posters/"

  %% UI specific files
  click UI_TPL "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/Poster.aftemplate"
  click UI_TPL "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/widePoster_template.aftemplate"
  click UI_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/background_template.afdesign"
  click UI_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/background_template.kra"
  click UI_ELEMS "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/button.afdesign"
  click UI_ELEMS "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/button2.afdesign"
  click UI_ELEMS "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/button_new.afdesign"
  click UI_ELEMS "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/help icons.afdesign"
  click UI_ELEMS "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/list icons.afdesign"
  click UI_ELEMS "https://github.com/hoover900/not-so-epic_source-files/blob/master/UI/new detail layout.afdesign"

  %% Controllers specific files
  click CTRL_MASTER "https://github.com/hoover900/not-so-epic_source-files/tree/master/controllers/"
  click CTRL_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/controllers/dreamcast/controller.kra"
  click CTRL_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/controllers/genesis/genesis_controller.kra"
  click CTRL_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/controllers/pc-engine/pc-engine_controller.kra"
  click CTRL_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/controllers/snes/snes_controller.kra"

  %% Logos specific files
  click LOGO_MASTER "https://github.com/hoover900/not-so-epic_source-files/tree/master/logos/"
  click LOGO_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/logos/PSX.afdesign"
  click LOGO_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/logos/dreamcast.afdesign"
  click LOGO_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/logos/snes.afdesign"

  %% Posters specific files
  click POST_MASTER "https://github.com/hoover900/not-so-epic_source-files/tree/master/posters/"
  click POST_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/posters/PSX/psx.kra"
  click POST_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/posters/arcade/arcade.kra"
  click POST_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/posters/dreamcast/dreamcast_poster.kra"
  click POST_MASTER "https://github.com/hoover900/not-so-epic_source-files/blob/master/posters/snes/snes.kra"

  %% =========================
  %% Styles
  %% =========================
  classDef repo fill:#1f4b99,stroke:#0f2b5b,color:#ffffff,stroke-width:2px
  classDef externalRepo fill:#3b3f46,stroke:#1f2328,color:#ffffff,stroke-width:2px
  classDef tool fill:#6f42c1,stroke:#3b1f75,color:#ffffff,stroke-width:2px
  classDef process fill:#7a2e8e,stroke:#3f184a,color:#ffffff,stroke-width:2px
  classDef source fill:#2b6cb0,stroke:#153e75,color:#ffffff,stroke-width:2px
  classDef deliverable fill:#1f9d55,stroke:#0b5d30,color:#ffffff,stroke-width:2px
  classDef external fill:#9aa0a6,stroke:#5f6368,color:#111111,stroke-width:2px
  classDef consumer fill:#b0b7c3,stroke:#6b7280,color:#111111,stroke-width:2px
  classDef note fill:#fff3bf,stroke:#d39e00,color:#3b2f00,stroke-width:1.5px
```
