Structurizr is a web-based publishing platform for software architecture models created using the Structurizr for Java or Structurizr for .NET open source libraries; allowing you to visualise, document and explore your software architecture using the C4 model.

Structurizr is available as a cloud-based service and an on-premises installation.

Visualise your software architecture


Publish web-based software architecture diagrams using Java and C#.

Document your software architecture


Publish supplementary documentation using Markdown and AsciiDoc.

Explore your software architecture


Understand and improve your software architecture by exploring it.

Sign up for free

Software architecture diagrams as code

Unlike traditional modeling tools, Structurizr does not provide a "drag and drop" editor to create diagrams. Instead, you create a software architecture model using code and upload it via the web API. Here's a simple example using the "Structurizr for Java" library:

public static void main(String[] args) throws Exception {
    Workspace workspace = new Workspace("Getting Started", "This is a model of my software system.");
    Model model = workspace.getModel();

    Person user = model.addPerson("User", "A user of my software system.");
    SoftwareSystem softwareSystem = model.addSoftwareSystem("Software System", "My software system.");
    user.uses(softwareSystem, "Uses");

    ViewSet viewSet = workspace.getViews();
    SystemContextView contextView = viewSet.createSystemContextView(softwareSystem, "SystemContext", "An example of a System Context diagram.");

    Styles styles = viewSet.getConfiguration().getStyles();

    StructurizrClient structurizrClient = new StructurizrClient("key", "secret");
    structurizrClient.putWorkspace(25441, workspace);

And here's the resulting diagram when you open it in Structurizr, where the layout of the diagrams can be modified.

A simple diagram
A simple diagram
A diagram key is automatically generated for you, based upon the styles defined in the model.

The following diagram types are supported.

System Landscape diagram

System Landscape diagram

System Context diagram

System Context diagram

Container diagram

Container diagram

Component diagram

Component diagram

Dynamic diagram

Dynamic diagram

Deployment diagram

Deployment diagram

Software documentation as Markdown or AsciiDoc

Because the code doesn't tell the whole story, Structurizr also provides support for lightweight supplementary technical documentation, based upon a number of popular templates such as arc42. You can also create your own custom template.

The documentation is a collection of Markdown or AsciiDoc documents, one per section, which are rendered in the web browser. This content is uploaded in a workspace along with the software architecture model, which makes it easy to embed diagrams from that workspace.

Structurizr documentation screenshot

Explore your software architecture model

Once you have a model of your software system, extracted from your code using static analysis techniques, you can additionally visualise the model in a number of different ways. Structurizr provides some explorations to help you explore the elements and their relationships in the model.

Static Structure - Tree

Explore the software systems, containers and components defined in the model.

Static Structure - Size - Circles

View model elements ranked by size.

Dependencies - Components

Explore the afferent, efferent and cyclic dependencies between components.

Dependencies - Components and Code

Explore the dependencies between components and code.

Far too many teams allow their codebases to grow without having an insight into the structure of the code. The result is often the proverbial "big ball of mud"; a codebase that is tangled, hard to understand, hard to work with and hard to change. Visualising the structure of your code is the first step towards improving it.

Supplement your software architecture model

Once you have a model of your software system, rather than just a collection of diagrams, you can supplement that model in a number of different ways. Structurizr's health checks feature allows you to supplement your deployment models with HTTP-based health checks to get an "at a glance" view of the health of your software systems; useful for displaying as a dashboard or for helping to diagnose problems.

Add HTTP-based health checks to your software architecture model

Software architecture diagrams as text

Structurizr also provides an "Express" feature that allows you to create a single diagram without creating and uploading a workspace via the API. This is useful if you need to quickly create a simple software architecture diagram. To use this feature, simply head to Structurizr Express where you'll find a regular diagram editing page along with some controls on the left to define the diagram.

Structurizr Express

Structurizr vs other tools

The goal of Structurizr is to allow software developers to easily create software architecture diagrams that reflect the code. Structurizr combines the power and richness of a model, with the ease of use we get from text-based tools such as PlantUML and WebSequenceDiagrams. Our team-based pricing ensures that everybody on your team has access to diagrams, documentation and explorations when they need it.

Structurizr vs other tools
On-premises installation

Cloud and on-premises

Our cloud services allow you to get started with Structurizr quickly, without needing to host and update software on your own servers. Structurizr workspaces are stored using AES encryption on our servers, and you can use client-side encryption for additional comfort.

We also have an on-premises installation that can be run locally on your own servers, for organisations that can't or don't want to use the cloud.

Client libraries

Open source client libraries are currently available for Java and Microsoft .NET, which allow you to create software architecture models and upload them to Structurizr. A number of examples are also included, illustrating the key features, to help you get started.

GitHub Structurizr for Java Structurizr for .NET

Structurizr client libraries