Structurizr Puppeteer
This repo contains some Node.js examples of how to script and automate parts of the Structurizr web application using Puppeteer (and headless Chrome) from the command line, perhaps as a part of your build process. Examples of what you can do include:
- Export diagrams and keys to PNG or SVG formats.
- Export all diagrams to a single HTML page for offline use.
See Structurizr - Help - Scripting - Diagrams for more details.
Examples
The command line examples that follow assume that you have Puppeteer installed. Please see Puppeteer for details of how to install Puppeteer on your platform.
Exporting diagrams from a public workspace
The export-public-diagrams.js script will export diagrams and keys from a public Structurizr workspace, creating a number of PNG or SVG (HTML) files in the current directory.
node export-public-diagrams.js <structurizrUrl> <png|svg> <workspace ID> [diagram key]
For example, to export all diagrams (and keys) from the Big Bank plc example workspace:
node export-public-diagrams.js https://structurizr.com png 36141
And to export a single diagram:
node export-public-diagrams.js https://structurizr.com png 36141 SystemContext
Exporting diagrams from a private workspace
The export-private-diagrams.js script will export diagrams and keys from a private Structurizr workspace (on the cloud service), creating a number of PNG or SVG (HTML) files in the current directory.
node export-private-diagrams.js <structurizrUrl> <username> <password> <png|svg> <workspaceId> [diagramKey]
For example, to export all diagrams (and keys) from a private workspace, with ID 123456:
node export-private-diagrams.js https://structurizr.com username password png 123456
Auto-layout
By default, Structurizr will only apply an auto-layout algorithm if the diagram definition doesn't include any layouting information; i.e. there are no x,y coordinates specified for any of the elements on the diagram. To force an auto-layout algorithm, call the structurizr.scripting.setAutoLayout(bool) function with true or false before changing the view. Alternatively, you can set a query string parameter named autoLayout to true when opening the workspace diagrams or Express page. You can do this by modifying the URL used by Puppeteer in the above scripts.