Bausteinsicht

Architecture-as-Code meets draw.io

Maintain your software architecture in a structured JSON model and visualize it in draw.io — with full bidirectional synchronization. No more outdated diagrams.

Get Started View on GitHub

What makes Bausteinsicht different?

🔄 Bidirectional Sync

Edit in draw.io or in the JSON model — changes sync both ways. No more "which diagram is the latest version?" questions. Your model stays in sync with your diagrams automatically.

🎨 draw.io as Frontend

No proprietary viewer needed. Use the tool everyone already knows. Full control over styling via draw.io templates. Your diagrams look exactly the way you want them.

🤖 LLM-Friendly

JSON model format that LLMs read and write natively. CLI commands and an interactive REPL let AI agents and humans modify your architecture. IDE autocompletion via JSON Schema — no plugin needed.

🛠 Flexible Hierarchy

Not limited to 4 C4 levels. Define your own element kinds. Components of components? No problem. Your architecture, your rules.

How it works

1. Define your model
JSON with IDE support
{
  "model": {
    "webshop": {
      "kind": "system",
      "title": "Webshop",
      "children": {
        "api": {
          "kind": "container",
          "title": "REST API",
          "technology": "Spring Boot"
        }
      }
    }
  }
}
2. Get your diagram
bausteinsicht sync
System Context diagram generated by Bausteinsicht

More than diagrams

🛡️ Governance

lint checks your architecture constraints, health scores the model, graph finds dependency cycles, and stale detects forgotten elements. Architecture Decision Records managed right next to the model.

📈 Evolution

Versioned snapshots with diff and restore. Compare as-is and to-be architectures. Generate an architecture changelog between any two points in time. Your architecture history becomes first-class.

🔌 Interop & Export

Import from Structurizr DSL and LikeC4. Export to C4-PlantUML, Mermaid, DOT, D2, Structurizr DSL, sequence diagrams, AsciiDoc/Markdown tables, and PNG/SVG — plus metric heatmap overlays on your diagrams.

Migrating from Structurizr or LikeC4?

Bausteinsicht takes the best ideas from Structurizr and LikeC4 and combines them with the world's most popular free diagramming tool — and bausteinsicht import brings your existing model along.

Ready to structure your architecture?

Start the Tutorial View on GitHub Specification