How ooiuuii/archify works
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.mjs Archify CLI · legend.mjs Legend layout · geometry.mjs Layout geometry · brand-marks.mjs Brand marks
Components 23
Authoring and CLI
- Archify CLI
archify/bin/archify.mjs - Scenario recipes
archify/recipes/scenarios.mjs
Diagram renderers
- Architecture renderer
archify/renderers/architecture/render-architecture.mjs - Workflow renderer
archify/renderers/workflow/workflow-compiler.mjs - Sequence renderer
archify/renderers/sequence/render-sequence.mjs - Dataflow renderer
archify/renderers/dataflow/render-dataflow.mjs - Lifecycle renderer
archify/renderers/lifecycle/render-lifecycle.mjs
Rendering services
- Schema validation
archify/renderers/shared/validator.mjs - Source evidence
archify/renderers/shared/repository-evidence.mjs - Engineering profiles
archify/renderers/shared/engineering-profiles.mjs - Layout geometry
archify/renderers/shared/geometry.mjs - Legend layout
archify/renderers/shared/legend.mjs - Brand marks
archify/renderers/shared/brand-marks.mjs - Localization
archify/renderers/shared/i18n.mjs - Diagnostics
archify/renderers/shared/diagnostics.mjs
Review capabilities
- Architecture delta
archify/delta/architecture-delta.mjs
Artifact experience
- Live preview
archify/bin/preview.mjs - Open artifact
archify/bin/open-artifact.mjs - Visual checking
archify/bin/visual-check.mjs - Interactive diagram artifact
- Artifact viewer
archify/renderers/shared/utils.mjs
Other components
- Agent or engineer
- Viewer user
Connections 38
- Agent or engineer → Archify CLI: provides input
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
README.md - Archify CLI → Interactive diagram artifact: writes artifact
- Scenario recipes → Interactive diagram artifact: supplies scenarios
README.md - Architecture renderer → Layout geometry: uses layout
archify/renderers/architecture/render-architecture.mjs - Architecture renderer → Legend layout: resolves legend
archify/renderers/architecture/render-architecture.mjs - Architecture renderer → Brand marks: renders marks
archify/renderers/architecture/render-architecture.mjs - Workflow renderer → Layout geometry: uses layout
archify/renderers/workflow/workflow-compiler.mjs - Workflow renderer → Legend layout: resolves legend
archify/renderers/workflow/workflow-compiler.mjs - Workflow renderer → Brand marks: renders marks
archify/renderers/workflow/workflow-compiler.mjs - Workflow renderer → Schema validation: validates schema
archify/renderers/workflow/workflow-compiler.mjs - Sequence renderer → Layout geometry: uses layout
archify/renderers/sequence/render-sequence.mjs - Sequence renderer → Legend layout: uses legend
archify/renderers/sequence/render-sequence.mjs - Sequence renderer → Brand marks: renders marks
archify/renderers/sequence/render-sequence.mjs - Dataflow renderer → Layout geometry: uses layout
archify/renderers/dataflow/render-dataflow.mjs - Dataflow renderer → Legend layout: uses legend
archify/renderers/dataflow/render-dataflow.mjs - Dataflow renderer → Brand marks: renders marks
archify/renderers/dataflow/render-dataflow.mjs - Lifecycle renderer → Layout geometry: uses layout
archify/renderers/lifecycle/render-lifecycle.mjs - Lifecycle renderer → Legend layout: uses legend
archify/renderers/lifecycle/render-lifecycle.mjs - Lifecycle renderer → Brand marks: renders marks
archify/renderers/lifecycle/render-lifecycle.mjs - Layout geometry → Diagnostics: records issues
archify/renderers/shared/geometry.mjs - Legend layout → Layout geometry: checks overlap
archify/renderers/shared/legend.mjs - Legend layout → Localization: translates labels
archify/renderers/shared/legend.mjs - Brand marks → Diagnostics: reports failures
archify/renderers/shared/brand-marks.mjs - Architecture delta → Interactive diagram artifact: presents comparison
README.md - Live preview → Interactive diagram artifact: serves preview
archify/bin/preview.mjs - Live preview → Open artifact: opens preview
archify/bin/preview.mjs - Visual checking → Interactive diagram artifact: checks output
archify/bin/visual-check.mjs - Interactive diagram artifact → Artifact viewer: embeds viewer
README.md - Viewer user → Artifact viewer: interacts with
README.md