@alistigo/archify-render

Thin CLI wrapper around archify that renders an archify JSON-IR file into a standalone interactive HTML diagram.

Install

npm install -g @alistigo/archify-render
# or
yarn global add @alistigo/archify-render
# or
pnpm add -g @alistigo/archify-render

As a dev dependency:

npm install -D @alistigo/archify-render

Requires Node.js ≥ 18. The archify renderer is bundled as a dependency and installed automatically.

Usage

archify-render <input.archify.json>
archify-render render <input.archify.json>

The output path is read from the meta.output field inside the JSON file, so no --output flag is needed in the normal case.

Options

| Flag | Description | |------|-------------| | --output,-o <path> | Override the output HTML path | | --type,-t <type> | Diagram type: architecture (default), workflow, sequence, dataflow, lifecycle |

Examples

# Render using the output path baked into the JSON
archify-render .archify-out/typical-alistigo-artifact.archify.json

# Override output path
archify-render diagram.json --output my-diagram.html

# Render a workflow diagram
archify-render flow.json --type workflow

Input format

Expects an archify JSON-IR file — the intermediate format produced by @alistigo/calm-to-archify transform. The meta.output field in the JSON determines where the HTML is written.

About archify

archify is an open-source tool that turns a structured JSON description of a system into a fully interactive standalone HTML diagram — no server required, no external dependencies at runtime. archify-render is a thin CLI wrapper around it that handles path resolution and the archify JSON-IR format.

Thanks

A big thank you to the archify team for building a lightweight, dependency-free renderer that turns plain JSON into beautiful interactive diagrams — great work.