This command line interface (CLI) tool enables drawing infrastructure diagrams for Amazon Web Services through YAML code. It facilitates diagram-as-code without relying on image libraries.

The CLI tool promotes code reuse, testing, integration, and automating the diagramming process. It allows managing diagrams with Git by writing human-readable YAML.

Example templates are here. Check out the Introduction Guide as well for additional information.

• Compliant with AWS architecture guidelines
  Easily generate diagrams that follow AWS diagram guidelines.
• Flexible
  Automatically adjust the position and size of groups.
• Lightweight & CI/CD-friendly
  Start quickly on a container; no dependency on headless browser or GUI.
• Integrate with your Infrastructure as Code
  Generate diagrams to align with your IaC code without managing diagrams manually.
• As a drawing library
  Use as Golang Library and integrate with other IaC tools, AI, or drawing GUI tools.
• Extensible
  Add definition files to create non-AWS diagrams as well.

$ go install github.com/awslabs/diagram-as-code/cmd/awsdac@latest

$ brew install awsdac

Usage:
  awsdac <input filename> [flags]

Flags:
  -c, --cfn-template               [beta] Create diagram from CloudFormation template
  -d, --dac-file                   [beta] Generate YAML file in dac (diagram-as-code) format from CloudFormation template
  -h, --help                       help for awsdac
  -o, --output string              Output file name (default "output.png")
      --override-def-file string   For testing purpose, override DefinitionFiles to another url/local file
  -t, --template                   Processes the input file as a template according to text/template.
  -v, --verbose                    Enable verbose logging
      --version                    version for awsdac

$ awsdac examples/alb-ec2.yaml

$ awsdac privatelink.yaml -o custom-output.png

• Introduction Guide - Quick start (10 minutes) and core concepts
• Troubleshooting - Common issues and solutions

• Resource Types - Available AWS resources and diagram elements
• Links - Connecting resources with arrows and lines

• MCP Server - AI assistant integration
• CloudFormation Conversion [Beta] - Convert CloudFormation templates to diagrams

• Templates - Using Go templates for dynamic diagrams
• UnorderedChildren - Automatic child reordering for optimal layouts
• Auto-positioning - Smart link positioning
• Link Grouping Offset - Prevent link overlap
• BorderChildren - Place resources on borders

• Best Practices - Design patterns and diagram standards

• Documentation Guidelines - How to contribute to documentation

For contributing guidelines, please see CONTRIBUTING.md.

• cmd/ - CLI tools (awsdac, awsdac-mcp-server)
• internal/ - Core implementation
  • cache/ - Caching logic
  • ctl/ - Core control logic
  • definition/ - Definition file handling
  • font/ - Font management
  • types/ - Core types and structures
  • vector/ - Vector operations
• test/ - Integration tests
• tools/ - Development tools
• examples/ - Example YAML files
• doc/ - Documentation

See CONTRIBUTING for more information.

This project is licensed under the Apache-2.0 License.