Diagrams as code 2.0

on YouTube ↗51m

" summary

Argues that modeling beats drawn diagrams by creating a single source of truth: a Java-based Structurizr DSL model describes elements and relationships once and generates multiple views (context, container, component) with implied relationships and theming. Shows tooling: a CLI that exports to PlantUML/Mermaid/dot, a browser renderer (free Structurizr Lite Docker) with interactive force‑directed views, and a component‑finder plus JSR223 hooks for auto‑generating parts from code. Demonstration claims reduced duplication, automated exports, and usable interactive diagrams for large systems.

AI-written summary · about

" chapters (11)

1. 0:00The problem with diagrams
2. 1:49The C4 model explained
3. 4:25Limitations of manual tools
4. 7:23Introducing diagrams as code
5. 10:41Structurizr DSL basics
6. 15:41Styling and presentation
7. 18:22Rendering and tool flexibility
8. 25:16Handling large systems
9. 29:01Advanced automation and hybrid
10. 34:32Closing thoughts and demo
11. 40:08Q&A session

" related talks

• 01h 00mC4 models as codeSimon Brown · NDC Oslo 2023
• 41mC4 Models as CodeSimon Brown · YOW! Melbourne 2022
• 54mC4 models as codeSimon Brown · NDC Porto 2023
• 01h 00mVisualise, document and explore your software architectureSimon Brown · NDC Oslo 2017
• 52mC4 Models as CodeSimon Brown · YOW! Melbourne 2022
• 57mVisualise, document and explore your software architectureSimon Brown · NDC London 2017
• 49mReverse-engineering Architecture DiagramsSimon Brown · Jfokus 2025
• 45mSet your data free with model-based architecture diagrammingAvi Flax · Write the Docs Portland 2020