Skip to content
Back to search

next-ai-draw-io

A next.js web application that integrates AI capabilities with draw.io diagrams. This app allows you to create, modify, and enhance diagrams through natural language commands and AI-assisted visualization.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/DayuanJiang/next-ai-draw-io with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/DayuanJiang/next-ai-draw-io'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dayuanjiang--next-ai-draw-io/badge.svg)](/listings/dayuanjiang--next-ai-draw-io)

HTML

<a href="/listings/dayuanjiang--next-ai-draw-io"><img src="/api/listings/dayuanjiang--next-ai-draw-io/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Try it Online

No installation needed! Try the app directly on our demo site:

> **Bring Your Own API Key**: You can use your own API key to bypass usage limits on the demo site. Click the Settings icon in the chat panel to configure your provider and API key. Your key is stored locally in your browser and is never stored on the server.

Desktop Application

Download the native desktop app for your platform from the [Releases page](https://github.com/DayuanJiang/next-ai-draw-io/releases):

Supported platforms: Windows, macOS, Linux.

Run with Docker

[Go to Docker Guide](./docs/en/docker.md)

Installation

1. Clone the repository:

git clone https://github.com/DayuanJiang/next-ai-draw-io
cd next-ai-draw-io
npm install
cp env.example .env.local

See the [Provider Configuration Guide](./docs/en/ai-providers.md) for detailed setup instructions for each provider.

2. Run the development server:

npm run dev

3. Open [http://localhost:6002](http://localhost:6002) in your browser to see the application.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 191 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # Next AI Draw.io
  3. **Draw and edit draw.io diagrams by chatting with an AI.**
  4. English | [中文](./docs/cn/README_CN.md) | [日本語](./docs/ja/README_JA.md)
  5. [![TrendShift](https://trendshift.io/api/badge/repositories/15449)](https://next-ai-drawio.jiang.jp/)
  6. [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
  7. [![Sponsor](https://img.shields.io/badge/Sponsor-❤-ea4aaa)](https://github.com/sponsors/DayuanJiang)
  8. [**Live Demo**](https://next-ai-drawio.jiang.jp/) · [**Docs**](https://next-ai-drawio.jiang.jp/en/docs) · [**Gallery**](https://next-ai-drawio.jiang.jp/en/gallery) · [**Desktop App**](https://github.com/DayuanJiang/next-ai-draw-io/releases) · [**MCP Server**](https://next-ai-drawio.jiang.jp/en/mcp)
  9. </div>
  10. https://github.com/user-attachments/assets/66b9f12f-219f-4d62-acc0-0725e6850eec
  11. Describe a diagram in a sentence and the AI draws it on a real draw.io canvas. Edit it by hand like any draw.io file, or select a few shapes and tell the AI what to change. Every AI change is a version you can compare, restore or undo, and the result exports as `.drawio`, `.png` or `.svg`.
  12. Available as a web app, a desktop app for Windows, macOS and Linux, and an MCP server for AI agents such as Claude Code, Cursor and VS Code.
  13. ## Highlights
  14. **Draw**
  15. - Architecture diagrams, flowcharts, sequence diagrams and more from one sentence, with built-in AWS, Azure, GCP and Kubernetes icon libraries
  16. - Connectors can carry a flowing animation
  17. - Upload a screenshot or a sketch and the AI redraws it; upload PDF, Markdown, code and other text files and get a diagram of their content
  18. **Edit**
  19. - Edit by chat: changes stream onto the canvas and the shapes the AI just changed are highlighted
  20. - Ask about a selection: select shapes on the canvas and the AI changes only those
  21. - Versions and undo: every AI change is a version card with a thumbnail; compare it with the canvas, restore it or undo it, and Ctrl+Z on the canvas also takes back an AI change in one step
  22. - It is a normal draw.io diagram: double-click to rename, drag, restyle, use several pages, and export as `.drawio`, `.png`, `.svg` or `.drawio.svg` at any time
  23. **Use**
  24. - 25 model providers, including an OpenAI-compatible preset for any other URL; enter your own API key in the browser and it stays on your machine
  25. - Models that reason show their thinking
  26. - Dark mode; the interface is available in English, Simplified Chinese, Traditional Chinese and Japanese
  27. ## Examples
  28. <div align="center">
  29. <table width="100%">
  30. <tr>
  31. <td width="50%" valign="top">
  32. <strong>Highly available web app on AWS</strong><br />
  33. <p><strong>Prompt:</strong> Draw an AWS architecture for a highly available web app across two Availability Zones with AWS icons: Route 53, CloudFront with AWS WAF, an Application Load Balancer, ECS Fargate services in private subnets, Aurora PostgreSQL with a writer and a reader, ElastiCache for Redis, S3 for static assets, NAT gateways, and CloudWatch for monitoring.</p>
  34. <p><strong>Model:</strong> Claude Opus 5.5, in Claude Code with the MCP server</p>
  35. <img src="./public/gallery/aws-ha.svg" alt="Highly available web app on AWS" width="400" />
  36. </td>
  37. <td width="50%" valign="top">
  38. <strong>Kubernetes deployment for a web shop</strong><br />
  39. <p><strong>Prompt:</strong> Draw a Kubernetes deployment for a web shop: an ingress, web and API deployments with their services and pods, a Redis StatefulSet with a persistent volume, a ConfigMap, a Secret, and an autoscaler on the API.</p>
  40. <p><strong>Model:</strong> Claude Opus 5.5, in Claude Code with the MCP server</p>
  41. <img src="./public/gallery/kubernetes.svg" alt="Kubernetes deployment for a web shop" width="400" />
  42. </td>
  43. </tr>
  44. <tr>
  45. <td width="50%" valign="top">
  46. <strong>ER diagram of an online shop</strong><br />
  47. <p><strong>Prompt:</strong> Draw an ER diagram for an online shop: customers, addresses, orders, order items, products, categories and payments, with primary and foreign keys and the cardinality of each relationship.</p>
  48. <p><strong>Model:</strong> Claude Opus 5.5, in Claude Code with the MCP server</p>
  49. <img src="./public/gallery/er-shop.svg" alt="ER diagram of an online shop" width="400" />
  50. </td>
  51. <td width="50%" valign="top">
  52. <strong>BPMN expense claim process</strong><br />
  53. <p><strong>Prompt:</strong> Draw a BPMN process for an expense claim: an employee submits it, the manager approves or rejects it, finance checks the receipts and pays, and the claim goes back to the employee when receipts are missing.</p>
  54. <p><strong>Model:</strong> Claude Opus 5.5, in Claude Code with the MCP server</p>
  55. <img src="./public/gallery/bpmn-expense.svg" alt="BPMN expense claim process" width="400" />
  56. </td>
  57. </tr>
  58. <tr>
  59. <td width="50%" valign="top">
  60. <strong>Transformer architecture with animated connectors</strong><br />
  61. <p><strong>Prompt:</strong> Give me an animated connector diagram of transformer's architecture.</p>
  62. <p><strong>Model:</strong> Claude Opus 5.5, in Claude Code with the MCP server</p>
  63. <img src="./public/gallery/transformer.svg" alt="Transformer architecture with animated connectors" width="400" />
  64. </td>
  65. <td width="50%" valign="top">
  66. <strong>Customer journey map of a banking app</strong><br />
  67. <p><strong>Prompt:</strong> Draw a customer journey map for a mobile banking app across five stages (discover, sign up, first payment, everyday use, get help), with the customer's actions, touchpoints, feelings and pain points in each stage, and an opportunity for each pain point.</p>
  68. <p><strong>Model:</strong> Claude Opus 5.5, in Claude Code with the MCP server</p>
  69. <img src="./public/gallery/journey-map.svg" alt="Customer journey map of a banking app" width="400" />
  70. </td>
  71. </tr>
  72. </table>
  73. </div>
  74. More examples, each with its prompt and model, are in the **[gallery](https://next-ai-drawio.jiang.jp/en/gallery)**.
  75. ## Use it
  76. ### Online demo
  77. Open [next-ai-drawio.jiang.jp](https://next-ai-drawio.jiang.jp/), nothing to install. The demo has a usage limit; click the settings icon in the chat panel and enter your own provider and API key to lift it. The key stays in your browser and is never sent to the server for storage.
  78. ### Desktop app
  79. Download the Windows, macOS or Linux installer from the [Releases page](https://github.com/DayuanJiang/next-ai-draw-io/releases).
  80. ### In your AI agent (MCP)
  81. https://github.com/user-attachments/assets/6f53a67b-ab21-4113-9fee-7fb32f9de678
  82. Through MCP (Model Context Protocol, the protocol AI agents use to call outside tools), Claude Desktop, Cursor, VS Code and others can draw draw.io diagrams directly. Add this to your client's MCP configuration:
  83. ```json
  84. {
  85. "mcpServers": {
  86. "drawio": {
  87. "command": "npx",
  88. "args": ["@next-ai-drawio/mcp-server@latest"]
  89. }
  90. }
  91. }
  92. ```
  93. In VS Code or Cursor, one click adds it: [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square)](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522drawio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540next-ai-drawio%252Fmcp-server%2540latest%2522%255D%257D) [![Add to Cursor](https://img.shields.io/badge/Cursor-Add_Server-000000?style=flat-square)](https://cursor.com/en/install-mcp?name=drawio&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAbmV4dC1haS1kcmF3aW8vbWNwLXNlcnZlckBsYXRlc3QiXX0%3D)
  94. For Claude Code, one command does it (`--scope user` makes it available in every project):
  95. ```bash
  96. claude mcp add --scope user drawio -- npx @next-ai-drawio/mcp-server@latest
  97. ```
  98. It is also a plugin in the Claude Code community marketplace (Claude Code 2.1.275 or later):
  99. ```text
  100. /plugin install next-ai-drawio --marketplace anthropics/claude-plugins-community
  101. ```
  102. Then ask the AI for "a flowchart of user authentication with login, MFA and session management" and the diagram appears in your browser as it is drawn. The MCP server has most of the web app's drawing features:
  103. - The same drawing rules, icon libraries (AWS, Azure, GCP, Kubernetes and more) and canvas as the web app: the AI's changes are outlined, one Ctrl+Z takes them back, and the AI reads the shapes you select
  104. - A screenshot tool, so the AI looks at the rendered diagram and fixes it
  105. - Version history, several pages, export as `.drawio`, `.png`, `.svg` or `.drawio.svg`, and auto-save to `~/.next-ai-drawio/`; the draw.io editor ships inside the package, so the preview works offline
  106. The [MCP server page](https://next-ai-drawio.jiang.jp/en/mcp) has the setup for Codex, VS Code, Cursor and other clients, every tool, and how it compares with other draw.io MCP servers.
  107. ### Compared with draw.io's built-in AI
  108. draw.io has its own Generate tool (Arrange > Insert > Generate). It runs inside draw.io on a free hosted model or your own API key, and it can change a diagram, page or selection that you attach to its chat. Next AI Draw.io sends the current canvas, including your hand edits, with every message, turns every AI change into a version you can compare or restore, and works with 25 providers, including local models through Ollama, on the demo site, in the desktop app or on your own server.
  109. ## Self-host
  110. ### Run locally
  111. ```bash
  112. git clone https://github.com/DayuanJiang/next-ai-draw-io
  113. cd next-ai-draw-io
  114. npm install
  115. cp env.example .env.local # add your provider and API key, see "Models and providers" below
  116. npm run dev
  117. ```
  118. Open [http://localhost:6002](http://localhost:6002).
  119. ### One-click deploy
  120. | Platform | How |
  121. | --- | --- |
  122. | Tencent EdgeOne Pages | [![Deploy to EdgeOne Pages](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2FDayuanJiang%2Fnext-ai-draw-io) Deploying there also gives you a [daily free quota for DeepSeek models](https://pages.edgeone.ai/document/edge-ai) |
  123. | Vercel | [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FDayuanJiang%2Fnext-ai-draw-io) Set the same environment variables in the Vercel dashboard as in your `.env.local` |
  124. | Cloudflare Workers | [Cloudflare deploy guide](./docs/en/cloudflare-deploy.md) |
  125. | Docker | [Docker guide](./docs/en/docker.md) |
  126. | Offline or intranet | [Offline deployment](./docs/en/offline-deployment.md) |
  127. ### Models and providers
  128. 25 providers are supported: AWS Bedrock (default), OpenAI, Anthropic, Google AI, Google Vertex AI, Azure OpenAI, Ollama, OpenRouter, AIHubMix, DeepSeek, SiliconFlow, SGLang, Vercel AI Gateway, Tencent EdgeOne, ByteDance Doubao, ModelScope, Zhipu GLM, Qwen, Qiniu, Kimi, MiniMax, Novita, Xiaomi MiMo, Atlas Cloud, and an OpenAI-compatible preset for any other URL (vLLM, LM Studio, a gateway). The environment variables and notes for each are in the [provider configuration guide](./docs/en/ai-providers.md).
  129. **Which model**: the task is to produce long text in a strict format (draw.io XML), so pick a capable model; small models tend to produce broken diagrams.
  130. **Several models and the admin panel**: list several model IDs in `AI_MODEL` separated by commas, or configure models from several providers with the `AI_MODELS_CONFIG` environment variable or an `ai-models.json` file, and every user can use them without a key of their own. Set `ADMIN_PASSWORD` and open `/admin` to manage models, access codes, feature switches, observability and quotas from a web page; see the [admin panel guide](./docs/en/admin-panel.md).
  131. ## Support
  132. - Questions and ideas: open a [GitHub issue](https://github.com/DayuanJiang/next-ai-draw-io/issues) or email me[at]jiang.jp
  133. - Common problems: [FAQ](./docs/en/FAQ.md)
  134. - If the project is useful to you, consider [sponsoring](https://github.com/sponsors/DayuanJiang) to help keep the demo site running
  135. <div align="center">
  136. [![Star History Chart](https://api.star-history.com/svg?repos=DayuanJiang/next-ai-draw-io&type=date&legend=top-left)](https://www.star-history.com/#DayuanJiang/next-ai-draw-io&type=date&legend=top-left)
  137. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.