Structurizr

Client-side encrypted workspace

The workspace "" has been client-side encrypted, please enter the passphrase to decrypt it.

Save passphrase in browser local storage

The workspace could not be decrypted.

DSL editor

This browser-based DSL editor provides some rudimentary syntax highlighting and the ability to use the DSL without installing any tooling, but it does not provide access to the full feature set of the DSL. We recommend using the DSL in conjunction with Structurizr Lite or the Structurizr CLI instead. See Help - DSL for more details.

Structurizr Lite

Recommended

Structurizr Lite provides a way to quickly work with a single workspace. It's free to use, and allows you to view/edit diagrams, view documentation, and view architecture decision records defined in a DSL workspace.

The auto-sync feature provides the ability to sync your local changes with a workspace stored on the Structurizr cloud service or an on-premises installation.

Structurizr CLI

Recommended

The Structurizr CLI is a command line utility, designed to be used in conjunction with the Structurizr DSL. It provides the ability to push/pull workspaces to/from the Structurizr cloud service or an on-premises installation, in additional to exporting the views defined in a DSL file to other formats (PlantUML, Mermaid, WebSequenceDiagrams, and Ilograph).

See Getting started with the Structurizr CLI and DSL for more information.

DSL editor

Not recommended

If you'd rather not use Structurizr Lite or the Structurizr CLI, the Structurizr cloud service/on-premises installation provides a basic online DSL editor. The editor provides some rudimentary syntax highlighting and the ability to use the DSL without installing any tooling, but it does not provide access to the full feature set of the DSL.

Upload

workspace "Name" "Description" { model { u = person "User" ss = softwareSystem "Software System" u -> ss "Uses" } views { systemContext ss "Diagram1" { include * autolayout lr } } }

Structurizr DSL v3.0.0 - some features (e.g. !docs, !adrs, !script, etc) are unavailable via this demo page; see DSL for details.

Examples: Big Bank plc | Microservices | Amazon Web Services

Structurizr

Diagram

Structurizr

Graph

Export

PlantUML

Export

C4-PlantUML

Export

Mermaid

Export

DOT

Export

WebSequenceDiagrams

Export

Ilograph

PlantUML definitions are available via the Structurizr CLI export command, using the -format plantuml parameter. See StructurizrPlantUMLExporter for customisation options.

@startuml
set separator none
title Software System - System Context

left to right direction

skinparam {
  arrowFontSize 10
  defaultTextAlignment center
  wrapWidth 200
  maxMessageSize 100
}

hide stereotype

skinparam rectangle<<SoftwareSystem>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}
skinparam rectangle<<User>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
  shadowing false
}

rectangle "==User\n<size:10>[Person]</size>" <<User>> as User
rectangle "==Software System\n<size:10>[Software System]</size>" <<SoftwareSystem>> as SoftwareSystem

User .[#707070,thickness=2].> SoftwareSystem : "<color:#707070>Uses"
@enduml

(this will send your diagram content to https://plantuml.com/plantuml)

@startuml
set separator none

skinparam {
  shadowing false
  arrowFontSize 15
  defaultTextAlignment center
  wrapWidth 100
  maxMessageSize 100
}
hide stereotype

skinparam rectangle<<_transparent>> {
  BorderColor transparent
  BackgroundColor transparent
  FontColor transparent
}

skinparam rectangle<<1>> {
  BackgroundColor #dddddd
  FontColor #000000
  BorderColor #9a9a9a
}
rectangle "==Element" <<1>>

rectangle "." <<_transparent>> as 2
2 .[#707070,thickness=2].> 2 : "<color:#707070>Relationship"


@enduml

(this will send your diagram content to https://plantuml.com/plantuml)

C4-PlantUML definitions are available via the Structurizr CLI export command, using the -format plantuml/c4plantuml parameter. See C4PlantUMLExporter for customisation options.

@startuml
set separator none
title Software System - System Context

left to right direction

!include <C4/C4>
!include <C4/C4_Context>

Person(User, "User", $descr="", $tags="", $link="")
System(SoftwareSystem, "Software System", $descr="", $tags="", $link="")

Rel(User, SoftwareSystem, "Uses", $techn="", $tags="", $link="")

SHOW_LEGEND(true)
@enduml

(this will send your diagram content to https://plantuml.com/plantuml)

Mermaid definitions are available via the Structurizr CLI export command, using the -format mermaid parameter. Your Mermaid configuration will need to include "securityLevel": "loose" to render this definition correctly.

graph LR
  linkStyle default fill:#ffffff

  subgraph diagram ["Software System - System Context"]
    style diagram fill:#ffffff,stroke:#ffffff

    1["<div style='font-weight: bold'>User</div><div style='font-size: 70%; margin-top: 0px'>[Person]</div>"]
    style 1 fill:#dddddd,stroke:#9a9a9a,color:#000000
    2["<div style='font-weight: bold'>Software System</div><div style='font-size: 70%; margin-top: 0px'>[Software System]</div>"]
    style 2 fill:#dddddd,stroke:#9a9a9a,color:#000000

    1-. "<div>Uses</div><div style='font-size: 70%'></div>" .->2
  end

(this will send your diagram content to https://mermaid.ink)

WebSequenceDiagram definitions are available via the Structurizr CLI export command, using the -format websequencediagrams parameter. Only dynamic views are supported.

DOT definitions are available via the Structurizr CLI export command, using the -format dot parameter.

digraph {
  compound=true
  graph [fontname="Arial", rankdir=LR, ranksep=1.0, nodesep=1.0]
  node [fontname="Arial", shape=box, margin="0.4,0.3"]
  edge [fontname="Arial"]
  label=<<br /><font point-size="34">Software System - System Context</font>>

  1 [id=1,shape=rect, label=<<font point-size="34">User</font><br /><font point-size="19">[Person]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]
  2 [id=2,shape=rect, label=<<font point-size="34">Software System</font><br /><font point-size="19">[Software System]</font>>, style=filled, color="#9a9a9a", fillcolor="#dddddd", fontcolor="#000000"]

  1 -> 2 [id=3, label=<<font point-size="24">Uses</font>>, style="dashed", color="#707070", fontcolor="#707070"]
}

Ilograph definitions are available via the Structurizr CLI export command, using the -format ilograph parameter. A single Ilograph export contains the model and all views.

resources:
  - id: "1"
    name: "User"
    subtitle: "[Person]"
    backgroundColor: "#dddddd"
    color: "#000000"

  - id: "2"
    name: "Software System"
    subtitle: "[Software System]"
    backgroundColor: "#dddddd"
    color: "#000000"

perspectives:
  - name: Static Structure
    relations:
      - from: "1"
        to: "2"
        label: "Uses"
        color: "#707070"