Jeff Bailey
Written by Jeff Bailey
Learning resources, opinions, and facts about technology.

Learn Structurizr

Reading Time: 2.4 minutes
Listen to this post

The Basics

Structurizr is primarily a diagram generation tool created by Simon Brown, the creator of the C4 Model. The primary focus of the tool is the rapid generation of several diagrams with the same components. It appears that Simon was tired of the other tools that make you reinvent the wheel. I share the sentiment and believe that most diagram tools don’t facilitate reuse.

Primary Use Cases

  • Creation of architecture diagrams
  • Capture architecture decisions
  • Diagram review
  • Saving time!


Building diagrams can be very tedious, and Structrizr addresses this tedium. A typical workflow in Structurizr looks like this.

  1. Add diagram elements
  2. Create relationships
  3. Layout your diagram
  4. Download your diagrams

The diagram layout feature is amazing and will save you from the most tedious aspect of diagram creation.

Getting Help

I’ve found that learning how to use Structrizr will take time. I’ve barely scratched the surface of what it can do, but luckily you can get help.

I like to start with examples. I found the Spring PetClinic example to be the best way to learn how to use it. Try exporting the workspace from the workspace menu.

Then import the workspace so you can explore how those diagrams were created.

Learn Structurizr – Beyond the Basics