# blushft/go-diagrams

Create beautiful system diagrams with Go

Repository: https://github.com/blushft/go-diagrams
Canonical: https://ross.abutalabs.com/products/go-diagrams
Language: Go
License: MIT
License Family: permissive
Last push: 2025-03-22T20:11:19+00:00

## Health v2 (maintenance only)
Score: 38/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 12, release rhythm 35, longevity 100
- inputs: {"age_days": 2181, "days_push": 529, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5229, forks 234 (observed 2026-08-28T04:09:13.412359+00:00)

## What it is
A Go library for creating system and application architecture diagrams as code, ported from the Python 'diagrams' project. It generates Graphviz DOT files with cloud provider and generic node icons that can be rendered to images.

## Use cases
- generate architecture diagrams from Go code
- create cloud infrastructure diagrams as code
- document system architecture with graphviz
- draw AWS GCP Azure diagrams programmatically
- version-control architecture diagrams alongside code
- render network topology diagrams

## When to choose
- you want diagrams-as-code in a Go project
- you need reproducible, version-controlled architecture diagrams
- you want cloud provider icons for AWS, GCP, Azure, etc.
- you prefer writing Go over hand-drawing diagrams

## When to avoid
- you need interactive or live diagram editing
- you don't have Graphviz installed for rendering
- you need diagram formats other than Graphviz DOT output
- you want a drag-and-drop diagramming UI

## Facets
- artifact type: library
- maturity: active
- function: data-visualization, developer-tools
- domain: developer-tools, documentation, cloud-computing
- platform: go, cross-platform
- tags: diagrams, graphviz, architecture-diagrams, diagrams-as-code

## Member repositories
- blushft/go-diagrams (main) score 38

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:13.412359+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:59:39.865263+00:00, confidence not recorded.
  - readme: https://github.com/blushft/go-diagrams (fetched 2026-08-28T04:09:13.412359+00:00, sha d96d6f1ea905)
- Data as of 2026-08-30T08:39:29.467469+00:00.