excalidrawlisted

# Excalidraw Diagram Generator Generate `.excalidraw` JSON files that open in the VS Code Excalidraw extension. Designed for creating diagrams the user can draw on top of during screencasts. --- ## Arguments | Arg | Description | Default | |-----|-------------|---------| | **description** | What to diagram (rest of invocation text) | *(required)* | | `--type` | `architecture`, `flow`, `sequence`, `mindmap`, `er`, `custom` | Auto-detect | | `--output` | File path for output | `./{slug}.excalidraw` (current directory) | | `--layout` | `vertical`, `horizontal`, `hub-spoke` | Auto-detect from type | --- ## Setup On first invocation, load `references/style-guide.md` for color palette, spacing rules, element defaults, and JSON templates. The style guide ships a default "Vintage-Tech Dark Teal" palette — swap the colors for your own brand if you have one. --- ## Workflow ### 1. UNDERSTAND - Parse the description to determine what to diagram - Auto-detect type if not specified: - Components + connections → `architecture` - Steps + decisions → `flow` - Actor interactions over time → `sequence` - Hierarchical concepts → `mindmap` - Entities + relationships → `er` - Choose layout: vertical (default for flow/sequence), horizontal (pipeline), hub-spoke (architecture with central service) ### 2. GENERATE - Build the `.excalidraw` JSON following style-guide.md rules - Use descriptive IDs (`api-gateway`, `user-db`) — NOT UUIDs - Use `label` property for text in shapes