Version control

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

  • Code/text: The recommended approach is to create your software architecture model as code/text using one of the client libraries or the Structurizr DSL. This model source 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.