Skip to content

Latest commit

Β 

History

20 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Draw.io Architecture Libraries

Latest Release License: MIT Last Commit Issues Gallery

Reusable draw.io / diagrams.net libraries for creating clean, consistent, and professional architecture diagrams.

This repository provides curated symbol libraries for system design, cloud architecture, DevOps, and security diagrams, optimized for clarity, reuse, and documentation quality.

Search and filter every shape library in the browser β€” no need to open draw.io just to see what's included.


🎯 Purpose

Architectural diagrams often fail due to:

  • inconsistent symbols
  • visual clutter
  • lack of shared semantics

This project solves that by offering standardized, reusable libraries that help teams produce diagrams that are:

  • easier to read
  • easier to maintain
  • easier to review

πŸ“š Library Catalog

Browse and search every library interactively in the live gallery, or read the full descriptions here:

πŸ‘‰ CATALOG.md

Each library is independently usable and versioned.


πŸ“¦ Included Libraries

Library File Preview Notes
Build Pipeline Shapes libraries/Build_Pipeline_Shapes.xml Shapes allowing to build design diagrams for Build Pipelines.
Dataflowdiagram Limited Shapes libraries/DataFlowDiagram_Limited_Shapes.xml Custom Data-flow diagrams shapes.
Dataflowdiagram Shapes libraries/DataFlowDiagram_Shapes.xml Another variations of data-flow diagrams related shapes
Additional Or Support libraries/additional-or-support.xml Library contains generic additional shapes for design support.
Ai Machine Learning libraries/ai-machine-learning.xml Library contains AI machine learning shapes.
Any Others libraries/any-others.xml Uncategorised shapes.
Apache Software Foundation Logos libraries/apache-software-foundation-logos.xml Apache Software foundation shapes.
Apps And Logos libraries/apps-and-logos.xml Various apps and tools related logos.
Aws Services libraries/aws-services.xml Original pictogram icons for common AWS services, grouped and color-coded by category (compute, storage, database, networking, security, messaging, observability). Not AWS's trademarked icon artwork.
Aws Services (3D) libraries/aws-services-3d.xml Same 28 AWS service icons as aws-services.xml, rendered with a gradient fill, drop shadow, and glossy highlight for a raised, dimensional look.
Azure Additional Or Support libraries/azure-additional-or-support.xml Smaller (79-shape) supplementary Azure pack for adjacent concepts (automation, migration, containers, cloud adoption) not covered by Custom Azure.
Azure Services libraries/azure-services.xml Original pictogram icons for common Azure services, in the same visual system as aws-services.xml/gcp-services.xml for 3-cloud consistency. Not Microsoft's trademarked icon artwork.
Azure Services (3D) libraries/azure-services-3d.xml Same 28 Azure service icons as azure-services.xml, rendered with a gradient fill, drop shadow, and glossy highlight.
Buildings libraries/buildings.xml Library contains building related shapes.
C4 Model libraries/c4-model.xml Standard C4 notation shapes (Person, Software System, Container, Component, and boundaries), each in internal and external variants, for Context/Container/Component diagrams.
Chart Icons libraries/chart-icons.xml Different chart icons.
Custom Azure libraries/custom-azure.xml Large (174-shape) core Azure service icon pack β€” the main Azure library; see Azure Additional Or Support for supplementary shapes.
Kubernetes libraries/custom-kubernetes.xml Contains list of custom kubernetes icons.
Databases libraries/databases.xml List of various database tools.
Delivery Icons libraries/delivery-icons.xml Contains list of different delivery icons.
Developer Tools libraries/developer-tools.xml Contains list of developer tools.
Devices libraries/devices.xml Contains list of Devices.
Devops Observability libraries/devops-observability.xml Original pictogram icons for 28 cloud-native DevOps/observability tools (Docker, Kubernetes tooling, CI/CD, IaC, messaging, metrics/logs/traces, proxies, testing) not covered by Developer Tools or the HashiCorp library. Not the tools' trademarked logos.
Devops Observability (3D) libraries/devops-observability-3d.xml Same 28 tool icons as devops-observability.xml, rendered with a gradient fill, drop shadow, and glossy highlight.
Flat Color Icons libraries/flat-color-icons.xml Contains list of flat color icons.
Font Awesome libraries/font-awesome.xml Various Font Awesome icons.
Gcp Services libraries/gcp-services.xml Original pictogram icons for common Google Cloud services, grouped and color-coded by category (compute, storage, database, networking, security, messaging, observability). Not Google's trademarked icon artwork.
Gcp Services (3D) libraries/gcp-services-3d.xml Same 28 GCP service icons as gcp-services.xml, rendered with a gradient fill, drop shadow, and glossy highlight for a raised, dimensional look.
Hashicorp Draw Io libraries/hashicorp-draw-io.xml Contains different Hashicorp tool icons.
Integration Patterns libraries/integration-patterns.xml 12 abstract Enterprise Integration Pattern icons (Aggregator, Router, Splitter, etc.) β€” conceptual, tool-agnostic notation, not tied to any specific product.
Integration libraries/integration.xml Large (265-shape) icon pack for BizTalk Server and Azure integration tooling β€” adapters, protocols, Service Bus, Logic Apps, and related components. Product/tool-specific, unlike Integration Patterns.
Office365 libraries/office365.xml Contains list of Office365 related icons.
Osa Icons libraries/osa-icons.xml Contains various OSA icons.
Power Bi libraries/power-bi.xml Contains list of Power-BI icons.
Powerapps And Flows libraries/powerapps-and-flows.xml Contains list of Power-apps and flows relatd icons.
Users And Roles libraries/users-and-roles.xml Contains list of users and roles related icons for illustration purpose.

