Workspaces

What is a “workspace”?

In Structurizr, a workspace is the wrapper for:

• A software architecture model (elements and relationships).
• Views (that become rendered as diagrams).
• Markdown/AsciiDoc documentation.
• Markdown/AsciiDoc architecture decision records.

The recommended approach is that a workspace contains the model, views, documentation, and decisions for a single software system - see Scope for more details.

Workspace files

Structurizr uses two file types to represent workspaces:

• workspace.dsl: Your workspace source, created using the Structurizr DSL. This defines your software architecture model and views, along with any processing instructions (e.g. scripts, plugins, documentation, ADRs, etc).
• workspace.json: The “compiled” version of your workspace source, additionally including diagram layout information from the diagram editor. This is an open JSON data format and is not designed to be edited by hand.