Architecture Diagramming Tools, and the AI Gap
Turning Words Into Architecture — Where’s the AI Tool for That?
Creating effective diagrams to communicate software architecture clearly is challenging. Over the years, I've encountered numerous tools that attempt to simplify this process. Still searching for an AI-powered tool that converts prompts directly into architecture diagrams, without a luck. If you're actively using one, please let me know!
Below is a curated list of architecture diagramming resources categorized to help you find the right one for your needs.
🏗️ Architecture Diagramming Tools
Tools purpose-built for modeling software and systems architecture. These typically support formal abstractions like C4, UML, or cloud components, and help communicate design clearly across teams.
https://excalidraw.com – Virtual whiteboard with hand-drawn-style diagrams for collaborative sketches. ✏️🎨 (This is my favourite right now!)
https://lucidchart.com Real-time collaboration, extensive templates. 👍 (Used it in the past a lot!)
https://www.omnigroup.com/omnigraffle – macOS/iOS app for precise technical diagrams. 🍎💻 (Best Mac app)
http://drawio.com – Open-source, extensive shape libraries, offline support. (Also known as http://diagrams.net and https://draw.io/)
https://plantuml.com – Text-based UML diagrams, ideal for version control.
https://structurizr.com – C4 model diagrams generated from code/DSL.
https://c4model.com – Specification for structured software architecture visualization.
https://likec4.dev – DSL for Kotlin users working with C4 diagrams.
https://ilograph.com – Narrative-style diagrams showing complex interactions.
https://icepanel.io – Collaborative C4 model diagrams, versioning. 🌟 (Heard good things about)
https://d2lang.com – Modern, clean diagram-as-code language.
https://miro.com – Collaborative cloud-based whiteboard with various templates.
https://tldraw.dev – Minimalist, open-source collaborative diagramming tool. 👩💻 (Eng's favourite)
https://www.archimatetool.com – Open-source ArchiMate modeling tool.
https://www.eventcatalog.dev – Documenting and visualizing event-driven architectures.
https://todiagram.com – Visualize any JSON, YAML, XML or CSV into interactive diagrams, useful for documentation or data editing.
🧩 Diagrams as Code Tools
Text-based tools that turn code into diagrams—ideal for version control, automation, and keeping visuals in sync with infrastructure or architecture definitions.
https://eraser.io – Visual editing combined with diagram-as-code. (Looking to give it another try)
https://mermaid.js.org – Markdown-inspired syntax for various diagrams. (AI’s favourite tool 🤖)
https://diagrams.mingrammer.com – Python-based, supports multiple cloud providers.
https://github.com/pistazie/cdk-dia – Diagrams from AWS CDK metadata.
https://github.com/mhlabs/cfn-diagram – Visualize AWS CloudFormation/SAM templates.
https://github.com/cycloidio/inframap – Terraform state/HCL visualization.
https://grucloud.com – JavaScript IaC with built-in diagram generation.
https://github.com/awslabs/aws-icons-for-plantuml – AWS icons for PlantUML diagrams.
https://www.pluralith.com – Terraform plans visualized with architecture-aware rendering.
https://graphviz.org/ – Classic, flexible tool for generating diagrams from simple text-based descriptions (DOT language).
🎨 Visual Diagramming Tools
Flexible, general-purpose tools for sketching, whiteboarding, or creating illustrative diagrams. Great for early ideation, workshops, or communicating high-level concepts visually (AWS heavy).
https://lucidscale.com/product/aws – Cloud-native AWS architecture visualization.
https://creately.com – AWS templates, collaborative editing.
https://www.gliffy.com – Integrated with Atlassian Confluence.
https://cacoo.com/features – Real-time collaboration, AWS architecture import.
https://www.cloudcraft.co – 3D AWS architecture diagrams, real-time cloud sync.
https://docs.fugue.co/visualization.html – Cloud security visualization.
https://www.cloudockit.com – Automated documentation/diagrams for AWS, Azure, GCP.
https://app.cloudviz.io – Diagram generator for AWS with CloudFormation integration.
🤖 AI-Augmented Diagramming
A new wave of tools is emerging that generate diagrams directly from natural language prompts. While still early, the potential to go from idea to visual instantly is becoming real.
ChatGPT Canvas and Claude Artifacts can now generate and render Mermaid diagrams from prompts, which you can preview and render at https://mermaid.js.org
Google AI Studio (as of last week) supports canvas output as well—pushing this capability into the mainstream.
https://app.eraser.io/ is actively exploring prompt-based architecture sketching, though it’s still early stage.
https://excalidraw.com/ recently added text-to-diagram: it uses Mermaid as an intermediate step, so you'll get the best results by describing flows, diagrams, or workflows in your prompt.
We’re not far from generating complete system diagrams from a single prompt—and I can't wait.
📘 How to Communicate Clearly with Diagrams
No tool can replace clarity of thought. The best resource I've found on creating meaningful, effective diagrams is Communication Patterns by Jacqui Read. It's packed with practical guidance for turning complex ideas into visuals that make sense.
I shared my review here.
Thanks for reading Generative Programmer! 🙏 If you enjoyed this, support the newsletter by sharing it with friends via 🐦 Twitter, 💼 LinkedIn, 🦋 BlueSky, or ✉️ Email.
Have a great rest of the week!
I wrote an article on the use of plantuml for Aws and Kubernetes at https://open.substack.com/pub/cloudnativeengineer/p/enhancing-software-design-with-diagrams?utm_source=share&utm_medium=android&r=23gwx
Thanks ! a lot . A much needed article