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. Structurizr lets you create a software architecture model using code or text (via the JSON-based web API), or with our browser-based UI (recommended for non-programmers, and smaller software architecture models).

Create content using code

Diagrams as code

Java, .NET, TypeScript, PHP, and Python via the JSON web API (demo)

Create content using text

Diagrams as text

YAML, and a text-based DSL (demo)