Diagram playground

Write a diagram as text and it renders here as you type. Canvas editing for six of ten notations. Nothing leaves your browser. Syntax reference ·

Source text

archlab 1.0 dict
title "order.placed event"
description "The envelope and payload every downstream consumer subscribes to — a contract with no table behind it."

@dict
  section "Envelope" [Kafka]
    desc "Present on every event on the topic, whatever the payload"
    field event_id uuid required unique
      desc "Deduplication key. A consumer that has seen this id has already processed the event."
      values "RFC 4122"
    field occurred_at timestamptz required
      desc "When the thing happened, not when the message was produced. Producers retry; this does not change."
    field version integer required
      desc "Schema version of the payload below. A consumer must ignore an envelope whose version it does not know."
      example "3"
  section "Payload"
    desc "Version 3. Fields are added, never removed or repurposed."
    field order_id uuid required
      desc "The order this event is about."
      source "orders.order.id"
    field customer_email string required pii
      desc "Denormalised onto the event so consumers need no lookup. Personal data — it leaves the boundary with the event."
      source "accounts.customer.email"
    field total_minor integer required
      desc "The order total in MINOR units, to avoid a float. Divide by 100 for a display value."
      example "128450"
    field currency string required
      values "ISO 4217"
      example "THB"
    field coupon_code string deprecated
      desc "Never populated since v2. Read the discounts array instead; this stays for consumers not yet migrated."

Tab indents · Esc then Tab leaves the editor · worked examples

Read-only