In Structurizr, a workspace is the wrapper for your software architecture model, views and supplementary documentation. All of this is created using one of the Structurizr client libraries. We recommend that a workspace contains the model, views and documentation for a single software system.

The basic Structurizr concepts


This is the definition of the software architecture model, consisting of people, software systems, containers, components and code elements, plus the relationships between them. The model can be created by manually specifying model elements, or using static analysis and reflection techniques, if supported by the client library you are using.


This is the definition of the enterprise context, system context, container and component views of the software architecture model. Each view is rendered by Structurizr as a diagram, with the client libraries providing control over which elements are included in the resulting diagram. Styling information (colours, shapes, font sizes, etc) is also included here.


This is the definition of the supplementary documentation (a collection of content in Markdown or AsciiDoc, and accompanying images). Documentation consists of a number of different possible sections, each of which takes the form of a separate piece of Markdown or AsciiDoc content. Structurizr diagrams can be embedded into the documentation sections too.