Version control

Although Structurizr doesn't have any native integration with version control systems (e.g. git), it is possible to use Structurizr in conjunction with version control systems as follows.

  • Client libraries: The best approach is to create your software architecture model as code or YAML, using one of the client libraries. This can be stored and managed alongside your production code and other documentation.
  • UI: If you're using the browser-based UI to create your software architecture model, you can use the workspace export feature to download the complete JSON representation of your workspace, which you can then store alongside your production code and other documentation.

We recommend the use of a separate workspace for staging, testing, and branching purposes.