Blog
Architecture insights, cloud design patterns, and tutorials from the Diagrams.so team.
The Complete Guide to AI-Generated Architecture Diagrams
AI diagram generators don't read your mind. They parse structured prompts and map components to Draw.io XML with correct icons, connections, and layout. This guide shows you how to write prompts that produce diagrams worth putting in a design review.
How to Create AWS Architecture Diagrams: Best Practices for 2026
Most AWS diagrams fail design reviews because they skip VPC boundaries, ignore availability zones, or use generic icons that don't map to actual services. These best practices fix that with real prompts and specific examples.
How to Create Azure Architecture Diagrams with AI
Azure has over 600 services, and diagramming them correctly requires the right icon set, proper grouping by resource group and subscription, and consistent layout. This tutorial walks through real prompts for landing zones, AKS clusters, data platforms, and security architectures you can use in Diagrams.so today.
How to Document Cloud Infrastructure: Diagrams, ADRs, and Runbooks
Cloud architecture documentation fails when it's treated as a one-time deliverable instead of a living system. This guide covers the three pillars that actually work: generated architecture diagrams, lightweight ADRs, and operational runbooks tied together with cross-references.
Cloud Provider Icon Libraries: AWS, Azure, GCP, OCI Guide
Every cloud provider publishes an official icon set for architecture diagrams, but each one follows different naming conventions, color schemes, and file formats. This guide covers what each library includes, how they differ, and how Diagrams.so handles icon selection automatically across 30+ libraries.
Draw.io vs Lucidchart vs Miro: 2026 Comparison for Architects
Draw.io, Lucidchart, and Miro solve different problems despite appearing in the same "diagramming tools" category. This comparison breaks down pricing, file formats, cloud provider icons, and collaboration features so you can pick the right tool for your team.
How to Create GCP Architecture Diagrams with AI
Google Cloud uses a project-based resource hierarchy and a networking model that differs significantly from AWS and Azure. This tutorial covers how to diagram GCP architectures correctly with actual prompts for Shared VPC, GKE Autopilot, BigQuery data pipelines, and Cloud Run serverless patterns.
Kubernetes Diagrams: A Complete Visual Guide for DevOps Teams
Kubernetes clusters have enough moving parts that a text description doesn't cut it for onboarding, incident response, or capacity planning. This guide covers what to include in K8s diagrams, with real prompts that generate accurate cluster visualizations.
Multi-Cloud Architecture Diagrams: Complete Guide for 2026
Most organizations claiming multi-cloud are actually running separate workloads on separate clouds with no cross-cloud integration. This guide covers how to diagram the architectures that genuinely span multiple providers: cross-cloud networking, federated Kubernetes, identity integration, and data replication patterns.
How to Create Oracle Cloud (OCI) Architecture Diagrams
Oracle Cloud Infrastructure has a compartment-based resource hierarchy, a networking model built on VCNs and DRGs, and first-party .drawio support in its diagram toolkit. This tutorial covers how to produce accurate OCI architecture diagrams with specific prompts for compartment design, networking, Autonomous Database, and security architectures.