![\"npm](\"https://img.shields.io/npm/v/@swiftlysingh/excalidraw-cli\")
\n ![\"MIT](\"https://img.shields.io/badge/license-MIT-blue\"){kind=icon}
\n\n
\n \n
\n Create Excalidraw flowcharts and diagrams from text-based DSL or JSON.\n
\n\n\n\n## Features\n\n- **Text-based DSL** for quick flowchart creation\n- **JSON API** for programmatic use\n- **Auto-layout** using ELK.js (Eclipse Layout Kernel)\n- **Multiple flow directions**: TB (top-bottom), BT, LR, RL\n- **Export to PNG & SVG** with dark mode, custom backgrounds, scale, and padding\n- **Programmable API** for integration into other tools\n\n\n## Installation\n\nRequires `Node >=20.19.0`. Node 18 is no longer supported.\n\n### Using npm\n\n```bash\nnpm i @swiftlysingh/excalidraw-cli\n```\n\n### From Source (Local Development)\n\n```bash\ngit clone https://github.com/swiftlysingh/excalidraw-cli.git\ncd excalidraw-cli\nnpm install\nnpm run build\nnpm link # Makes 'excalidraw-cli' available globally\n```\n\n### Direct Usage (No Install)\n\n```bash\n# Run directly with node\nnode dist/cli.js create --inline \"[A] -> [B]\" -o diagram.excalidraw\n```\n\n## Quick Start\n\n### Create from DSL\n\n```bash\n# Inline DSL\nexcalidraw-cli create --inline \"(Start) -> [Process] -> {Decision?}\" -o flow.excalidraw\n\n# From file\nexcalidraw-cli create flowchart.dsl -o diagram.excalidraw\n\n# From stdin\necho \"[A] -> [B] -> [C]\" | excalidraw-cli create --stdin -o diagram.excalidraw\n```\n\n### Export to Image\n\n```bash\n# Convert an existing .excalidraw file to PNG\nexcalidraw-cli convert diagram.excalidraw --format png\n\n# Convert with options\nexcalidraw-cli convert diagram.excalidraw --format png --scale 2 --dark\n\n# Convert to SVG without background\nexcalidraw-cli convert diagram.excalidraw --format svg --no-export-background\n```\n\n### DSL Syntax\n\n| Syntax | Element | Description |\n|--------|---------|-------------|\n| `[Label]` | Rectangle | Process steps, actions |\n| `{Label}` | Diamond | Decisions, conditionals |\n| `(Label)` | Ellipse | Start/End points |\n| `[[Label]]` | Database | Data storage |\n| `->` | Arrow | Connection |\n| `-->` | Dashed Arrow | Dashed connection |\n| `-> \"text\" ->` | Labeled Arrow | Connection with label |\n\n### Example DSL\n\n```\n(Start) -> [Enter Credentials] -> {Valid?}\n{Valid?} -> \"yes\" -> [Dashboard] -> (End)\n{Valid?} -> \"no\" -> [Show Error] -> [Enter Credentials]\n```\n\n### Directives\n\n```\n@direction LR # Left to Right (default: TB)\n@spacing 60 # Node spacing in pixels\n```\n\n## CLI Reference\n\n### Commands\n\n#### `create`\n\nCreate an Excalidraw flowchart.\n\n```bash\nexcalidraw-cli create [input] [options]\n```\n\n**Options:**\n- `-o, --output