terravision
Automatically generates professional cloud architecture diagrams from Terraform code for AWS, GCP, and Azure.
What is terravision?
TerraVision is an open-source tool that automatically generates professional cloud architecture diagrams from Terraform code. It parses Terraform configurations to create visual representations of AWS, Google Cloud, and Azure infrastructure, ensuring diagrams stay synchronized with the actual codebase. The tool solves the problem of outdated documentation by using infrastructure-as-code as the single source of truth.
Infrastructure engineers, DevOps teams, and solution architects who use Terraform to manage cloud resources and need to visualize, document, or audit their architectures.
Developers choose TerraVision because it automates diagram creation directly from Terraform, eliminating manual drawing and keeping documentation accurate. Its client-side operation ensures data privacy, while support for multiple cloud providers and CI/CD integration makes it versatile for professional workflows.
Overview
Terravision creates Professional Cloud Architecture Diagrams from your Terraform code automatically. Supports AWS, Google and Azure.
Use Cases
Best For
- Automatically generating architecture diagrams for Terraform-managed cloud infrastructure
- Keeping infrastructure documentation synchronized with code changes
- Preparing visual materials for security, governance, or team reviews
- Integrating diagram generation into CI/CD pipelines for automated documentation
- Creating editable diagrams for further customization in tools like draw.io
- Visualizing multi-cloud or hybrid cloud architectures from a single codebase
Not Ideal For
- Teams using infrastructure-as-code tools other than Terraform (e.g., Pulumi, AWS CloudFormation)
- Projects requiring real-time diagrams from live cloud environments without code changes
- Environments where Terraform cannot run plan commands due to security or policy restrictions
- Organizations heavily invested in cloud providers with limited support (e.g., Oracle Cloud, Alibaba Cloud)
Pros & Cons
Pros
Generates diagrams directly from Terraform code as the single source of truth, ensuring documentation is always up-to-date and eliminating manual drawing errors.
Runs entirely locally with no cloud credentials required, keeping sensitive infrastructure data private and secure, as emphasized in the README.
Integrates seamlessly with GitHub Actions, GitLab CI, and Jenkins, allowing automated diagram generation in pipelines with provided examples.
Exports to draw.io format for customization in popular diagram editors, and offers interactive HTML diagrams with clickable resources and search.
Cons
Requires installation of Python, Terraform, Graphviz, and Git, with complex configurations for draw.io export on macOS and Windows, as noted in the README.
Only offers 'Partial Support' for Google Cloud and Azure, limiting functionality for teams relying heavily on those providers compared to AWS.
Cannot visualize infrastructure from non-Terraform IaC tools or live environments, making it unsuitable for heterogeneous or legacy setups.
Frequently Asked Questions
Related Projects
terraformerCLI tool to generate terraform files from existing infrastructure (reverse Terraform). Infrastructure to Code
InfracostCloud cost intelligence for engineers, AI coding agents, and CI/CD 💰📉 Shift FinOps Left!
TerragruntTerragrunt is a flexible orchestration tool that allows Infrastructure as Code written in OpenTofu/Terraform to scale.
atlantisTerraform Pull Request Automation
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.