# xiaolai/no-one-did-it architecture

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

- Interactive diagram: https://gitdiagram.com/xiaolai/no-one-did-it
- Repository: https://github.com/xiaolai/no-one-did-it
- Video tour (about a minute): https://gitdiagram.com/xiaolai/no-one-did-it/video

## Overview

This repository is the source and publishing apparatus for No One Did It. The principal workflow turns the canonical book text into EPUB and print editions; the print route additionally measures the interior before producing a fitted cover. The design studio is a separate authoring and asset-export branch. The graph preserves the README’s documented capabilities, but sampled excerpts do not expose all design-studio wiring or the EPUB assembly internals, so those relationships are omitted unless explicitly documented.

Main entry points: [`pipelines/design-studio/serve.mjs`](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/serve.mjs) (Studio server), [`pipelines/print/pipeline.mjs`](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/pipeline.mjs) (Print orchestrator), [`book/chapters-v6`](https://github.com/xiaolai/no-one-did-it/tree/main/book/chapters-v6) (Canonical text), [`pipelines/print/build-prose.mjs`](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-prose.mjs) (Prose conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_source["Book Sources"]
  node_canonical["Canonical text"]
  node_manuscript["EPUB manuscript<br/>[spine-v6.yml]"]
end

subgraph group_epub["EPUB Edition"]
  node_assemble["Assemble manuscript"]
  node_epubbuild["Build EPUB<br/>[build_kdp_epub.py]"]
  node_epubvalidate["Validate EPUB"]
end

subgraph group_print["Print Edition"]
  node_printpipeline["Print orchestrator<br/>[pipeline.mjs]"]
  node_prose["Prose conversion<br/>[build-prose.mjs]"]
  node_pdf["Interior renderer"]
  node_fonts["Font CSS<br/>[font-css.mjs]"]
  node_i18n["Print strings<br/>[i18n.mjs]"]
  node_finalize["PDF finalizer"]
  node_cover["Cover builder"]
end

subgraph group_studio["Design Studio"]
  node_serve["Studio server<br/>[serve.mjs]"]
  node_canvas["Design canvas<br/>[design-canvas.jsx]"]
  node_cartoon["Cartoon art<br/>[cartoon-art.jsx]"]
  node_cartoonview["Cartoon layouts<br/>[cartoon.jsx]"]
  node_covers["Cover layouts<br/>[covers.jsx]"]
  node_dossierfront["Dossier fronts<br/>[dossier-front.jsx]"]
  node_dossierchapters["Dossier chapters"]
  node_dossierback["Dossier backs<br/>[dossier-back.jsx]"]
  node_imageslot["Image slots<br/>[image-slot.js]"]
  node_tweaks["Design tweaks<br/>[tweaks-panel.jsx]"]
  node_shim["Runtime shim<br/>[omelette-shim.js]"]
  node_export["Asset exporter<br/>[export.mjs]"]
end

node_author(("Book editors"))
node_studioauthor(("Design authors"))

node_author -->|"authors"| node_canonical
node_canonical -->|"assembles from"| node_assemble
node_assemble -->|"writes manuscript"| node_manuscript
node_manuscript -->|"builds from"| node_epubbuild
node_epubbuild -->|"validate edition"| node_epubvalidate
node_canonical -->|"converts source"| node_prose
node_printpipeline -->|"runs"| node_prose
node_printpipeline -->|"runs"| node_pdf
node_printpipeline -->|"runs with page count"| node_cover
node_pdf -->|"generates CSS with"| node_fonts
node_prose -->|"loads strings"| node_i18n
node_printpipeline -->|"reads filename"| node_i18n
node_studioauthor -.->|"opens studio"| node_serve
node_serve -.->|"hosts canvas"| node_canvas
node_export -->|"requests solo route"| node_serve
node_serve -.->|"renders cover boards"| node_covers
node_serve -.->|"renders dossier boards"| node_dossierfront
node_serve -.->|"renders dossier boards"| node_dossierchapters
node_serve -.->|"renders dossier boards"| node_dossierback

click node_canonical "https://github.com/xiaolai/no-one-did-it/tree/main/book/chapters-v6"
click node_manuscript "https://github.com/xiaolai/no-one-did-it/blob/main/book/spine-v6.yml"
click node_assemble "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/epub/assemble_v6_manuscript.py"
click node_epubbuild "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/epub/build_kdp_epub.py"
click node_epubvalidate "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/epub/validate_kdp_epub.py"
click node_printpipeline "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/pipeline.mjs"
click node_prose "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-prose.mjs"
click node_pdf "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-print-pdf.mjs"
click node_fonts "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/font-css.mjs"
click node_i18n "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/i18n.mjs"
click node_finalize "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/print-pdf-finalize.py"
click node_cover "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-print-cover.py"
click node_serve "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/serve.mjs"
click node_canvas "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/design-canvas.jsx"
click node_cartoon "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/cartoon-art.jsx"
click node_cartoonview "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/cartoon.jsx"
click node_covers "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/covers.jsx"
click node_dossierfront "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/dossier-front.jsx"
click node_dossierchapters "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/dossier-chapters.jsx"
click node_dossierback "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/dossier-back.jsx"
click node_imageslot "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/image-slot.js"
click node_tweaks "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/tweaks-panel.jsx"
click node_shim "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/omelette-shim.js"
click node_export "https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/export.mjs"

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_canonical,node_manuscript toneBlue
class node_assemble,node_epubbuild,node_epubvalidate toneAmber
class node_printpipeline,node_prose,node_pdf,node_fonts,node_i18n,node_finalize,node_cover toneMint
class node_serve,node_canvas,node_cartoon,node_cartoonview,node_covers,node_dossierfront,node_dossierchapters,node_dossierback,node_imageslot,node_tweaks,node_shim,node_export toneRose
class node_author,node_studioauthor toneIndigo
```

## Components

### Book Sources

- [Canonical text](https://github.com/xiaolai/no-one-did-it/tree/main/book/chapters-v6): `book/chapters-v6`
- [EPUB manuscript](https://github.com/xiaolai/no-one-did-it/blob/main/book/spine-v6.yml): `book/spine-v6.yml`

### EPUB Edition

- [Assemble manuscript](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/epub/assemble_v6_manuscript.py): `pipelines/epub/assemble_v6_manuscript.py`
- [Build EPUB](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/epub/build_kdp_epub.py): `pipelines/epub/build_kdp_epub.py`
- [Validate EPUB](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/epub/validate_kdp_epub.py): `pipelines/epub/validate_kdp_epub.py`

### Print Edition

- [Print orchestrator](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/pipeline.mjs): `pipelines/print/pipeline.mjs`
- [Prose conversion](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-prose.mjs): `pipelines/print/build-prose.mjs`
- [Interior renderer](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-print-pdf.mjs): `pipelines/print/build-print-pdf.mjs`
- [Font CSS](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/font-css.mjs): `pipelines/print/font-css.mjs`
- [Print strings](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/i18n.mjs): `pipelines/print/i18n.mjs`
- [PDF finalizer](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/print-pdf-finalize.py): `pipelines/print/print-pdf-finalize.py`
- [Cover builder](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/print/build-print-cover.py): `pipelines/print/build-print-cover.py`

### Design Studio

- [Studio server](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/serve.mjs): `pipelines/design-studio/serve.mjs`
- [Design canvas](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/design-canvas.jsx): `pipelines/design-studio/design/design-canvas.jsx`
- [Cartoon art](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/cartoon-art.jsx): `pipelines/design-studio/design/cartoon-art.jsx`
- [Cartoon layouts](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/cartoon.jsx): `pipelines/design-studio/design/cartoon.jsx`
- [Cover layouts](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/covers.jsx): `pipelines/design-studio/design/covers.jsx`
- [Dossier fronts](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/dossier-front.jsx): `pipelines/design-studio/design/dossier-front.jsx`
- [Dossier chapters](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/dossier-chapters.jsx): `pipelines/design-studio/design/dossier-chapters.jsx`
- [Dossier backs](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/dossier-back.jsx): `pipelines/design-studio/design/dossier-back.jsx`
- [Image slots](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/image-slot.js): `pipelines/design-studio/design/image-slot.js`
- [Design tweaks](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/design/tweaks-panel.jsx): `pipelines/design-studio/design/tweaks-panel.jsx`
- [Runtime shim](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/omelette-shim.js): `pipelines/design-studio/omelette-shim.js`
- [Asset exporter](https://github.com/xiaolai/no-one-did-it/blob/main/pipelines/design-studio/export.mjs): `pipelines/design-studio/export.mjs`

### Other components

- **Book editors**
- **Design authors**

## Connections

- Book editors → Canonical text: authors (evidence: `README.md`)
- Canonical text → Assemble manuscript: assembles from (evidence: `README.md`)
- Assemble manuscript → EPUB manuscript: writes manuscript
- EPUB manuscript → Build EPUB: builds from (evidence: `pipelines/epub/build_kdp_epub.py`)
- Build EPUB → Validate EPUB: validate edition (evidence: `README.md`)
- Canonical text → Prose conversion: converts source (evidence: `README.md`)
- Print orchestrator → Prose conversion: runs (evidence: `pipelines/print/pipeline.mjs`)
- Print orchestrator → Interior renderer: runs (evidence: `pipelines/print/pipeline.mjs`)
- Print orchestrator → Cover builder: runs with page count (evidence: `pipelines/print/pipeline.mjs`)
- Interior renderer → Font CSS: generates CSS with (evidence: `pipelines/print/build-print-pdf.mjs`)
- Prose conversion → Print strings: loads strings (evidence: `pipelines/print/build-prose.mjs`)
- Print orchestrator → Print strings: reads filename (evidence: `pipelines/print/pipeline.mjs`)
- Design authors → Studio server: opens studio
- Studio server → Design canvas: hosts canvas
- Asset exporter → Studio server: requests solo route (evidence: `pipelines/design-studio/export.mjs`)
- Studio server → Cover layouts: renders cover boards
- Studio server → Dossier fronts: renders dossier boards
- Studio server → Dossier chapters: renders dossier boards
- Studio server → Dossier backs: renders dossier boards
