loadmap 0.1 npm GitHub
Theme

Examples

Checkout

Orders and events from phones pass an API gateway, wait in Kafka, are handled by a pool of worker pods and end in Postgres. The gateway's capacity is a vendor benchmark (± 30 %), the workers' cost per message a fit from a measured series. It compares today with a proposal, turns load into dates with a growth rate, and carries a story of three steps. Its boxes stand in three tiers, and events older than a minute are dropped under backlog.

Try: ▶ Play the story · click 7.4× under the slider, where the gateway reaches its target · drag the diagram, pinch or Ctrl-scroll to zoom, and Fit to see it whole.

The buttons export the board as it is now: a PNG, a poster with the limits and the scenarios compared, an SVG, or a WebM of the story. checkout.loadmap ↓ is the same model as text (on GitHub, and the TypeScript in examples/checkout). Open it in VS Code with the loadmap extension for a live preview beside the text, or in Neovim or Helix: In your editor. In the editor, hover a word to see what it is, or turn on Track live changes and change a capacity.

From the command line, with the docs running (pnpm dev):

loadmap record http://localhost:5173/examples/checkout/ --out checkout.gif --story --caption

Keeping it true

The model promises headroom in each scenario. loadmap check checkout.loadmap prints checkout.loadmap: 2 expectations hold, or fails the build that loses one, with its line:

expect "Today keeps 7×" { target: 7 }
expect "Proposed keeps 14×" { scenario: Proposed; target: 14 }