Learn
Diagram guides
In-depth guides on creating architecture, database, and process diagrams - with free AI generators to put the guides into practice.
How to Create an AWS Architecture Diagram
An AWS architecture diagram documents how your cloud infrastructure fits together — which services you use, how they connect, and where data flows. Whether you're presenting to stakeholders, onboarding a new engineer, or reviewing a system for security, a clear AWS diagram saves hours of verbal explanation.
Read guide →
How to Make a Flowchart: Complete Guide
A flowchart is a visual representation of a process, decision tree, or algorithm using standardized shapes and arrows. Flowcharts are the universal language of process documentation — used in software engineering, operations, compliance, and business analysis to make complex processes immediately understandable.
Read guide →
Mermaid vs PlantUML: Which Diagram-as-Code Tool Is Right for You?
Mermaid and PlantUML are the two dominant diagram-as-code tools. Both let you write text and get a rendered diagram — no drag-and-drop required. The choice between them comes down to where your diagrams live, what types you need, and how much syntax complexity you're willing to accept.
Read guide →
System Design Diagrams: What to Draw and How
System design diagrams bridge the gap between an idea and a working system. They help engineers think through scalability, failure modes, and data flows before writing a line of code — and give new team members a map of a system that might have taken years to build.
Read guide →
Entity Relationship Diagram (ERD) Guide: Design Better Databases
An Entity Relationship Diagram (ERD) maps the structure of a database — the tables, their columns, and the relationships between them. A well-designed ERD is the foundation of a maintainable database: it surfaces many design mistakes (missing foreign keys, many-to-many relationships that need junction tables) before you write any SQL.
Read guide →
Kubernetes Architecture Diagram: What to Draw and Why
A Kubernetes architecture diagram documents the structure of a cluster — its nodes, namespaces, workloads, networking, and storage. For a cluster running in production, this diagram is essential for incident response, capacity planning, and onboarding engineers who haven't touched Kubernetes before.
Read guide →
How to Create an Azure Architecture Diagram
Azure architecture diagrams are essential for visualizing cloud solutions on Microsoft Azure. They help teams understand how App Services, SQL Databases, and Virtual Networks interact, ensuring security compliance and operational clarity.
Read guide →
Generate AWS Architecture Diagrams from Terraform or CloudFormation
Your Terraform state already knows exactly what your architecture looks like. Every load balancer, ECS service, security group, and RDS instance is declared in code, versioned, and reviewed — yet the architecture diagram in your wiki is six months stale. This guide covers three ways to close that gap: reading the templates yourself, running dedicated diagram tools like InfraMap and cfn-diagram, and using an AI generator that turns a plain-English resource description into an editable draw.io diagram. It ends with a worked example that converts an ALB + ECS + RDS Terraform snippet into a diagram you can actually maintain.
Read guide →
Convert an Image or Screenshot to an Editable Flowchart with AI
Every engineering org has diagrams trapped in pixels: whiteboard photos from a design review, screenshots pasted into Confluence, a PDF export of a Visio file whose source disappeared years ago. AI vision models can now read those images and reconstruct them as editable vector flowcharts — real nodes and connected arrows, not traced outlines. This guide covers how image-to-flowchart conversion actually works, what converts cleanly versus what needs manual fixes, and why the output format matters more than the conversion itself.
Read guide →
AWS Load Balancer Architecture Diagrams: ALB vs NLB Examples
Every non-trivial AWS architecture diagram has a load balancer somewhere in it, and it is usually the box that reviewers argue about: is it an ALB or an NLB, does it span the right Availability Zones, where are the target groups, and why is CloudFront pointing straight at EC2? This guide walks through four reference load balancing architectures — ALB to ECS/EC2 across multiple AZs, NLB for TCP and gRPC traffic, ALB with Lambda targets, and CloudFront in front of an ALB — plus the decision rules for choosing between ALB, NLB, and Gateway Load Balancer. For each pattern you get concrete drawing guidance (AZ boundaries, target groups, health checks) and a plain-English prompt you can use to generate the diagram automatically.
Read guide →
Microservices on AWS: Architecture Diagram Examples
A microservices diagram fails for the opposite reason most diagrams fail: not too little information, but too much. Ten services, each with a database, a queue, and three synchronous dependencies, drawn on one canvas, produces the spaghetti diagram everyone has seen in a design review and nobody could read. This guide covers how to structure AWS microservices diagrams so they stay legible — what belongs at the system level versus the service level, how to draw API Gateway plus ECS or EKS request paths, how to use an event bus as a visual spine instead of a web of arrows, and a worked five-service e-commerce example you can adapt.
Read guide →
AWS VPC Diagrams: Public and Private Subnet Patterns
Every AWS architecture review starts with the same drawing: a VPC box, two or three availability zones, public subnets on top, private subnets below. The layout is so standardized that deviating from it makes reviewers suspicious, yet most VPC diagrams still omit the details that matter — route tables, CIDR labels, and the exact placement of NAT gateways. This guide covers the canonical VPC diagram, the four patterns you will draw most often (3-tier, peering, Transit Gateway hub-spoke, and hybrid), and the conventions that make a network diagram actually reviewable instead of decorative.
Read guide →
RACI Charts: How to Make One (Template and Examples)
A RACI chart (also called a RACI matrix or responsibility assignment matrix) is a grid that maps every task in a project to exactly one of four involvement levels per role: Responsible, Accountable, Consulted, or Informed. Engineering teams reach for one when a release slips and nobody can say who owned the staging deploy, or when three people all think they approve the code freeze. This guide covers the four letters, the rules that keep the matrix honest, a complete software release example with 6 roles and 8 tasks, the failure modes that turn RACI into meeting bloat, and how to generate one from a plain-English description of your team.
Read guide →
SWOT Analysis Diagrams: Template and Examples
A SWOT diagram is a 2x2 matrix that sorts everything you know about a product, team, or company into four quadrants: Strengths, Weaknesses, Opportunities, and Threats. The format is fifty years old and most versions of it are useless, because people fill the grid with platitudes like "strong team" and "growing market." This guide covers the matrix structure, how to write entries that are specific enough to act on, a worked example for a SaaS startup, and the TOWS extension that converts the analysis into an actual plan.
Read guide →
Text to Diagram: Every Way to Turn Words into Visuals
There are exactly three ways to turn text into a diagram: write it in a diagram-as-code language like Mermaid or Graphviz, describe it in plain English to an AI generator, or combine both. Each approach makes a different tradeoff between speed, precision, and long-term maintainability. This guide walks through all three using the same example diagram, so you can see exactly what each workflow costs and what it buys you.
Read guide →
Generate an ER Diagram from SQL Schema with AI
Your database schema already contains everything an entity-relationship diagram needs: tables are entities, columns are attributes, and foreign keys are relationships. The only missing step is translation — turning a wall of CREATE TABLE statements into a picture someone can read in ten seconds. This guide covers exactly how that translation works: how cardinality is expressed in crow's foot notation, how foreign key constraints become relationship lines, why junction tables deserve special handling, and how AI tools now do the whole conversion from pasted SQL. We will walk through a complete five-table blog schema and compare the AI approach against MySQL Workbench and pgAdmin reverse-engineering.
Read guide →
Draw.io + AI: The Complete Guide
Draw.io (now diagrams.net) is the default diagramming tool for a huge share of engineering teams: it is free, runs offline, stores files as plain XML in Git, and embeds in Confluence, VS Code, and Google Drive. What it does not have is any built-in AI. If you want to describe an architecture in plain English and get an editable diagram back, you need to bolt AI onto draw.io yourself. This guide covers every practical way to do that, why the naive ChatGPT-paste approach breaks, and the generate-import-refine workflow that actually holds up for real AWS, Kubernetes, and system design diagrams.
Read guide →
UML Diagrams: All 14 Types Explained (with Examples)
UML 2.5 defines exactly 14 diagram types, split into 7 structural diagrams that show what a system is made of and 7 behavioral diagrams that show how it acts at runtime. In practice, most engineering teams lean on just four of them: class, sequence, activity, and state machine. This guide walks through all 14 with the notation you actually need, explains why the other ten are rare outside of specific niches, and shows when UML earns its keep in 2026 versus when a whiteboard box-and-arrow sketch is the smarter call.
Read guide →
Network Diagrams: How to Draw One (Symbols and Examples)
A network diagram is a map of how devices, subnets, and services connect — and it is usually the first thing anyone asks for during an outage, an audit, or a cloud migration. A good one answers questions in seconds: what sits behind the firewall, which VLAN a printer lives on, which subnet a database occupies. This guide covers the standard symbols, the common topology patterns, the layered layout convention professionals use, and two worked examples you can copy: an office LAN and an AWS VPC.
Read guide →
Data Flow Diagrams (DFD): Levels, Symbols and Examples
A data flow diagram (DFD) answers one question a flowchart never can: where does the data actually go? Instead of modeling steps and decisions, a DFD traces data from its sources, through the processes that transform it, into the stores where it rests. This guide covers the four DFD symbols in both major notations, the level hierarchy from context diagram down to Level 2, the balancing rule that keeps decomposition honest, and why compliance teams now ask engineers for DFDs during GDPR and SOC 2 audits — all illustrated with one worked order-processing example.
Read guide →
Sequence Diagrams: How to Read and Create Them
A sequence diagram shows how the components of a system talk to each other over time — which service calls which, in what order, and what happens when something fails. It is the single most useful diagram type for API design, auth flows, and debugging distributed systems, yet most engineers only half-remember the notation from a UML course years ago. This guide covers the notation that actually matters, walks through two real worked examples — the OAuth2 authorization code flow and a cached REST API read path — and compares the fastest ways to create one: Mermaid syntax versus AI generation.
Read guide →
Draw.io Download: Desktop, Web, and VS Code (2026)
Searching for a draw.io download usually means one of three things: you want the desktop app for offline work, the VS Code extension so diagrams live next to your code, or you just want to confirm the whole thing is actually free. The short answers: the desktop app ships from GitHub releases for macOS, Windows, and Linux; the VS Code extension is hediet.vscode-drawio; and yes, the editor is free under the Apache 2.0 license. This guide covers every way to run draw.io in 2026 and which one fits your workflow.
Read guide →
Workflow Diagrams: Symbols, Types and Examples
A workflow diagram maps who does what, in what order, and what happens when a step fails. Engineers reach for one when a process spans multiple people or systems: a deploy pipeline, an on-call escalation, a hiring loop. This guide covers the symbols that matter, when to use a workflow chart versus a flowchart or BPMN, swimlanes for role handoffs, three worked examples you can copy, the two mistakes that make most workflow diagrams useless, and how to generate one from a plain-English description.
Read guide →
Skip the blank canvas
Describe any diagram in plain English. AIDrawIO generates draw.io-compatible XML in seconds.