Documentation

ArchitectureDiagram.ai generates professional architecture diagrams from plain English descriptions. No manual layout, no drag-and-drop - just describe your system and get a diagram back in seconds.

1. Create an account - sign up with email or Google at the sign-up page. You get 2 free credits to start.
2. Open the generator - after signing in, you'll land on the dashboard where you can start creating diagrams immediately.
3. Describe your system - type a natural language description of the architecture you want to visualize.
4. Generate - hit generate and your diagram will be created in seconds. Each generation costs 1 credit.
5. Edit your diagram - the AI produces an editable diagram in a split-pane workspace. Tweak components, labels, or connections directly, then regenerate the final image.

Every diagram starts as an editable Mermaid flowchart, which you can then render in four formats:

• Mermaid

  Diagram-as-code format. Renders clean flowcharts that embed natively in GitHub READMEs, Notion, and Markdown docs.

• draw.io

  Editable XML format you can open and modify in draw.io or diagrams.net for further customization.

• Excalidraw

  Hand-drawn sketch style. Great for informal diagrams, whiteboard sessions, and collaborative brainstorming.

• AI-generated images

  Polished, presentation-ready visuals generated by AI. Ideal for slide decks, design reviews, and documentation.

The quality of your diagram depends on how you describe your system. Here are some tips:

• Be specific about components

  Instead of "a backend service", say "a Node.js API server running on AWS ECS". The more detail you provide, the more accurate the diagram.

• Describe the data flow

  Mention how components communicate - "the frontend calls the API gateway via REST, which forwards requests to the user service through gRPC".

• Include infrastructure details

  Mention databases, caches, queues, load balancers, and cloud services. For example: "PostgreSQL for persistence, Redis for caching, and SQS for async job processing".

After generating a diagram, you don't have to start over if something isn't quite right. On Hacker plans and above, chat-based editing lets you refine your diagram through follow-up messages.

How it works: once a diagram is generated, a chat panel opens alongside it. Type follow-up instructions to modify the diagram, and it will update in real time. Your full chat history is preserved, so the AI understands the context of all previous changes.

• Add components

  "Add a CDN in front of the load balancer" or "Include a monitoring service that watches all API endpoints".

• Remove or replace components

  "Replace PostgreSQL with DynamoDB" or "Remove the message queue from the diagram".

• Change layout or style

  "Make the diagram flow left to right instead of top to bottom" or "Group the database services together".

• Add detail

  "Label the connection between the API and database as 'SQL queries over port 5432'" or "Add a note explaining the retry logic".

On any plan, you can also edit the Mermaid code directly in the split-pane workspace and regenerate the image from your changes.

Available on Hacker plans and above, Expert Chat is an AI-powered architectural advisor that reviews your diagrams and provides feedback like a senior architect would.

• Architectural review

  Attach a diagram and get feedback on security boundaries, monitoring gaps, single points of failure, and other high-severity issues.

• Design guidance

  Ask questions about your architecture and get suggestions grounded in your actual design, not generic advice.

• Persistent conversations

  Expert Chat conversations are saved and resumable, so you can continue a review session across multiple visits.

Share your diagrams with anyone via public read-only links. Each shared diagram includes:

• Public link - a shareable URL with social preview cards for Slack, Twitter, and LinkedIn
• Embed code - an iframe snippet for embedding in Notion, Confluence, GitHub READMEs, or any web page
• Share controls - toggle prompt visibility, enable or disable downloads, and revoke access at any time
• View tracking - see how many times your shared diagram has been viewed

Download your diagrams or copy them to your clipboard:

• PNG - high-resolution image for presentations and documentation
• Clipboard - copy and paste directly into Google Docs, Slides, or any other app
• Mermaid code - the raw Mermaid markup for embedding in Markdown docs or version control
• draw.io XML - editable format for draw.io / diagrams.net

Free plans include watermarked exports. Builder plans and above remove watermarks. Designer and Pro plans unlock higher resolution exports.

Beyond architecture diagrams, you can generate images from text prompts or transform existing images. Upload an image via drag-and-drop or paste, choose an aspect ratio, and let the AI generate a new visual.

Supports HEIC/HEIF auto-conversion, multiple aspect ratios, and both text-to-image and image-to-image workflows.

Each diagram generation costs 1 credit. Credits reset monthly. Features are cumulative - each tier includes everything in the tier below it.

• Free - $0/month

  2 credits per month. All output formats. Watermarked exports. Public sharing and embedding.

• Builder - $4.99/month

  10 credits per month. No watermarks. Standard generation speed. Community support.

• Hacker - $7.99/month

  20 credits per month. Priority generation queue. Chat-based diagram editing. Expert Chat (AI architectural advisor).

• Designer - $14.99/month

  40 credits per month. Higher resolution exports. Version history for diagrams.

• Pro - $19.99/month

  50 credits per month. Max resolution exports. Early access to new features.

• Enterprise - $49.99/month

  Unlimited credits. API access. Custom branding. Dedicated account support.

All paid plans are available with annual billing at a 17% discount. See the pricing page for full details.

If you have questions or run into issues, reach out on LinkedIn or visit the support page.