Here’s a quick getting started guide to using the Structurizr cloud service.

1. Sign up for an 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 workspace

Next, create a new workspace by clicking the “New workspace” link on your dashboard. This will create a new empty workspace, which will be used to store your software architecture model, diagrams, and documentation.

4. Author your workspace

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

  1. Pushing a Structurizr DSL file via the workspace API using the Structurizr CLI push command (recommended).
  2. Pushing a workspace created using one of the code-based client libraries (e.g. Structurizr for Java) via the workspace API.
  3. Using the browser-based DSL editor (not recommended - it doesn’t support the full feature set).

Although not the recommended approach, to get started quickly, click the “DSL editor” link on your workspace summary page - this provides a way to define your workspace using the Structurizr DSL.