# allenasat044-prog/doing-it-in-public architecture

> Architecture diagram of the GitHub repository allenasat044-prog/doing-it-in-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/allenasat044-prog/doing-it-in-public
- Repository: https://github.com/allenasat044-prog/doing-it-in-public

## Overview

Quartz is a digital-garden publishing tool: it takes a user’s notes and configuration, processes Markdown through configurable plugins, then renders and emits a static website. The graph emphasizes that build workflow while retaining page types, component rendering, plugin configuration, and the CLI’s plugin-management capability. Several subsystems are represented by exact tree paths but were not excerpted; their connections are shown only where the README or SOURCE INDEX supports them.

Main entry points: [`quartz/build.ts`](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/build.ts) (Build orchestration), [`quartz/processors/emit.ts`](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/emit.ts) (File emission), [`quartz/components/renderPage.tsx`](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/components/renderPage.tsx) (Page rendering), [`quartz/processors/parse.ts`](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/parse.ts) (Markdown parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Build pipeline"]
  node_build_entry["Build orchestration<br/>[build.ts]"]
  node_context["Build context<br/>[ctx.ts]"]
  node_parse["Markdown parsing<br/>[parse.ts]"]
  node_content["Processed content<br/>[vfile.ts]"]
  node_filter["Publish filtering<br/>[filter.ts]"]
  node_emit["File emission<br/>[emit.ts]"]
end

subgraph group_plugins["Plugin system"]
  node_config_loader["Configuration loading<br/>[config-loader.ts]"]
  node_plugin_config["Plugin configuration<br/>[config.ts]"]
  node_transformers["Content transformers"]
  node_page_types["Page types"]
  node_dispatcher["Page dispatcher<br/>[dispatcher.ts]"]
  node_emitters["Output emitters"]
  node_resources["Component resources"]
end

subgraph group_pages["Page rendering"]
  node_render["Page rendering<br/>[renderPage.tsx]"]
  node_components["Page components<br/>[registry.ts]"]
  node_frames["Page frames"]
  node_i18n["Translations<br/>[index.ts]"]
end

subgraph group_management["Plugin management"]
  node_cli["CLI commands<br/>[handlers.js]"]
  node_git_plugins["Git plugin actions"]
  node_plugin_data["Plugin metadata<br/>[plugin-data.js]"]
end

node_author(("Garden author"))
node_notes["Markdown notes"]
node_site["Static website"]

node_author -->|"writes"| node_notes
node_notes -.->|"provides notes"| node_build_entry
node_build_entry -->|"parses"| node_parse
node_build_entry -->|"filters"| node_filter
node_build_entry -->|"emits"| node_emit
node_parse -->|"produces"| node_content
node_filter -->|"filters content"| node_content
node_emit -->|"emits from"| node_content
node_build_entry -->|"configures"| node_context
node_build_entry -->|"loads config"| node_config_loader
node_config_loader -.->|"loads plugins"| node_plugin_config
node_parse -->|"runs transforms"| node_transformers
node_emit -->|"runs emitters"| node_emitters
node_emit -->|"runs first"| node_resources
node_emit -->|"runs second"| node_dispatcher
node_dispatcher -.->|"dispatches"| node_page_types
node_dispatcher -->|"renders pages"| node_render
node_render -->|"uses registry"| node_components
node_render -->|"uses frames"| node_frames
node_render -->|"uses translations"| node_i18n
node_emit -->|"writes site"| node_site
node_author -.->|"runs commands"| node_cli
node_cli -->|"dispatches"| node_git_plugins
node_git_plugins -->|"reads and writes"| node_plugin_data

click node_build_entry "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/build.ts"
click node_context "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/util/ctx.ts"
click node_parse "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/parse.ts"
click node_content "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/vfile.ts"
click node_filter "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/filter.ts"
click node_emit "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/emit.ts"
click node_config_loader "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/loader/config-loader.ts"
click node_plugin_config "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/config.ts"
click node_transformers "https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/plugins/transformers"
click node_page_types "https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/plugins/pageTypes"
click node_dispatcher "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/pageTypes/dispatcher.ts"
click node_emitters "https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/plugins/emitters"
click node_resources "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/emitters/componentResources.ts"
click node_render "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/components/renderPage.tsx"
click node_components "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/components/registry.ts"
click node_frames "https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/components/frames"
click node_i18n "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/i18n/index.ts"
click node_cli "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/cli/handlers.js"
click node_git_plugins "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/cli/plugin-git-handlers.js"
click node_plugin_data "https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/cli/plugin-data.js"

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_build_entry,node_context,node_parse,node_content,node_filter,node_emit toneBlue
class node_config_loader,node_plugin_config,node_transformers,node_page_types,node_dispatcher,node_emitters,node_resources toneAmber
class node_render,node_components,node_frames,node_i18n toneMint
class node_cli,node_git_plugins,node_plugin_data toneRose
class node_author,node_notes,node_site toneIndigo
```

## Components

### Build pipeline

- [Build orchestration](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/build.ts): `quartz/build.ts`
- [Build context](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/util/ctx.ts): `quartz/util/ctx.ts`
- [Markdown parsing](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/parse.ts): `quartz/processors/parse.ts`
- [Processed content](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/vfile.ts): `quartz/plugins/vfile.ts`
- [Publish filtering](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/filter.ts): `quartz/processors/filter.ts`
- [File emission](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/processors/emit.ts): `quartz/processors/emit.ts`

### Plugin system

- [Configuration loading](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/loader/config-loader.ts): `quartz/plugins/loader/config-loader.ts`
- [Plugin configuration](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/config.ts): `quartz/plugins/config.ts`
- [Content transformers](https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/plugins/transformers): `quartz/plugins/transformers`
- [Page types](https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/plugins/pageTypes): `quartz/plugins/pageTypes`
- [Page dispatcher](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/pageTypes/dispatcher.ts): `quartz/plugins/pageTypes/dispatcher.ts`
- [Output emitters](https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/plugins/emitters): `quartz/plugins/emitters`
- [Component resources](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/plugins/emitters/componentResources.ts): `quartz/plugins/emitters/componentResources.ts`

### Page rendering

- [Page rendering](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/components/renderPage.tsx): `quartz/components/renderPage.tsx`
- [Page components](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/components/registry.ts): `quartz/components/registry.ts`
- [Page frames](https://github.com/allenasat044-prog/doing-it-in-public/tree/main/quartz/components/frames): `quartz/components/frames`
- [Translations](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/i18n/index.ts): `quartz/i18n/index.ts`

### Plugin management

- [CLI commands](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/cli/handlers.js): `quartz/cli/handlers.js`
- [Git plugin actions](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/cli/plugin-git-handlers.js): `quartz/cli/plugin-git-handlers.js`
- [Plugin metadata](https://github.com/allenasat044-prog/doing-it-in-public/blob/main/quartz/cli/plugin-data.js): `quartz/cli/plugin-data.js`

### Other components

- **Garden author**
- **Markdown notes**
- **Static website**

## Connections

- Garden author → Markdown notes: writes
- Markdown notes → Build orchestration: provides notes
- Build orchestration → Markdown parsing: parses (evidence: `quartz/build.ts`)
- Build orchestration → Publish filtering: filters (evidence: `quartz/build.ts`)
- Build orchestration → File emission: emits (evidence: `quartz/build.ts`)
- Markdown parsing → Processed content: produces (evidence: `quartz/processors/parse.ts`)
- Publish filtering → Processed content: filters content (evidence: `quartz/processors/filter.ts`)
- File emission → Processed content: emits from (evidence: `quartz/processors/emit.ts`)
- Build orchestration → Build context: configures (evidence: `quartz/build.ts`)
- Build orchestration → Configuration loading: loads config (evidence: `quartz/build.ts`)
- Configuration loading → Plugin configuration: loads plugins
- Markdown parsing → Content transformers: runs transforms (evidence: `quartz/processors/parse.ts`)
- File emission → Output emitters: runs emitters (evidence: `quartz/processors/emit.ts`)
- File emission → Component resources: runs first (evidence: `quartz/processors/emit.ts`)
- File emission → Page dispatcher: runs second (evidence: `quartz/processors/emit.ts`)
- Page dispatcher → Page types: dispatches
- Page dispatcher → Page rendering: renders pages (evidence: `quartz/plugins/pageTypes/dispatcher.ts`)
- Page rendering → Page components: uses registry (evidence: `quartz/components/renderPage.tsx`)
- Page rendering → Page frames: uses frames (evidence: `quartz/components/renderPage.tsx`)
- Page rendering → Translations: uses translations (evidence: `quartz/components/renderPage.tsx`)
- File emission → Static website: writes site (evidence: `quartz/processors/emit.ts`)
- Garden author → CLI commands: runs commands
- CLI commands → Git plugin actions: dispatches (evidence: `quartz/cli/handlers.js`)
- Git plugin actions → Plugin metadata: reads and writes (evidence: `quartz/cli/plugin-git-handlers.js`)