Libraries are intentionally minimal and semantic rather than exhaustive icon packs.


πŸš€ How to Use

Option 1: Load a single library

  1. Open draw.io / diagrams.net
  2. Go to File β†’ Open Library from β†’ Device
  3. Select the .xml library file
  4. Drag symbols into your diagram

Option 2: Use a release pack (recommended)

  1. Download a release ZIP from GitHub Releases
  2. Extract the libraries
  3. Import one or more .xml files into draw.io

πŸ§ͺ Examples

Ready-to-open sample diagrams built from these libraries live in examples/:

Example File
CI/CD Pipeline examples/ci-cd-pipeline.drawio
Integration Patterns examples/integration-patterns.drawio
Kubernetes Microservices examples/kubernetes-microservices.drawio
User Access Context examples/user-access-context.drawio
AWS Serverless Web Application examples/aws-serverless-web-app.drawio
Azure Three-Tier Web Application examples/azure-three-tier-web-app.drawio
GCP Microservices on GKE examples/gcp-microservices-gke.drawio
CI/CD GitOps Pipeline examples/devops-cicd-gitops-pipeline.drawio

Open any file directly in draw.io / diagrams.net (File β†’ Open) to see a complete diagram, not just individual shapes.

For a deeper walkthrough of the Data Flow Diagram libraries specifically, see docs/dfd_doc.md.


🧭 Design Principles

These libraries follow a few strict rules:

  • Architecture first β€” symbols represent concepts, not vendors
  • Consistent sizing β€” predictable alignment and spacing
  • Low visual noise β€” diagrams stay readable at scale
  • Print & dark-mode friendly
  • Tool-agnostic semantics (works beyond draw.io)

🧩 Typical Use Cases

  • System architecture diagrams
  • C4 (Context / Container / Component) diagrams
  • Cloud and infrastructure design reviews
  • DevOps and CI/CD flows
  • Technical documentation and RFCs
  • Architecture review boards (ARB) material

πŸ“¦ Releases & Versioning

This repository publishes versioned release packs.

Each release:

  • is tagged (e.g. v1.0.0)
  • includes a downloadable ZIP
  • contains stable library definitions

πŸ‘‰ See GitHub Releases for downloadable packs, and CHANGELOG.md for what changed in each one.


🀝 Contributing

Contributions are welcome β€” new libraries, refinements to existing symbols, visual consistency improvements, documentation and examples.

See CONTRIBUTING.md for guidelines on adding a new library, and the Code of Conduct for how we work together.


πŸ›£ Roadmap

  • Expand catalog previews
  • Add more C4-aligned symbols
  • Add example diagrams per library
  • Provide light/dark theme variants
  • Improve cross-library consistency

πŸ“„ License

MIT License β€” free to use, modify, and distribute.


πŸ“ˆ Star History

Star History Chart


⭐ Why This Repo Exists

Good diagrams are a force multiplier for engineering teams.

This repository exists to make clear architecture diagrams the default, not the exception.

About

Reusable draw.io libraries for clean, professional architecture diagrams.

Topics

Resources

Code of conduct

Contributing

Stars

23 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages