structurizr-export: Adds the addSkinParam() method back to the PlantUML exporters.

Author: simonbrowndotje

changelog.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## v5.0.3 (21st November 2025)
+
+- structurizr-export: Adds the `addSkinParam()` method back to the PlantUML exporters. 
+
 ## v5.0.2 (9th November 2025)
 
 - structurizr-client: Adds a `getWorkspaceAsJson()` to `WorkspaceApiClient`.

gradle.properties

@@ -5,4 +5,4 @@ signing.secretKeyRingFile=/some/path
 ossrhUsername=username
 ossrhPassword=password
 
-version=5.0.2
+version=5.0.3

structurizr-export/src/main/java/com/structurizr/export/plantuml/AbstractPlantUMLExporter.java

@@ -14,6 +14,10 @@
 import javax.imageio.ImageIO;
 import java.awt.image.BufferedImage;
 import java.net.URL;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import static java.lang.String.format;
 
 public abstract class AbstractPlantUMLExporter extends AbstractDiagramExporter {
 
@@ -27,6 +31,20 @@ public abstract class AbstractPlantUMLExporter extends AbstractDiagramExporter {
     public static final String DIAGRAM_TITLE_TAG = "Diagram:Title";
     public static final String DIAGRAM_DESCRIPTION_TAG = "Diagram:Description";
 
+    private final Map<String, String> skinParams = new LinkedHashMap<>();
+
+    protected Map<String, String> getSkinParams() {
+        return skinParams;
+    }
+
+    public void addSkinParam(String name, String value) {
+        skinParams.put(name, value);
+    }
+
+    public void clearSkinParams() {
+        skinParams.clear();
+    }
+
     public AbstractPlantUMLExporter() {
         this(ColorScheme.Light);
     }
@@ -208,6 +226,21 @@ protected void writeHeader(ModelView view, IndentingWriter writer) {
         writer.writeLine("set separator none");
     }
 
+    protected void writeSkinParams(IndentingWriter writer) {
+        if (!skinParams.isEmpty()) {
+            writer.writeLine();
+            writer.writeLine("skinparam {");
+            writer.indent();
+            for (final String name : skinParams.keySet()) {
+                writer.writeLine(format("%s %s", name, skinParams.get(name)));
+            }
+            writer.outdent();
+            writer.writeLine("}");
+        }
+
+        writer.writeLine();
+    }
+
     protected void writeIncludes(ModelView view, IndentingWriter writer) {
         String commaSeparatedIncludes = getViewOrViewSetProperty(view, PLANTUML_INCLUDES_PROPERTY, "");
         if (!StringUtils.isNullOrEmpty(commaSeparatedIncludes)) {

structurizr-export/src/main/java/com/structurizr/export/plantuml/C4PlantUMLExporter.java

@@ -76,7 +76,8 @@ protected void writeHeader(ModelView view, IndentingWriter writer) {
             }
         }
 
-        writer.writeLine();
+        writeSkinParams(writer);
+
         writer.writeLine("<style>");
         writer.indent();
 

structurizr-export/src/main/java/com/structurizr/export/plantuml/StructurizrPlantUMLExporter.java

@@ -60,7 +60,8 @@ protected void writeHeader(ModelView view, IndentingWriter writer) {
         }
 
         writer.writeLine("hide stereotype");
-        writer.writeLine();
+
+        writeSkinParams(writer);
 
         writer.writeLine("<style></style>");
         writer.writeLine();

structurizr-export/src/test/java/com/structurizr/export/plantuml/C4PlantUMLDiagramExporterTests.java

@@ -1755,4 +1755,44 @@ public void elementWithUrl() {
                 @enduml""", diagram.getDefinition());
     }
 
+    @Test
+    void skinparams() {
+        Workspace workspace = new Workspace("Name", "Description");
+        workspace.getModel().addSoftwareSystem("A");
+
+        SystemLandscapeView view = workspace.getViews().createSystemLandscapeView("key");
+        view.addAllElements();
+
+        C4PlantUMLExporter exporter = new C4PlantUMLExporter();
+        exporter.addSkinParam("linetype", "ortho");
+        Diagram diagram = exporter.export(view);
+
+        assertEquals("""
+                @startuml
+                title <size:24>System Landscape View</size>
+                
+                set separator none
+                top to bottom direction
+                
+                skinparam {
+                  linetype ortho
+                }
+                
+                <style>
+                  root {
+                    BackgroundColor: #ffffff
+                    FontColor: #444444
+                  }
+                </style>
+                
+                !include <C4/C4>
+                !include <C4/C4_Context>
+                
+                System(A, "A", $descr="", $tags="", $link="")
+                
+                SHOW_LEGEND(true)
+                hide stereotypes
+                @enduml""", diagram.getDefinition());
+    }
+
 }

structurizr-export/src/test/java/com/structurizr/export/plantuml/StructurizrPlantUMLDiagramExporterTests.java

@@ -4216,4 +4216,52 @@ public void amazonWebServicesExample_Dark() throws Exception {
                 @enduml""", diagram.getLegend().getDefinition());
     }
 
+    @Test
+    void skinparams() {
+        Workspace workspace = new Workspace("Name", "Description");
+        workspace.getModel().addSoftwareSystem("A");
+
+        SystemLandscapeView view = workspace.getViews().createSystemLandscapeView("key");
+        view.addAllElements();
+
+        StructurizrPlantUMLExporter exporter = new StructurizrPlantUMLExporter();
+        exporter.addSkinParam("linetype", "ortho");
+        Diagram diagram = exporter.export(view);
+
+        assertEquals("""
+                @startuml
+                title <size:24>System Landscape View</size>
+                
+                set separator none
+                top to bottom direction
+                hide stereotype
+                
+                skinparam {
+                  linetype ortho
+                }
+                
+                <style>
+                  root {
+                    BackgroundColor: #ffffff;
+                    FontColor: #444444;
+                  }
+                  // Element
+                  .Element-RWxlbWVudA== {
+                    BackgroundColor: #ffffff;
+                    LineColor: #444444;
+                    LineStyle: 0;
+                    LineThickness: 2;
+                    FontColor: #444444;
+                    FontSize: 24;
+                    HorizontalAlignment: center;
+                    Shadowing: 0;
+                    MaximumWidth: 450;
+                  }
+                </style>
+                
+                rectangle "==A\\n<size:16>[Software System]</size>" <<Element-RWxlbWVudA==>> as A
+                
+                @enduml""", diagram.getDefinition());
+    }
+
 }