Getting started

[0] Read about the C4 model

Structurizr is specifically designed to support the C4 model for visualising software architecture, so you'll need some basic understanding of this.

[1] Sign up for a free account

Before you can do anything, you will need to sign up for a free Structurizr account using the sign up page.

[2] Sign in

Once you've signed up for an account, you can sign in to get to your dashboard.

[3] Create a new workspace

Next, create a new workspace by clicking the link on your dashboard. This will create a new empty workspace, which will be used to store your software architecture model. We recommend that a workspace contains the model, views, and documentation for a single software system - see Usage recommendations for more details.

[4] How would you like to create diagrams and documentation?

You now have a choice of how you would like to create the software architecture model in your workspace.

Create content using text

Diagrams as text


The Structurizr DSL is a text-based DSL, designed to be used in conjunction with the Structurizr CLI. This is the recommended authoring option for most teams.

Create content using code

Diagrams as code

Java, .NET, TypeScript, PHP, Python, and Go via the JSON web API - see Structurizr - Authoring tools for more. This authoring option is recommended for teams who want to use code to help build their software architecture model (e.g. component discovery via static analysis, parsing distributed log files, etc).