CONCEPTS

Five ideas that make DiagramZu click

DiagramZu is small on purpose. Learn these five ideas and you'll know exactly what to ask your AI for — and what your team gets back.

Built for three workflows

Review AI proposals

Your agent proposes an architecture and drops a diagram here. You approve it in seconds — instead of reading 600 lines of prose.

Hand off to your team

Share the architecture as one link. Version history records what changed and when — legible to humans now, and to the next agent later.

Reuse in presentations

The diagram your engineers reviewed is the one your CEO drops into the deck. One source of truth, not three stale copies.

Descriptions are the brief

Every diagram carries a written purpose that travels with it — readers see it, and the next agent reads it.

Ask your AI to write a one or two sentence description when it creates or updates a diagram. It becomes the subhead on the public share link, and it's the first thing the next agent reads when it fetches the diagram. The description is the why and the what; the code is the how.

first-class
round-trips
the agent's brief

Share links, not screenshots

Turn any diagram into an unguessable, view-only URL that works without a login.

A share link is how an AI-authored diagram leaves DiagramZu. It's 22 random characters, opens for anyone, and shows only the rendered picture — no editor, no code. Revoke it from the Share menu and it stops working instantly. Perfect for onboarding docs, review threads, or the “see an example” link in a README.

view-only
revocable
no login

Versions you choose

Snapshots are deliberate — taken at a human checkpoint or after an agent makes a real change, never on every keystroke.

Your AI passes createVersion: true on update; you hit Save version in the toolbar. There's no autosave noise to wade through. Restoring an old version snapshots the current one first, so you can never lose work — and “fork as new” lifts a version into its own diagram without touching the original.

deliberate
safe restore
fork as new

Layout, decided for you

Set layout to auto and a deterministic classifier picks the right shape from the graph itself.

Trees resolve to a tidy tree layout, dense cyclic graphs to a force layout, clean DAGs to dagre — six concrete layouts, chosen once on save and frozen, so the picture is always reproducible. Don't like the pick? Override it from the toolbar in one click.

one-shot
six layouts
reproducible

Embeds that never go stale

Drop a diagram into any page with one iframe — theme-matched, interactive, and always current.

An embed points at a share link, so it always shows the live diagram — edit it in DiagramZu and every embed updates itself. The frame carries no editor chrome, supports pan and zoom, and matches its host page's light or dark theme. A quiet badge links home, and the Embed tab shows 7-day load counts. Works anywhere iframes do — docs sites, Notion, blogs, wikis.

always live
theme-matched
load stats