This version of Structurizr allows you to view/edit diagrams, view documentation, and view architecture decision records defined in a single DSL or JSON workspace. Structurizr Lite can be used standalone for workspace viewing/authoring, or in conjunction with the cloud service/on-premises installation as an authoring/testing/staging environment.
Structurizr Lite will look for a workspace.dsl
and workspace.json
file in a given directory, in that order, and use the file it finds first.
If you change this file (e.g. via your text editor or one of the Structurizr client libraries), you can refresh your web browser to immediately see the changes.
To build and run from source, you'll need:
-
Java 17+ (required)
-
Graphviz (optional; if you want to use automatic layout)
-
Note 1: The HTML, JS, CSS, JSP, etc files are in a separate structurizr/ui repo because they are shared with the on-premises installation and cloud service.
-
Note 2: Building and running from source has only been tested with Java 17.
To build from source:
git clone https://github.com/structurizr/lite.git structurizr-lite
git clone https://github.com/structurizr/ui.git structurizr-ui
cd structurizr-lite
./ui.sh
./gradlew build
And to run Structurizr Lite (this has only been tested with Java 17):
java -jar build/libs/structurizr-lite.war /path/to/workspace
- Replace
/path/to/workspace
with the path to the folder where yourworkspace.dsl
file is.