Beauty Diagram
Diagram type

PlantUML swimlane diagram beautifier

Render PlantUML swimlanes as side-by-side columns with per-lane colour, crisp L-shape cross-lane edges, and theme-matched palettes — ready to drop into a PRD, runbook, or process review.

Use this page to connect a high-intent search query to the right problem-solution narrative.

At a glance

A swimlane page for PMs, business analysts, SREs, and ops teams whose process diagrams need a clear owner per column.

What a swimlane diagram is forHow Beauty Diagram renders PlantUML swimlanesTheme-matched lane palettesBranching inside lanes still works
Rendered proof
Order fulfilment across Customer, Order System, Warehouse, and Logistics lanes.
Theme · Atlas
Open this diagram in editor
Customer Order System Warehouse Logistics Start Place order & pay Reserve stock &create order Pick & pack Pick up & deliver Sign for delivery Close order &request rating Stop
View PlantUML sourcePlain-text diagram syntax — copy or edit directly.
diagram.puml
1@startuml
2|#FFE4B5|Customer|
3start
4:Place order & pay;
5|#B0E0E6|Order System|
6:Reserve stock & create order;
7|#FFB6C1|Warehouse|
8:Pick & pack;
9|#90EE90|Logistics|
10:Pick up & deliver;
11|Customer|
12:Sign for delivery;
13|Order System|
14:Close order & request rating;
15stop
16@enduml

What a swimlane diagram is for

Swimlanes split a process into vertical columns — one per team, role, or system — so every step is anchored to its owner. The visual answer to who-does-what is built into the layout itself, which is why PMs reach for swimlanes whenever a flow involves cross-team handoffs.

  • PRD user flows — Customer / Frontend / Backend / Third-party
  • Approval chains — Requester / Manager / Finance
  • Order fulfilment — Customer / Order System / Warehouse / Logistics
  • Incident runbooks — Monitoring / On-call / SRE Lead / Customer Support

How Beauty Diagram renders PlantUML swimlanes

PlantUML's `|Name|` and `|#Color|Name|` syntax become real horizontal lane columns. The layout snaps every node to the centre of its lane, the lanes touch with shared inner borders (no awkward gaps), and cross-lane handoffs route as crisp L-shapes — south-exit, traverse, north-enter — instead of bezier S-curves.

  • Equal-width columns in source declaration order
  • Outer corners rounded, inner seams flush
  • Cross-lane edges go orthogonal automatically when the diagram is classified as swimlane-flow

Theme-matched lane palettes

Each visual theme ships a tailored lane palette so colour stays readable against the canvas. Light themes get the pastel default. Obsidian and Slate use a dark-muted preset with bright accent strokes. Brutalist uses high-saturation pop blocks with hard black borders. Memphis swaps to its signature yellow-led colour story with cream tag pills. Blueprint goes monochrome and prefixes lanes with `01` `02` section numbers — and Atelier translates everything into warm earth tones (terracotta, ochre, olive, dust-rose) so the diagram feels editorial.

Branching inside lanes still works

Nested `if/else`, `switch/case`, and `repeat` constructs continue to behave inside a swimlane. The pattern detector treats explicit `|lane|` declarations as the strongest signal — even a complex approval chain with multiple decision points stays in the swimlane layout instead of being downgraded to a generic flow.

FAQ

PlantUML swimlane diagram beautifier — frequently asked questions

Which roles get the most out of swimlane diagrams?

Product managers writing PRDs, business analysts mapping AS-IS / TO-BE processes, solution architects documenting cross-service flows, QA leads sketching end-to-end test scenarios, SREs writing incident runbooks, and operations teams working on customer journeys all reach for swimlanes whenever the question is who-does-what at each step.

Does PlantUML support horizontal swimlanes?

PlantUML's native syntax only expresses vertical-column lanes. Beauty Diagram follows that convention — lanes always render as columns, with the flow moving top-to-bottom inside each lane and jumping horizontally between them.

Can I supply my own lane colours?

Yes. The `|#Color|Name|` form accepts both PlantUML's named colours (`#LightBlue`, `#Pink`, `#FFE4B5`...) and arbitrary hex (`#A8D8EA`). Named colours map to a curated theme-aware tone; arbitrary hex is mixed toward the active theme's tonal target so the result still reads against the canvas.

What if my diagram has lots of branches?

Internal branching does not affect lane assignment. The pattern detector treats explicit `|lane|` declarations as the strongest signal, so a complex approval chain with nested `if/else` still renders as a swimlane — every activity stays inside the lane it was declared in.