Theme

A theme controls how dashboards look: chart colors, fonts and the surfaces behind charts, tables, markdown and inputs. Visivo ships a built-in light and dark theme; a project theme overrides individual tokens of either.

Tokens set at the top level apply to both modes. Tokens under light or dark apply only to that mode and win over the shared ones. A chart's own layout always wins over the theme.

theme:
  mode: auto
  font_family: "Inter, system-ui, sans-serif"
  colorway: ["#0a9396", "#d25946", "#5b4bab", "#4f9a3f"]
  light:
    accent: "#2d6a6f"
  dark:
    background: "#121527"
    plotly_layout:
      geo:
        showocean: true

Attributes

Field	Type	Default	Description
mode	string	light	The mode dashboards open in. auto follows the viewer's operating system setting.
allow_viewer_toggle	boolean	True	Show the light / dark / auto switch on dashboards so viewers can pick their own mode.
colorway	Any of: string, array	None	Series colors, assigned to traces in order. Either a list of colors or the name of a predefined palette.
font_family	string	None	CSS font stack used by charts, tables and markdown.
font_size	integer	None	Base font size in pixels for chart text.
background	string	None	Page background behind dashboard items. Hex color, e.g. #1d2136.
surface	string	None	Background of charts, tables and other dashboard cards. Hex color, e.g. #1d2136.
text	string	None	Primary text color. Hex color, e.g. #1d2136.
muted_text	string	None	Secondary text, axis ticks and labels. Hex color, e.g. #1d2136.
border	string	None	Card borders and axis lines. Hex color, e.g. #1d2136.
grid	string	None	Chart gridlines. Hex color, e.g. #1d2136.
accent	string	None	Highlight color for selected inputs, gauges and table hover rows. Hex color, e.g. #1d2136.
plotly_layout	Layout	None	Plotly layout properties merged into every chart's template. A chart's own layout still takes precedence.
light	ThemeTokens	None	Tokens used only in light mode.
dark	ThemeTokens	None	Tokens used only in dark mode.