Diagrams.so
Diagrams.so

Documentation

Everything you need to get started with Diagrams.so and make the most of every feature.

Getting Started

Create your first diagram in under 60 seconds.

  1. 1Visit diagrams.so/create
  2. 2Sign in with Google, Microsoft, or GitHub
  3. 3Type a natural language description of your architecture
  4. 4Click Generate and download your .drawio file

Writing Great Prompts

Tips for getting better diagram output from the AI.

  1. 1Be specific about cloud providers (AWS, Azure, GCP)
  2. 2Name your services and components explicitly
  3. 3Describe data flow direction between components
  4. 4Mention security boundaries and networking (VPC, subnets)

Export Options

Download your diagrams in multiple formats.

  1. 1.drawio XML (opens in Draw.io desktop, web, Confluence, VS Code)
  2. 2PNG image (for presentations and documentation)
  3. 3PDF (for print and formal submissions)
  4. 4SVG (Pro and Power plans, for scalable web embedding)

Import Existing Diagrams

Bring your existing .drawio files into Diagrams.so.

  1. 1Click Import in your workspace
  2. 2Select one or more .drawio files from your computer
  3. 3Your diagrams appear in your workspace with full version history
  4. 4Use AI to update imported diagrams with natural language edits

Architecture Warnings

How automated validation helps you catch mistakes.

  1. 1Warnings appear automatically after generation
  2. 2Common checks: single-AZ, public exposure, missing security groups
  3. 3Click any warning to see a recommended fix
  4. 4Warnings are non-blocking — you decide what to address

BYO API Key

Use your own OpenAI or Anthropic API key for unlimited generation.

  1. 1Go to Settings and add your API key
  2. 2Generation no longer consumes plan credits
  3. 3Your key is encrypted and never logged
  4. 4Available on Pro and Power plans