Creating diagrams is tedious. You open a drawing tool, drag shapes, connect lines, align everything... for something that took 10 seconds to describe in words.

Describe your diagram in plain text. Or upload a file. Or paste an image. Excalidraw Converter uses the Claude Agent SDK to understand your input and generate a fully editable Excalidraw diagram in seconds.

Coming soon: Live demo at excalidraw-converter.vercel.app

In the meantime, clone and run locally in under 60 seconds.

Plus:

• Full Excalidraw editor with pan, zoom, and editing
• Resizable sidebar for comfortable input
• Local storage persistence — your work survives page refreshes
• Client-side timeout handling with clear error messages

Prerequisites: Node.js 18+ and Claude Code CLI (authenticated via OAuth)

git clone https://github.com/cskwork/excalidraw-converter.git
cd excalidraw-converter
npm install
npm run dev

Open http://localhost:3000 — that's it.

User Input (text / file / image)
        |
        v
  /api/convert route
        |
        v
  Claude Agent SDK
  (analyzes input, generates
   Excalidraw JSON elements)
        |
        v
  Validation + Auto Layout
        |
        v
  Excalidraw Editor
  (fully editable output)

1. You provide input via the sidebar (text description, file upload, or image upload)
2. The input is sent to the /api/convert API route
3. Claude Agent SDK analyzes your input and generates structured Excalidraw elements
4. Elements are validated, auto-laid out for readability, and rendered in the Excalidraw editor
5. You can edit, export, or share the result — it's a real Excalidraw diagram

• Software Architecture: "Draw a microservices architecture with API gateway, 3 services, and a database"
• Flowcharts: "Create a user authentication flow with login, 2FA, and password reset"
• Data Visualization: Upload a CSV and get a visual representation
• Image to Editable: Screenshot a whiteboard photo and convert it to clean, editable shapes
• Documentation: Convert Markdown documentation into visual diagrams

Contributions are welcome! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests (npm test)
5. Commit your changes (git commit -m 'feat: add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

See open issues for ideas on what to work on.

MIT -- see LICENSE for details.