Skip to content

Design System

The Draw.io design system gives the skill a stable visual vocabulary across engineering, academic, and presentation diagrams.

Core Concepts

Profiles

ProfilePurpose
defaultStandard diagrams
academic-paperIEEE, thesis, journal, and paper-ready figures
engineering-reviewDense architecture or network diagrams with stricter routing review

6 Built-In Themes

ThemeBest for
tech-blueSoftware architecture, DevOps, general technical diagrams
academicGrayscale-safe papers and IEEE figures
academic-colorColor paper figures and research presentations
natureLifecycle, biology, environment, sustainability
darkSlides and presentation assets
high-contrastAccessibility-first and maximum legibility

Semantic Node Types

TypeShape
serviceRounded rectangle
databaseCylinder
decisionDiamond
terminalStadium
queueParallelogram
userEllipse
documentDocument
formulaRectangle tuned for math content

Typed Connectors

TypePurpose
primaryMain flow
dataData or async flow
optionalWeak relation
dependencyDependency annotation
bidirectionalMutual relationship

8px Grid Defaults

  • node spacing: 32px
  • module padding: 24px
  • canvas padding: 32px

Theme Switching

Change the theme in the spec and re-render. Token-based styles will follow the new theme automatically.

Explicit color overrides do not change when the theme changes.

Replication Color Modes

ModeMeaning
preserve-originalKeep extracted source colors as explicit overrides
theme-firstNormalize the redraw to the selected theme

Academic Notes

For academic-paper output:

  • prefer academic unless the user explicitly wants color
  • include title and, when needed, a legend
  • avoid using color as the only semantic carrier

Custom Themes

Custom themes are JSON files that extend the theme schema. At minimum, define:

  • name
  • displayName
  • colors
  • spacing
  • typography
  • node
  • connector
  • module
  • canvas

See the reference docs under skills/drawio/references/docs/design-system/.

Draw.io Skill v2.2.0 documentation.