Diagrams that move.
Write architecture, flows, sequences and algorithms as text. Add a scenario and watch requests travel, services fail and values sort — in docs, READMEs, VS Code and React.
---
title: Checkout request
---
flowchart LR
client([Browser]) --> gw[API Gateway]
gw -->|verify| auth[Auth]
gw --> orders[Orders]
orders --> db[(Postgres)]
orders -.-> queue{{Queue}}
queue --> mail[Email worker]
subgraph backend [Backend]
auth
orders
db
end
scenario Happy path
client -> gw : POST /checkout
gw -> auth : token
auth is done
gw -> orders
orders is active
orders -> db : insert
db is done
orders -> queue, orders -> gw
note orders : Order #42 created
queue -> mail : receipt
mail is done
gw -> client : 201 Created
orders is done
scenario Token expired
client -> gw : POST /checkout
gw -> auth
auth is error
note auth : JWT expired
gw -> client : 401
client is warn
A request travels through a gateway into services and a queue. Two scenarios: the happy path and an auth failure.
Text in, motion out
Familiar diagram syntax, plus a timeline. Nothing to draw by hand.
Tokens travel edges, nodes change state, notes appear. Many scenarios per diagram, one layout.
Every frame is a pure function of time, so scrubbing backwards is exact.
Export SMIL-animated SVG that plays inside README images. No JavaScript.
Flowcharts, sequence and state diagrams you already have render unchanged.
Fences animate in the Markdown preview; .vhyx files preview as you type.
~30 KB gzipped, zero dependencies, same output in Node and the browser.
Runs where your docs live
The same text renders everywhere, with the same output.