Sign in

Simon Brown

@simonbrown.je
1.6K followers 144 following 110 posts

Creator of the C4 model and Structurizr | Author | Speaker | Software architecture and diagramming workshops worldwide

PostsRepliesMedia
Reposted by Simon Brown
Jeff Bailey [Unofficial] @jeffbailey.us.web.brid.gy · 20/09/2026
jeffbailey.us
Structurizr vs Mermaid vs PlantUML for C4 Diagrams
Three tools draw C4 diagrams from text, and picking between them looks like a taste question about syntax. It is mostly a question about what you want to keep: a picture, or a model that can produce pictures. Everything below was run on one system modeled three ways, with Structurizr 2026.09.19 (structurizr-* 6.2.3), Mermaid CLI 11.17.0 on mermaid 11.17.2, and PlantUML 1.2026.8 on Graphviz 16.1.0. ## The short answer **Reach for Structurizr** When the same system needs more than one diagram. You describe the model once and generate every view from it, so a renamed container changes in one place. **Reach for Mermaid** When the diagram must render where it lives, in a README or a wiki, with no build step and no renderer to install. **Reach for PlantUML** When layout quality matters most. Graphviz routes edges around boxes, and no other option here does. These are not three competitors for one slot. Structurizr exports PlantUML and Mermaid, so the real choice is whether you keep a model upstream of whichever renderer you already use.
003
Reposted by Simon Brown
Stacy Cashmore @stacy-clouds.net · 22/09/2026
Over the last few weeks I have forked the archived Struturizr .NET SDK and launched the NuGet pacakges for use. I could really use help and feedback, so if you use C4 in the .NET space, please take a look and leave me issues/PRs for things that are missing! stacy-clouds.net/blogposts/20...
stacy-clouds.net
Introducing C4.Net - A Structurizr Client and More | Stacy Clouds
For years I've been using C4 diagrams to document my architecture. The reasons are too long to list here, but for me it's just the easiest way to see the various levels. I also used the C4 DSL SDK so ...
022
Reposted by Simon Brown
dev2next.bsky.social @dev2next.bsky.social · 07/09/2026
Still relying on confusing architecture diagrams? 🏗️ Attend @simonbrown.je's hands-on workshop at #Dev2Next to learn why most diagrams fail, how to fix them, and how the C4 model can help you create clearer views of your software systems. 🔗 www.dev2next.com/schedule 🎟️ Get tickets: dev2next.com
022
Reposted by Simon Brown
dev2next.bsky.social @dev2next.bsky.social · 21/08/2026
In the pursuit of agility, have teams abandoned software design altogether? 🏗️ In his #dev2next keynote, @simonbrown.je explores why architectural thinking and upfront design still matter, helping teams avoid costly rework and move faster. 🔗 www.dev2next.com/speaker/8352... 🎟️ dev2next.com
042
Reposted by Simon Brown
GOTO Conferences @gotocon.com · 31/07/2026
@simonbrown.je and his C4 Model: *Draw context and containers, mostly leave the rest *The deeper levels go stale with every commit *What matters is getting everyone to agree what the words mean #GOTOpodcast episode with @suksr.bsky.social out now: gotopia.tech/podcast
061
Reposted by Simon Brown
dev2next.bsky.social @dev2next.bsky.social · 20/07/2026
Still relying on confusing architecture diagrams? 🏗️ Attend @simonbrown.je's hands-on workshop at #Dev2Next to learn why most diagrams fail, how to fix them, and how the C4 model can help you create clearer views of your software systems. 🔗 www.dev2next.com/schedule 🎟️ Get tickets: dev2next.com
021
Reposted by Simon Brown
GOTO Conferences @gotocon.com · 18/06/2026
Your architecture diagrams have unlabeled arrows, mystery boxes & 12 different shades of blue. Nobody knows what any of it means. @simonbrown.je wrote the book that helps & @suksr.bsky.social asked him everything you need to know about it. GOTO Book Club 👇 youtu.be/sfqHggWY5Ds?...
youtu.be
The C4 Model: Visualizing Software Architecture • Simon Brown & Susanne Kaiser • GOTO 2025
YouTube video by GOTO Conferences
031
Reposted by Simon Brown
dev2next.bsky.social @dev2next.bsky.social · 16/06/2026
Still relying on confusing architecture diagrams? 🏗️ Attend @simonbrown.je's hands-on workshop at #Dev2Next to learn why most diagrams fail, how to fix them, and how the C4 model can help you create clearer views of your software systems. 🔗 www.dev2next.com/schedule 🎟️ Get tickets: dev2next.com
022
Simon Brown @simonbrown.je · 18/05/2026
Structurizr v2026.05.16 was released over the weekend ... see www.patreon.com/posts/v2026-... for details.
020
Reposted by Simon Brown
Seb Rose @sebrose.bsky.social · 12/05/2026
From sketches to AI-ready architecture diagrams with C4 and Structurizr - an insights session with C4’s creator and maintainer, Simon Brown (@simonbrown.je). Free, but registration needed edinburghbranch20052026.eventbrite.co.uk
edinburghbranch20052026.eventbrite.co.uk
The C4 model, Structurizr vNext, and AI
Introduction to C4, Structurizr modelling, new vNext features, and how to improve AI‑generated architecture diagrams.
101
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 06/05/2026
If you missed @simonbrown.je's #YOW25 talk, catch it here!
021
Simon Brown @simonbrown.je · 04/05/2026
This is ultimately where vibe coding is now.
000
Simon Brown @simonbrown.je · 04/05/2026
The devs of today will become the ivory tower architects of tomorrow. "AI prompting + human code review" only works if the humans have technical knowledge, which will likely decline if humans are no longer writing code. Discuss. 😄
2173
Reposted by Simon Brown
Seb Rose @sebrose.bsky.social · 30/04/2026
@simonbrown.je is coming to BCS Edinburgh Branch on Wednesday May 20th to talk about the latest developments in the C4 architectural diagramming system. Registration is free, but places are limited. edinburgh.bcs.org/events/2026/...
edinburgh.bcs.org
BCS Edinburgh Branch event: 20/05/26 The C4 model, Structurizr vNext, and AI
021
Simon Brown @simonbrown.je · 23/04/2026
Locking your software architecture models away in proprietary tools? My original vision for Structurizr, separating workspace authoring from diagram rendering via an open JSON format, was to have an ecosystem of community tooling. ~30 tools now listed -> docs.structurizr.com/community
docs.structurizr.com
Community tooling
Documentation for the Structurizr tooling.
060
Simon Brown @simonbrown.je · 20/04/2026
Structurizr v2026.04.19 has been released - see github.com/structurizr/... for details.
github.com
Release v2026.04.19 (application) · structurizr/structurizr
Updates Structurizr for Java library to v6.2.0. There are now two versions of the prebuilt binaries - see Prebuilt binaries for details. local Fixes #51 (window.location.hash not scrolled to on r...
010
Simon Brown @simonbrown.je · 13/04/2026
Congrats! 👏
100
Simon Brown @simonbrown.je · 19/03/2026
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/
094
Simon Brown @simonbrown.je · 17/03/2026
Automated PNG/SVG exports from Structurizr -> www.patreon.com/posts/153245... (early access now available for Patreon members, free to read next week)
010
Simon Brown @simonbrown.je · 17/03/2026
Shipped in preview last week 🚀: > structurizr generate system-landscape Links: - docs.structurizr.com/generate - docs.structurizr.com/workspaces/e...
000
Simon Brown @simonbrown.je · 16/03/2026
Chapters 1-9 now available at learning.oreilly.com/library/view... 🎉
learning.oreilly.com
The C4 Model
Good architecture is more than just good code—it's clear communication. The C4 Model: Visualizing Software Architecture is a practical guide to creating diagrams that help teams... - Selection from Th...
094
Simon Brown @simonbrown.je · 10/03/2026
It worked well!
010
Simon Brown @simonbrown.je · 09/03/2026
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)
021
Simon Brown @simonbrown.je · 09/03/2026
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.
130
Simon Brown @simonbrown.je · 09/03/2026
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.
040
Simon Brown @simonbrown.je · 06/03/2026
The new Structurizr MCP server (www.patreon.com/posts/152045...) makes it even easier for AI to generate valid Structurizr DSL now! 🚀
141
Simon Brown @simonbrown.je · 06/03/2026
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...
021
Simon Brown @simonbrown.je · 20/02/2026
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.
patreon.com
UI-driven vs "as code" | Structurizr
Get more from Structurizr on Patreon
100
Simon Brown @simonbrown.je · 22/01/2026
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/...
021
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 17/10/2025
🏗️ 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
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"
043
Simon Brown @simonbrown.je · 06/11/2025
I'm doing a Reddit AMA in a couple of weeks ... more details at www.reddit.com/r/softwarear...
040
Simon Brown @simonbrown.je · 06/11/2025
Thank you! 🙏
000
Simon Brown @simonbrown.je · 23/10/2025
The new shapes are available in the next release, but you can build from source to use them now -> docs.structurizr.com/lite/building
docs.structurizr.com
Building from source
Documentation for the Structurizr tooling.
000
Simon Brown @simonbrown.je · 23/10/2025
C4 is notation independent, so they is no "new look" ... you can use whatever colours and shapes you like.
100
Simon Brown @simonbrown.je · 23/10/2025
Those diagrams were created with Structurizr. 🙂 (source will released soon)
100
Simon Brown @simonbrown.je · 21/10/2025
Thanks! Yes, there's a lot more content than the original book ... plus it has the new C4 model example diagrams.
100
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 16/10/2025
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/...
043
Simon Brown @simonbrown.je · 01/10/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...
oreilly.com
The C4 Model
Good architecture is more than just good code—it's clear communication. The C4 Model: Visualizing Software Architecture is a practical guide to creating diagrams that help teams... - Selection from Th...
5270
Simon Brown @simonbrown.je · 23/09/2025
Sneak peek! Join the C4 model Patreon if you want to be the first to hear about it... 🤔 www.patreon.com/c/c4model
021
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 15/09/2025
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
YOW! 2025 speaker Simon Brown
The C4 Model: Beyond the Basics
A smiling bespectacled man with slicked back grey hair
032
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 03/09/2025
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/...
001
Simon Brown @simonbrown.je · 30/08/2025
The checklist is now on the website -> c4model.com/diagrams/che... And yes, the Discord server is a Patreon benefit.
c4model.com
Review checklist
The C4 model for visualising software architecture
130
Simon Brown @simonbrown.je · 25/08/2025
Farewell "blue and grey boxes" ... the new example diagrams are now live on the C4 model website -> c4model.com
2164
Reposted by Simon Brown
Simon Baynes @bayn.es · 22/07/2025
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
nuget.org
Structurizr.Aspire.Hosting 0.1.0.2
Add Structurizr Lite to your Aspire AppHost
162
Reposted by Simon Brown
Simon Brown @simonbrown.je · 28/06/2025
New C4 model examples are on the way! See patreon.com/posts/132584... for details.
0164
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 23/07/2025
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/...
YOW! 2025 Masterclass: Visualising Software Architecture with The C4 Model
Simon Brown
Melbourne - Wed 3 Dec
Sydney - Wed 10 Dec
021
Simon Brown @simonbrown.je · 30/06/2025
"System context diagram example (2025)" has been published on the C4 model Patreon today -> www.patreon.com/posts/132613... (it explains the new example available later this summer, and the rationale behind it)
patreon.com
System Context diagram example (2025) | The C4 model
Get more from The C4 model on Patreon
011
Simon Brown @simonbrown.je · 28/06/2025
New C4 model examples are on the way! See patreon.com/posts/132584... for details.
0164
Reposted by Simon Brown
YOW! Conferences @yowconf.bsky.social · 25/06/2025
Last chance to lock in earlybird tickets to #YOW25 masterclasses with promo code 'earlybirdclass' & join @simonbrown.je @frankel.ch @kentbeck.com @kevindubois.com @philippederyck.bsky.social Katharine Jarmul & Michael Feathers MEL 3 Dec yowcon.com/melbourne-2025 SYD 10 Dec yowcon.com/sydney-2025
043
Reposted by Simon Brown
Goa @goadesign.bsky.social · 27/05/2025
🎉 Model v1.11.0 is out! Major graphical editor upgrade: ✨ Dual drag modes (pan/select) ✨ Grid system with snap-to-grid ✨ Modern toolbar & shortcuts ✨ Better multi-selection Perfect for #DiagramAsCode with #C4Model! #SoftwareArchitecture #Golang #OpenSource github.com/goadesign/mo...
github.com
Release v1.11.0 · goadesign/model
Model v1.11.0 Release Notes Major Graphical Editor Overhaul This release represents a significant step forward for the Model graphical editor. We've completely redesigned the user interface and add...
031