Early POC: Documenting Software architecture with C4 and the Structurizr DSL

Daniel — Tue, 14 Apr 2026 15:37:50 +0000

A couple of months ago I conducted a public ODI/Jobs-to-be-done research on current pain points of documenting software architecture.

I'm excited to share a very early proof of concept of the derived solution at https://app.maniok.io
It currently only works for public repositories and is open source (MIT licensed)

In essence, it is a Structurizr / C4 diagrams renderer that works on git repositories containing Structurizr documentation.

Support for Structurizr is very basic and there are a couple of known issues (listed in the docs).

What do you think?

Building a better tool for documenting software architecture

Daniel — Mon, 09 Mar 2026 14:58:05 +0000

Having spent extensive time researching options to document software architecture, not finding a satisfying solution to serve my needs, I’ve decided to build something that does.

I want to make it worth the effort by founding this project on solid data, using the jobs-to-be-done framework and outcome driven innovation (ODI) to identify underserved needs in the segment.

Based on the desired outcomes analysis I've created this survey: https://forms.gle/2dtEAad6xirS4Ejy5 (it takes about 15 minutes to complete)

The aggregated results will be shared publicly and participants can optionally gain early access to the tooling developed on conclusion of the survey.

Would greatly appreciate your input and am looking forward to your thoughts on the project!

DEV Community: Daniel

Early POC: Documenting Software architecture with C4 and the Structurizr DSL

Building a better tool for documenting software architecture