Congrats! π
Posts by Simon Brown
Introducing the "C4 model and Structurizr DSL pattern catalog"! π’
This pattern catalog presents a number of minimal examples of how to use the C4 model and the Structurizr DSL to model common patterns found in software architecture.
Link: docs.structurizr.com/dsl/patterns/
Automated PNG/SVG exports from Structurizr -> www.patreon.com/posts/153245...
(early access now available for Patreon members, free to read next week)
Shipped in preview last week π:
> structurizr generate system-landscape
Links:
- docs.structurizr.com/generate
- docs.structurizr.com/workspaces/e...
It worked well!
Define your software architecture model using the Structurizr DSL and be alerted when architecture drift is detected -> erode.dev/docs/models/...
(usual caveats apply: I haven't tried it, links/reposts from me are not recommendations, etc)
This morning's Structurizr + AI experiment ... you have a Structurizr server running, each team is pushing a workspace representing their view of the world. Use AI to generate a combined system landscape.
Tried this with Claude over the weekend - it worked first time, out of the box. π
See docs.structurizr.com/ai/dsl-gener... for more details.
The new Structurizr MCP server (www.patreon.com/posts/152045...) makes it even easier for AI to generate valid Structurizr DSL now! π
A free to read three part series of posts about why most AI generated architecture diagrams are terrible and how to fix them -> www.patreon.com/collection/2...
Following the Structurizr vNext announcement, I've had a few questions asking if the software architecture model can be modified via the UI, and if I have any plans to support a UI-driven approach to creating Structurizr workspaces.
See www.patreon.com/posts/151073... for the answer.
A Structurizr MCP server is available on GitHub! It provides an easy way to load workspaces from the local file system (JSON or DSL) and to load JSON workspaces from a self-hosted Structurizr server.
Link: github.com/structurizr/...
YOW! 2025 Software Architecture Speakers: Simon Brown with "The C4 Model - Beyond the Basics" and Andrew Harmel-Law with "Facilitating Software Architecture: Empowering Teams to Make Architectural Decisions"
ποΈ Letβs talk #SoftwareArchitecture!
@simonbrown.je & @andrewhl.bsky.social join #YOW25 to challenge how you think abt structure, scale, & collaboration in modern software systems.
π
MEL 4-5 | BNE 8-9 | SYD 11-12 Dec
yowcon.com
I'm doing a Reddit AMA in a couple of weeks ... more details at www.reddit.com/r/softwarear...
Thank you! π
The new shapes are available in the next release, but you can build from source to use them now -> docs.structurizr.com/lite/building
C4 is notation independent, so they is no "new look" ... you can use whatever colours and shapes you like.
Those diagrams were created with Structurizr. π
(source will released soon)
Thanks! Yes, there's a lot more content than the original book ... plus it has the new C4 model example diagrams.
Dive deep into what matters to you & your team in our 1-day #YOW25 masterclasses led by globally recognised tech experts, including @kevindubois.com @philippederyck.bsky.social @frankel.ch & @simonbrown.je
Join them in Melbourne or Sydney:
yowcon.com/melbourne-20...
yowcon.com/sydney-2025/...
I'm excited to announce that I'm writing a book for O'Reilly! New example diagrams, new content, and new guidance.
Early access to the first two chapters is now live on the O'Reilly platform -> www.oreilly.com/library/view...
Sneak peek! Join the C4 model Patreon if you want to be the first to hear about it... π€
www.patreon.com/c/c4model
YOW! 2025 speaker Simon Brown The C4 Model: Beyond the Basics A smiling bespectacled man with slicked back grey hair
The #C4 model is a go-to for visualising software architecture, but how do you go beyond the basics?
@simonbrown.je will answer the most common C4 questions, from modelling shared code & microservices to tackling message-driven architectures.
#YOW25 MEL 4-5 | BNE 8-9 | SYD 11-12 Dec yowcon.com
Join @simonbrown.je in a 1-day hands-on #YOW25 masterclass on the #C4Model. Learn how to create meaningful diagrams that improve team communication and decision-making.
π MEL | 3 Dec | π yowcon.com/melbourne-20...
π SYD | 10 Dec | π yowcon.com/sydney-2025/...
The checklist is now on the website -> c4model.com/diagrams/che...
And yes, the Discord server is a Patreon benefit.
Farewell "blue and grey boxes" ... the new example diagrams are now live on the C4 model website -> c4model.com
For those of you that use the #Structurizr DSL for publishing your #C4 Architecture diagrams and would like to use #dotnetaspire to add them to your AppHost. Then I have a NuGet package for you:
www.nuget.org/packages/Str...
#dotnet #aspire #nuget
New C4 model examples are on the way! See patreon.com/posts/132584... for details.
YOW! 2025 Masterclass: Visualising Software Architecture with The C4 Model Simon Brown Melbourne - Wed 3 Dec Sydney - Wed 10 Dec
Struggling with messy #SoftwareArchitecture diagrams? Join
@simonbrown.je for a 1-day hands-on #C4Model workshop at #YOW25!
π MEL | π
Wed 3 Dec | π yowcon.com/melbourne-20...
π SYD | π
Wed 10 Dec | π yowcon.com/sydney-2025/...