Pinned
Chapters 1-9 now available at learning.oreilly.com/library/view... ๐
Simon Brown
@simonbrown.je
Creator of the C4 model and Structurizr | Author | Speaker | Software architecture and diagramming workshops worldwide
1.5K followers144 following110 posts
Pinned
Chapters 1-9 now available at learning.oreilly.com/library/view... ๐
Simon Brown reposted
๐ช๐ต๐ฒ๐ป ๐๐ผ๐ผ๐ฑ-๐๐ผ๐ผ๐ธ๐ถ๐ป๐ด ๐๐ถ๐ฎ๐ด๐ฟ๐ฎ๐บ๐ ๐๐ฟ๐ฒ๐ปโ๐ ๐๐ผ๐ผ๐ฑ ๐๐ป๐ผ๐๐ด๐ต: ๐๐ป๐๐ฒ๐ฟ๐๐ถ๐ฒ๐ ๐๐ถ๐๐ต ๐ฆ๐ถ๐บ๐ผ๐ป ๐๐ฟ๐ผ๐๐ป ๐ผ๐ป ๐๐ฐ, ๐๐, ๐ฎ๐ป๐ฑ ๐ฆ๐ผ๐ณ๐๐๐ฎ๐ฟ๐ฒ ๐๐ฟ๐ฐ๐ต๐ถ๐๐ฒ๐ฐ๐๐๐ฟ๐ฒ ๐๏ธ In our latest interview, @simonbrown.je, creator of the #C4Model and #Structurizr, shares insights on AI-generated diagrams, architecture documentation & common pitfalls. ๐๏ธ t1p.de/ufl7i
Simon Brown reposted
Simon Brown reposted
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...
Simon Brown reposted
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
Simon Brown reposted
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
Simon Brown reposted
@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
Simon Brown reposted
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
Simon Brown reposted
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?...
Simon Brown reposted
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
Structurizr v2026.05.16 was released over the weekend ... see www.patreon.com/posts/v2026-... for details.
Simon Brown reposted
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
Simon Brown reposted
If you missed @simonbrown.je's #YOW25 talk, catch it here!
Half the industry is at level 1 of architecture diagram maturity. That means: nothing. Just vibes & boxes. @simonbrown.je โ creator of the #C4Model โ explains what levels 2 through 5 look like & how to get there. Spoiler: you need to stop diagramming & start modeling. youtu.be/FqTL-_tLf6I?...
Simon Brown reposted
@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/...
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
Structurizr v2026.04.19 has been released - see github.com/structurizr/... for details.
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...
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)
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/...
Simon Brown reposted
๐๏ธ 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...
Simon Brown reposted
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
Simon Brown reposted
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
Simon Brown reposted
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/...
Farewell "blue and grey boxes" ... the new example diagrams are now live on the C4 model website -> c4model.com
Simon Brown reposted
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
Simon Brown reposted
New C4 model examples are on the way! See patreon.com/posts/132584... for details.
Simon Brown reposted
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/...
"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)
New C4 model examples are on the way! See patreon.com/posts/132584... for details.
Simon Brown reposted
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
Simon Brown reposted
๐ 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...
Simon Brown reposted
It's not too late to sign up for these workshops: buff.ly/N5okAJR
Simon Brown reposted
Moving fast and being Agile requires good communication, yet software development teams struggle with this fundamental skill. A good set of software architecture diagrams are priceless for aligning a team around a shared vision and for getting new-joiners productive fast: buff.ly/uX2tk38
I've updated the Structurizr DSL microservices example to take advantage of the new archetypes feature introduced a few weeks ago, which provides a richer and more concise DSL definition. The source can be found at github.com/structurizr/... if you're interested in taking a look.
Simon Brown reposted
Wrote a little on the C4 model and why I like it. On tumblr because why not :) www.tumblr.com/blmonit/7831...
Simon Brown reposted
Moving fast and being Agile requires good communication, yet software development teams struggle with this fundamental skill. A good set of software architecture diagrams are priceless for aligning a team around a shared vision and for getting new-joiners productive fast.: buff.ly/wXsJVc8
Simon Brown reposted
๐ก Want to store diagrams alongside your code? Learn diagrams-as-code using PlantUML, Mermaid & Structurizr in this hands-on workshop. Understand how to validate LLM-generated diagrams too! buff.ly/iZf0XNy โฐ It is time to order!
Simon Brown reposted
The C4 model is simpleโbut are you using it right? @simonbrown.je dives into common C4 mistakes & how to better model microservices, shared code, and complex systems at #YOW25. ๐Mel 4โ5 Dec | Bris 8โ9 Dec | Syd 11โ12 Dec ๐ yowcon.com