Docs

Design system

One look for every tour, tooltip, banner, announcement, checklist and survey on your site, in light and dark.

Your design system decides how guidance looks on your site. Edit it once and every item that uses it follows, without re-publishing.

Open it from Design system in the sidebar. Pick an element on the left (Tours, Tooltips, Banners, Announcements, Checklists, Surveys, Help launcher) to preview it on the canvas, and switch the preview between Light and Dark. The settings on the right apply to every element.

Settings

GroupWhat you set
SizeDefault width of the selected element. Banners: full width with side margins, or a fixed width
StyleStarting point (Clean or Soft) and font. Switching style resets the rest to that style
ColoursBackground, text, accent, text on accent and border, separately for light and dark
ShadowNone, small, medium, large, or a custom shadow (X, Y, blur, spread, colour, opacity)
CardCard corners and borders
ButtonsSize (medium or large), corners, and whether secondary buttons (Skip, Later) are text only or outlined

Save applies the changes. Cancel leaves without saving, after asking you to confirm.

Using it on an item

Tours, tooltips and banners have Use brand theme in their appearance step. It is on for new items and off for items created before the design system existed, so their look doesn't change. When it's on, choose the Theme mode (light or dark) for that item; its colours, corners, shadow, button size and width come from the design system.

Visitors see a change within a minute.

API, MCP and CLI

  • API: GET and PATCH /api/workspaces/current/brand-theme (see the API reference).
  • MCP: get_design_system and update_design_system (API keys only for changes). See MCP tools.
  • CLI: cueston design-system and cueston design-system update. See CLI.

On this page