Skip to main content

Interface: ThemeConfig

Theme configuration object for customizing stage canvas, typography, surfaces, and colors. All properties are optional and strictly typed.

Properties​

PropertyTypeDescription
background?stringStage canvas background color or CSS gradient.
fontMono?stringMonospace font family.
fontSans?stringSans-serif font family.
fontSerif?stringSerif font family.
fontSizeBody?stringBody paragraph typography scale.
fontSizeCode?stringCode snippet typography scale.
fontSizeHero?stringHero title typography scale.
fontSizeKicker?stringKicker label typography scale.
fontSizeLead?stringLead paragraph typography scale.
fontSizeTitle?stringTitle typography scale.
primary?stringPrimary accent color. Inherits from the surrounding theme.
radius?stringBase border radius (e.g. "12px").
secondary?stringSecondary accent color. Inherits from the surrounding theme.
space2xs?stringDouble-extra-small spacing token.
space3xs?stringTriple-extra-small spacing token.
spaceLg?stringLarge spacing token.
spaceMd?stringMedium spacing token.
spaceSm?stringSmall spacing token.
spaceXl?stringExtra-large spacing token.
spaceXs?stringExtra-small spacing token.
surface?stringComponent surface background color.
surfaceBackdrop?stringBackdrop overlay behind elevated layers.
surfaceBorderColor?stringSurface border color (default: text at 15% opacity).
surfaceBorderWidth?stringSurface border width as a CSS length (default: "1px").
surfaceHighlight?stringSubtle surface highlight color.
surfaceShadow?stringBox shadow applied to raised surfaces.
surfaceSolid?stringOpaque surface background (default: "#18181b").
surfaceSubtle?stringSubtle media backdrop (default: "#1e293b").
text?stringPrimary text color.
textDim?stringDim tertiary text color.
textMuted?stringMuted secondary text color.