# ooiuuii/archify architecture

> Architecture diagram of the GitHub repository ooiuuii/archify, 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/ooiuuii/archify
- Repository: https://github.com/ooiuuii/archify

## Overview

Archify turns a system description or typed JSON diagram into a validated, deterministic, interactive HTML/SVG artifact. The principal flow is an agent or engineer invoking the CLI, which loads and validates input, dispatches a diagram renderer, and writes a shareable artifact. Separate capabilities include architecture-delta comparison and five diagram types; shared rendering services provide validation, evidence checks, layout, branding, localization, and diagnostics. The README documents viewer interactions and export formats. Several CLI dispatch details and unsampled renderer connections are not shown, so those links are omitted or marked unverified.

Main entry points: [`archify/bin/archify.mjs`](https://github.com/ooiuuii/archify/blob/main/archify/bin/archify.mjs) (Archify CLI), [`archify/renderers/shared/legend.mjs`](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/legend.mjs) (Legend layout), [`archify/renderers/shared/geometry.mjs`](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/geometry.mjs) (Layout geometry), [`archify/renderers/shared/brand-marks.mjs`](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/brand-marks.mjs) (Brand marks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring and CLI"]
  node_cli["Archify CLI<br/>[archify.mjs]"]
  node_scenarios["Scenario recipes<br/>[scenarios.mjs]"]
end

subgraph group_rendering["Diagram renderers"]
  node_architecture["Architecture renderer"]
  node_workflow["Workflow renderer"]
  node_sequence["Sequence renderer"]
  node_dataflow["Dataflow renderer"]
  node_lifecycle["Lifecycle renderer"]
end

subgraph group_shared["Rendering services"]
  node_validator["Schema validation<br/>[validator.mjs]"]
  node_evidence["Source evidence"]
  node_engineering["Engineering profiles"]
  node_geometry["Layout geometry<br/>[geometry.mjs]"]
  node_legend["Legend layout<br/>[legend.mjs]"]
  node_brand["Brand marks<br/>[brand-marks.mjs]"]
  node_i18n["Localization<br/>[i18n.mjs]"]
  node_diagnostics["Diagnostics<br/>[diagnostics.mjs]"]
end

subgraph group_review["Review capabilities"]
  node_delta["Architecture delta"]
end

subgraph group_artifact["Artifact experience"]
  node_preview["Live preview<br/>[preview.mjs]"]
  node_open["Open artifact<br/>[open-artifact.mjs]"]
  node_visualcheck["Visual checking<br/>[visual-check.mjs]"]
  node_artifactfile["Interactive diagram artifact"]
  node_viewer["Artifact viewer<br/>[utils.mjs]"]
end

node_agent(("Agent or engineer"))
node_user(("Viewer user"))

node_agent -->|"provides input"| node_cli
node_cli -->|"validates input"| node_validator
node_cli -->|"verifies evidence"| node_evidence
node_cli -->|"checks profile"| node_engineering
node_cli -.->|"dispatches render"| node_architecture
node_cli -.->|"dispatches render"| node_workflow
node_cli -.->|"dispatches render"| node_sequence
node_cli -.->|"dispatches render"| node_dataflow
node_cli -.->|"dispatches render"| node_lifecycle
node_cli -.->|"compares snapshots"| node_delta
node_cli -->|"writes artifact"| node_artifactfile
node_scenarios -.->|"supplies scenarios"| node_artifactfile
node_architecture -->|"uses layout"| node_geometry
node_architecture -->|"resolves legend"| node_legend
node_architecture -->|"renders marks"| node_brand
node_workflow -->|"uses layout"| node_geometry
node_workflow -->|"resolves legend"| node_legend
node_workflow -->|"renders marks"| node_brand
node_workflow -->|"validates schema"| node_validator
node_sequence -->|"uses layout"| node_geometry
node_sequence -->|"uses legend"| node_legend
node_sequence -->|"renders marks"| node_brand
node_dataflow -->|"uses layout"| node_geometry
node_dataflow -->|"uses legend"| node_legend
node_dataflow -->|"renders marks"| node_brand
node_lifecycle -->|"uses layout"| node_geometry
node_lifecycle -->|"uses legend"| node_legend
node_lifecycle -->|"renders marks"| node_brand
node_geometry -->|"records issues"| node_diagnostics
node_legend -->|"checks overlap"| node_geometry
node_legend -->|"translates labels"| node_i18n
node_brand -->|"reports failures"| node_diagnostics
node_delta -->|"presents comparison"| node_artifactfile
node_preview -->|"serves preview"| node_artifactfile
node_preview -->|"opens preview"| node_open
node_visualcheck -->|"checks output"| node_artifactfile
node_artifactfile -->|"embeds viewer"| node_viewer
node_user -->|"interacts with"| node_viewer

click node_cli "https://github.com/ooiuuii/archify/blob/main/archify/bin/archify.mjs"
click node_scenarios "https://github.com/ooiuuii/archify/blob/main/archify/recipes/scenarios.mjs"
click node_architecture "https://github.com/ooiuuii/archify/blob/main/archify/renderers/architecture/render-architecture.mjs"
click node_workflow "https://github.com/ooiuuii/archify/blob/main/archify/renderers/workflow/workflow-compiler.mjs"
click node_sequence "https://github.com/ooiuuii/archify/blob/main/archify/renderers/sequence/render-sequence.mjs"
click node_dataflow "https://github.com/ooiuuii/archify/blob/main/archify/renderers/dataflow/render-dataflow.mjs"
click node_lifecycle "https://github.com/ooiuuii/archify/blob/main/archify/renderers/lifecycle/render-lifecycle.mjs"
click node_validator "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/validator.mjs"
click node_evidence "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/repository-evidence.mjs"
click node_engineering "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/engineering-profiles.mjs"
click node_geometry "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/geometry.mjs"
click node_legend "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/legend.mjs"
click node_brand "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/brand-marks.mjs"
click node_i18n "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/i18n.mjs"
click node_diagnostics "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/diagnostics.mjs"
click node_delta "https://github.com/ooiuuii/archify/blob/main/archify/delta/architecture-delta.mjs"
click node_preview "https://github.com/ooiuuii/archify/blob/main/archify/bin/preview.mjs"
click node_open "https://github.com/ooiuuii/archify/blob/main/archify/bin/open-artifact.mjs"
click node_visualcheck "https://github.com/ooiuuii/archify/blob/main/archify/bin/visual-check.mjs"
click node_viewer "https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/utils.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_cli,node_scenarios,node_user toneBlue
class node_architecture,node_workflow,node_sequence,node_dataflow,node_lifecycle toneAmber
class node_validator,node_evidence,node_engineering,node_geometry,node_legend,node_brand,node_i18n,node_diagnostics toneMint
class node_delta toneRose
class node_preview,node_open,node_visualcheck,node_artifactfile,node_viewer,node_agent toneIndigo
```

## Components

### Authoring and CLI

- [Archify CLI](https://github.com/ooiuuii/archify/blob/main/archify/bin/archify.mjs): `archify/bin/archify.mjs`
- [Scenario recipes](https://github.com/ooiuuii/archify/blob/main/archify/recipes/scenarios.mjs): `archify/recipes/scenarios.mjs`

### Diagram renderers

- [Architecture renderer](https://github.com/ooiuuii/archify/blob/main/archify/renderers/architecture/render-architecture.mjs): `archify/renderers/architecture/render-architecture.mjs`
- [Workflow renderer](https://github.com/ooiuuii/archify/blob/main/archify/renderers/workflow/workflow-compiler.mjs): `archify/renderers/workflow/workflow-compiler.mjs`
- [Sequence renderer](https://github.com/ooiuuii/archify/blob/main/archify/renderers/sequence/render-sequence.mjs): `archify/renderers/sequence/render-sequence.mjs`
- [Dataflow renderer](https://github.com/ooiuuii/archify/blob/main/archify/renderers/dataflow/render-dataflow.mjs): `archify/renderers/dataflow/render-dataflow.mjs`
- [Lifecycle renderer](https://github.com/ooiuuii/archify/blob/main/archify/renderers/lifecycle/render-lifecycle.mjs): `archify/renderers/lifecycle/render-lifecycle.mjs`

### Rendering services

- [Schema validation](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/validator.mjs): `archify/renderers/shared/validator.mjs`
- [Source evidence](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/repository-evidence.mjs): `archify/renderers/shared/repository-evidence.mjs`
- [Engineering profiles](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/engineering-profiles.mjs): `archify/renderers/shared/engineering-profiles.mjs`
- [Layout geometry](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/geometry.mjs): `archify/renderers/shared/geometry.mjs`
- [Legend layout](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/legend.mjs): `archify/renderers/shared/legend.mjs`
- [Brand marks](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/brand-marks.mjs): `archify/renderers/shared/brand-marks.mjs`
- [Localization](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/i18n.mjs): `archify/renderers/shared/i18n.mjs`
- [Diagnostics](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/diagnostics.mjs): `archify/renderers/shared/diagnostics.mjs`

### Review capabilities

- [Architecture delta](https://github.com/ooiuuii/archify/blob/main/archify/delta/architecture-delta.mjs): `archify/delta/architecture-delta.mjs`

### Artifact experience

- [Live preview](https://github.com/ooiuuii/archify/blob/main/archify/bin/preview.mjs): `archify/bin/preview.mjs`
- [Open artifact](https://github.com/ooiuuii/archify/blob/main/archify/bin/open-artifact.mjs): `archify/bin/open-artifact.mjs`
- [Visual checking](https://github.com/ooiuuii/archify/blob/main/archify/bin/visual-check.mjs): `archify/bin/visual-check.mjs`
- **Interactive diagram artifact**
- [Artifact viewer](https://github.com/ooiuuii/archify/blob/main/archify/renderers/shared/utils.mjs): `archify/renderers/shared/utils.mjs`

### Other components

- **Agent or engineer**
- **Viewer user**

## Connections

- Agent or engineer → Archify CLI: provides input (evidence: `README.md`)
- Archify CLI → Schema validation: validates input
- Archify CLI → Source evidence: verifies evidence
- Archify CLI → Engineering profiles: checks profile
- Archify CLI → Architecture renderer: dispatches render
- Archify CLI → Workflow renderer: dispatches render
- Archify CLI → Sequence renderer: dispatches render
- Archify CLI → Dataflow renderer: dispatches render
- Archify CLI → Lifecycle renderer: dispatches render
- Archify CLI → Architecture delta: compares snapshots (evidence: `README.md`)
- Archify CLI → Interactive diagram artifact: writes artifact
- Scenario recipes → Interactive diagram artifact: supplies scenarios (evidence: `README.md`)
- Architecture renderer → Layout geometry: uses layout (evidence: `archify/renderers/architecture/render-architecture.mjs`)
- Architecture renderer → Legend layout: resolves legend (evidence: `archify/renderers/architecture/render-architecture.mjs`)
- Architecture renderer → Brand marks: renders marks (evidence: `archify/renderers/architecture/render-architecture.mjs`)
- Workflow renderer → Layout geometry: uses layout (evidence: `archify/renderers/workflow/workflow-compiler.mjs`)
- Workflow renderer → Legend layout: resolves legend (evidence: `archify/renderers/workflow/workflow-compiler.mjs`)
- Workflow renderer → Brand marks: renders marks (evidence: `archify/renderers/workflow/workflow-compiler.mjs`)
- Workflow renderer → Schema validation: validates schema (evidence: `archify/renderers/workflow/workflow-compiler.mjs`)
- Sequence renderer → Layout geometry: uses layout (evidence: `archify/renderers/sequence/render-sequence.mjs`)
- Sequence renderer → Legend layout: uses legend (evidence: `archify/renderers/sequence/render-sequence.mjs`)
- Sequence renderer → Brand marks: renders marks (evidence: `archify/renderers/sequence/render-sequence.mjs`)
- Dataflow renderer → Layout geometry: uses layout (evidence: `archify/renderers/dataflow/render-dataflow.mjs`)
- Dataflow renderer → Legend layout: uses legend (evidence: `archify/renderers/dataflow/render-dataflow.mjs`)
- Dataflow renderer → Brand marks: renders marks (evidence: `archify/renderers/dataflow/render-dataflow.mjs`)
- Lifecycle renderer → Layout geometry: uses layout (evidence: `archify/renderers/lifecycle/render-lifecycle.mjs`)
- Lifecycle renderer → Legend layout: uses legend (evidence: `archify/renderers/lifecycle/render-lifecycle.mjs`)
- Lifecycle renderer → Brand marks: renders marks (evidence: `archify/renderers/lifecycle/render-lifecycle.mjs`)
- Layout geometry → Diagnostics: records issues (evidence: `archify/renderers/shared/geometry.mjs`)
- Legend layout → Layout geometry: checks overlap (evidence: `archify/renderers/shared/legend.mjs`)
- Legend layout → Localization: translates labels (evidence: `archify/renderers/shared/legend.mjs`)
- Brand marks → Diagnostics: reports failures (evidence: `archify/renderers/shared/brand-marks.mjs`)
- Architecture delta → Interactive diagram artifact: presents comparison (evidence: `README.md`)
- Live preview → Interactive diagram artifact: serves preview (evidence: `archify/bin/preview.mjs`)
- Live preview → Open artifact: opens preview (evidence: `archify/bin/preview.mjs`)
- Visual checking → Interactive diagram artifact: checks output (evidence: `archify/bin/visual-check.mjs`)
- Interactive diagram artifact → Artifact viewer: embeds viewer (evidence: `README.md`)
- Viewer user → Artifact viewer: interacts with (evidence: `README.md`)
