Skip to main content
VhyxChart
Text-first · 30 KB · animated SVG for GitHub

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.

Get startedOpen playgroundpnpm add @vhyxchart/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.

Scenarios

Tokens travel edges, nodes change state, notes appear. Many scenarios per diagram, one layout.

Play, step, scrub

Every frame is a pure function of time, so scrubbing backwards is exact.

Animated on GitHub

Export SMIL-animated SVG that plays inside README images. No JavaScript.

Bring existing diagrams

Flowcharts, sequence and state diagrams you already have render unchanged.

VS Code live preview

Fences animate in the Markdown preview; .vhyx files preview as you type.

Tiny and deterministic

~30 KB gzipped, zero dependencies, same output in Node and the browser.