Write your own diagram

live editor

C4, sequence, flowchart, use case, ER or dictionary — .alab, arch-lab JSON, or Mermaid, auto-detected and rendered live. Nothing leaves your browser. Syntax reference

How .alab, JSON and Mermaid relate

.alab is the format to write: it is what the syntax reference documents, what share links carry, and what reads cleanly in a code review. .archlab.json is the same C4 model on disk — the interchange form any other tool can read without implementing a grammar; the two are lossless twins in both directions (proved on every build), so you never have to write the JSON by hand. Mermaid is read and written too, lossily — the format toggle above the pane converts in place and states what each direction drops. Nothing you type is uploaded or stored.

Source text

switches by rewriting the text

archlab 1.0 dict
title "Customer API"
description "Every field the customer endpoints return, what it means, and where it comes from"

@dict
  section "Customer" [REST payload] #api
    desc "Returned by GET /customers/:id and embedded in every order"
    field id uuid required unique
      desc "Stable identifier. Never reused, so a deleted customer's id stays dead."
      source "accounts.customer.id"
      values "RFC 4122"
      example "9f2a1c3e-1c2f-4b6a-9c1e-0f2a1c3e4b5a"
    field email string required unique pii
      desc "Lowercased on write, which is what lets it be a unique key. Verified before an order may be placed."
      source "accounts.customer.email"
      values "RFC 5322"
    field display_name string
      desc "What the customer asked to be called. Free text — do not parse it into first and last."
      source "accounts.customer.display_name"
    field lifetime_value decimal(10,2) derived
      desc "Sum of settled orders. Recomputed nightly, so it lags a same-day order by up to 24 hours."
      source "warehouse.customer_ltv"
      example "1284.50"
    field legacy_crm_ref string deprecated
      desc "The pre-2024 identifier. Still written for the reporting export; read nothing new from it."
      source "crm.contact_ref"
  section "Order summary" [REST payload]
    desc "The abbreviated order embedded in a customer response"
    field id uuid required unique
      desc "The order's own identifier."
      source "orders.order.id"
    field status string required
      desc "Where the order is in its lifecycle."
      values "one of draft | sent | paid | refunded"
      example "paid"
    field placed_at timestamptz required
      desc "When the customer confirmed, not when the payment settled."
      source "orders.order.placed_at"

Tab indents · Esc then Tab leaves the editor · syntax reference

Diagram