# incogniadev/diagrams architecture

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

- Interactive diagram: https://gitdiagram.com/incogniadev/diagrams
- Repository: https://github.com/incogniadev/diagrams

## Overview

This repository turns editable draw.io diagrams into PNGs and a preview page, then publishes the static files through GitHub Pages for use in Confluence. The documented local workflow is editing, generating, and deploying; draw.io Desktop performs conversion, while the generation script produces the public artifacts. The README documents these relationships, but no source excerpts were provided, so implementation details beyond that workflow are omitted.

Main entry points: [`scripts/generate.sh`](https://github.com/incogniadev/diagrams/blob/main/scripts/generate.sh) (PNG generator), [`public`](https://github.com/incogniadev/diagrams/tree/main/public) (Generated PNGs), [`public/index.html`](https://github.com/incogniadev/diagrams/blob/main/public/index.html) (Preview page), [`drawio`](https://github.com/incogniadev/diagrams/tree/main/drawio) (Draw.io files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sources["Diagram sources"]
  node_diagrams["Draw.io files"]
end

subgraph group_generation["Local generation"]
  node_generator["PNG generator<br/>[generate.sh]"]
end

subgraph group_publishing["Static publishing"]
  node_pngs["Generated PNGs"]
  node_preview["Preview page<br/>[index.html]"]
end

node_user(("Diagram editor"))
node_desktop["Draw.io Desktop"]
node_pages["GitHub Pages"]
node_confluence(("Confluence users"))

node_user -->|"edits"| node_diagrams
node_generator -->|"processes"| node_diagrams
node_generator -->|"converts with"| node_desktop
node_generator -->|"generates"| node_pngs
node_generator -->|"generates"| node_preview
node_pngs -->|"publishes"| node_pages
node_preview -->|"publishes"| node_pages
node_pages -->|"serves images to"| node_confluence

click node_diagrams "https://github.com/incogniadev/diagrams/tree/main/drawio"
click node_generator "https://github.com/incogniadev/diagrams/blob/main/scripts/generate.sh"
click node_pngs "https://github.com/incogniadev/diagrams/tree/main/public"
click node_preview "https://github.com/incogniadev/diagrams/blob/main/public/index.html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_diagrams,node_confluence toneBlue
class node_generator toneAmber
class node_pngs,node_preview toneMint
class node_user,node_desktop,node_pages toneIndigo
```

## Components

### Diagram sources

- [Draw.io files](https://github.com/incogniadev/diagrams/tree/main/drawio): `drawio`

### Local generation

- [PNG generator](https://github.com/incogniadev/diagrams/blob/main/scripts/generate.sh): `scripts/generate.sh`

### Static publishing

- [Generated PNGs](https://github.com/incogniadev/diagrams/tree/main/public): `public`
- [Preview page](https://github.com/incogniadev/diagrams/blob/main/public/index.html): `public/index.html`

### Other components

- **Diagram editor**
- **Draw.io Desktop**
- **GitHub Pages**
- **Confluence users**

## Connections

- Diagram editor → Draw.io files: edits (evidence: `README.md`)
- PNG generator → Draw.io files: processes (evidence: `README.md`)
- PNG generator → Draw.io Desktop: converts with (evidence: `README.md`)
- PNG generator → Generated PNGs: generates (evidence: `README.md`)
- PNG generator → Preview page: generates (evidence: `README.md`)
- Generated PNGs → GitHub Pages: publishes (evidence: `README.md`)
- Preview page → GitHub Pages: publishes (evidence: `README.md`)
- GitHub Pages → Confluence users: serves images to (evidence: `README.md`)