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 Create a new workspace 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

Recommended Demo

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

Recommended

Java, .NET, TypeScript, PHP, Python, and Go via the JSON web API. 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).

Create content using the UI

Browser-based UI

Not recommended Demo

A browser-based UI, recommended for non-programmers and smaller models only.

(please note that the UI does not support all of the features found in the Structurizr DSL and code-based client libraries)