Skip to content

Themes and fonts ​

The default look is the MiraStack Labs brand: Oswald for display text, JetBrains Mono for technical text, a white or near-black base, neutral ink/grey solids with teal accents, and an iso ground grid in the brand line colour. Orange (#ff671f, the brand signal colour) is reserved for emphasis: the highlighted state and power flows and cables.

Themes ​

ThemeSchemeNotes
lightlightBrand light: #ffffff base, #e4e2dc grid, teal #00695f
darkdarkBrand dark: #0a0a0a base, #272727 grid, teal #2bd4bf
blueprintdarkBlue drafting look; brand fonts, its own colours
monolightGreyscale; brand fonts

Set one with canvas.theme in the spec or --theme on the CLI. A custom theme file is validated by validateTheme; font.family (display) is required and font.mono (technical text) is optional and falls back to font.family.

Grid ​

canvas.grid defaults to true: the iso ground grid is drawn in the theme's grid colour. Set "grid": false for a plain background.

Fonts ​

RoleFamilyFaces
Node labels, group pills, titles, legend, step captionsOswald400, 500 (node labels), 600 (bold)
Badges, metric labels and values, edge labelsJetBrains Mono400, 700 (bold)

Both are SIL OFL 1.1, bundled as Latin subsets (packages/core/assets/fonts/PROVENANCE.txt). --font modes:

  • embed (default): one WOFF2 subset per family and weight, containing only the glyphs the diagram uses.
  • outline: text becomes paths, using the same two families.
  • system: no font data; the theme stacks apply (Oswald, "Arial Narrow", Arial, sans-serif and "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace).

PNG, GIF and MP4 export load both faces, so raster output matches the SVG. Oswald has no arrow glyphs (→): such characters are drawn, measured and embedded with JetBrains Mono, and raster output outlines those labels so all targets match. render/missing-glyph warns only when neither face has the character. Label, badge, metric, caption and legend sizes grow with the scene width (about width / 100 px, up to 2.2x) so wide diagrams stay legible when shown small.

Node category colours (light / dark) ​

Teal is the primary family, neutral ink and greys fill the rest; no category uses orange.

CategoryLightDarkReads as
compute#00695f#14867abrand teal
network#4fb3a8#2bd4bflight teal
data#3a3a3a#555555charcoal
client#b9b7b0#a0a0a0light warm grey
observability#7a7a76#747474mid grey
cicd#1f8f82#4fa89dmedium teal
security#0a0a0a#d9d9d9ink (white in dark)
ai#2f5f5a#2f7d74dark slate teal
dc#a4aaa6#8a928ecool grey

State colours: degraded is a signal-orange outline with an orange tint, down red, highlighted an ink (light) or white (dark) outline. heavy flows are signal orange (#fa5f14 on light, where #ff671f is just under 3:1 on white); power flows are amber and power cables are a lighter (light theme) or darker (dark theme) amber so the particles stay visible on them. Degraded nodes and heavy particles both use signal orange; they stay apart by shape (an outlined, tinted solid versus small moving dots).

Apache-2.0. AWS, Azure, Google Cloud, Kubernetes and the brands in Simple Icons are trademarks of their owners; use does not imply endorsement.