ArchStepexecutable architecture documentation
TEXT-FIRST ARCHITECTURE DIAGRAMS

Draw the sequence.
Watch it run.

ArchStep compiles Step, a small text DSL, into an animated, playable diagram of how your services actually talk — sequential calls, parallel fan-out, and live data state, right there in the canvas.

or import an existing Mermaid diagram →
LIVE — checkout.step
WHY

Why ArchStep

It's just text

Diagrams are diffable, reviewable, and versioned right next to the code they describe — no drag-and-drop tool to fight, no binary file to merge-conflict.

Shows the sequence, not just the shape

A flowchart shows what's connected. ArchStep shows what happens: in what order, what runs in parallel, and what data changed, when.

Parallel is a first-class citizen

A parallel { } block fires every edge inside it together on screen — fan-out and fan-in render exactly like they run in production.

Bring your Mermaid diagrams

Already have a sequenceDiagram in Mermaid? Paste it in and get a live ArchStep canvas — no rewrite.

HOW

How it works

01
Declare the architecture
architecture {
  service User at (0, 0)
  service API at (200, 0)
}

Name the services, databases, and queues, and give each a fixed (x, y) — layout is explicit, never auto-guessed.

02
Write the scenario
scenario Checkout {
  User -> API: "place order"
  ...
}

The actual sequence of calls, in order — plus parallel { } blocks and state updates wherever the data tracker should light up.

03
Press play
> Checkout
  User → API

The compiler validates every reference and the canvas animates the sequence tick by tick — step through it, scrub it, or let it run.

04
Keep it with the code
git add checkout.step

It's a text file. Review it in a PR, keep it beside the service it documents, and it never quietly drifts out of date.

FEATURES

Built for the sequence, not the sketch

Live playback

Play, pause, step one tick at a time, or jump straight to any point in the sequence.

Data tracker

Track one or more named variables through a scenario; every value that changes on a tick highlights the instant it happens.

Parallel blocks

Model real fan-out/fan-in, not a maze of crossing arrows that all claim to happen "at some point."

Mermaid import

Convert a Mermaid sequenceDiagram straight to the canvas, with a tab to peek the generated Step source.

Ready to see your architecture run?

Open the Editor →Browse examples