Excalidraw Diagram Generator

Generate valid .excalidraw JSON files that open directly in Excalidraw with clean, professional layout.

Workflow

1. Parse the request — identify diagram type (flowchart, architecture, ER, sequence, mind map, or free-form) and extract all nodes and relationships.
2. Read the theme — read references/theme-default.md for colors, fonts, spacing, and layout values. Never hardcode style values.
3. Read layout strategy — read references/layout-strategies.md and apply the matching diagram type strategy.
4. Build logical graph — list all nodes (id, label, shape type, semantic color) and edges (source, target, label, arrow style).
5. Assign positions — apply the layout algorithm to compute (x, y, width, height) for every node.
6. Route arrows — compute arrow attachment points, paths, and elbowed bends.
7. Generate legend — if the diagram uses multiple semantic colors, shape types, or arrow styles, add a legend row at the bottom of the main frame.
8. Wrap in frame — enclose the entire diagram (all nodes, arrows, and legend) inside a single frame element whose name is the diagram title. Do NOT add a separate title text element. Compute frame bounds from ALL visual elements — see "Frame Sizing" below.
9. Assemble and write — build the full JSON and write to <name>.excalidraw.

Element JSON Quick Reference

For full templates with all fields, read references/element-spec.md. Here's the minimum you need to remember: