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, then download a PNG or SVG (or the .drawio file on the paid plan)

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. 3SVG (for scalable web embedding; free-plan exports carry a small mark)

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