Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cube.dev/llms.txt

Use this file to discover all available pages before exploring further.

The app theme controls the brand appearance of Cube — the accent color, background and text colors, logo, and fonts. You pick a handful of colors per color scheme and Cube generates a complete, accessible light and dark palette from them. By default the app theme brands embedded surfaces (Creator Mode, published dashboards, and embedded chat) so they match your product. You can also turn it on for the entire Cube Cloud console so everyone in your account sees your branding.

Requirements

Configuring the app theme requires the Admin role. The theme is account-wide: there is a single app theme per account, and changes apply to every deployment in it.
The app theme is distinct from dashboard themes, which style individual dashboards (backgrounds, widget cards, borders). The app theme sets your account’s overall brand; dashboard themes are a narrower override.

What you can customize

The app theme is configured for two color schemes — Light and Dark — plus shared Typography.
SectionWhat it controls
Accent colorYour primary brand color. Cube derives the full palette (buttons, links, active states, highlights) from its hue and saturation.
Background colorThe main surface and page background.
Foreground colorThe primary text color.
ContrastA 0–100 control (45 is neutral) for how strongly the generated palette separates surfaces and text. Higher values increase contrast.
LogoThe mark shown in the navigation header.
TypographyThe web fonts used for body and heading text (shared across both schemes).
You only choose the accent, background, and foreground colors — Cube generates every other token (borders, muted text, success/danger states, hover and active variants) for both light and dark mode, keeping contrast accessible automatically.

Configure the theme

Go to Admin → Customization → App Theme. The page has a Light theme and a Dark theme editor on the left and a live preview on the right.
1

Set the colors

For each scheme, pick the Accent, Background, and Foreground colors and adjust the Contrast slider. The preview updates as you edit.
2

Add your logo

Paste an HTTPS URL to your logo image (see Logo below).
3

Configure fonts

Add one or more web fonts and choose which to use for body and heading text (see Fonts below).
4

Preview

Use the Light / Auto / Dark toggle above the preview to check both schemes. Auto follows your current OS/app appearance.
5

Save

Click Save. To start over, use Restore defaults (and Revert to undo a restore before saving).
The logo is referenced by URL and must be served over HTTPS. Use a small, square mark (around 24×24) in PNG, SVG, or JPG format — it renders in the navigation header. If you set a logo only for the light scheme, it is reused in dark mode unless you set a dark-mode logo as well.

Fonts

Fonts are shared across the light and dark schemes. You register one or more fonts, then choose which font and weight to use for body and heading text. You can add a font in two ways:
  • A direct font file — an HTTPS URL ending in a font file: woff2, woff, ttf (TrueType), or otf (OpenType).
  • A CSS stylesheet — an HTTPS URL to a CSS file containing @font-face declarations (for example, a Google Fonts stylesheet link). A single stylesheet can register multiple font families at once.
1

Add a font

In the Typography section, paste the font or stylesheet URL and add it. Cube validates the URL and reads the font’s metadata; a stylesheet may register several families in one step.
2

Assign body and heading fonts

Choose a font from your registry for Body and for Heading text, and set the font weight for each.
Font URLs must be HTTPS and publicly reachable. Cube fetches the font to validate it; private, non-HTTPS, or oversized files are rejected.

Where the theme is applied

Embedded surfaces

When configured, the app theme automatically brands your embedded experiences — the Creator Mode app, published dashboards, and embedded chat — including overlays such as dialogs and menus. No extra configuration is required beyond saving the theme.

Across Cube Cloud

Turn on Apply across Cube Cloud (the switch at the top of the App Theme page) to apply the same theme to the entire authenticated Cube Cloud console — the sidebar, pages, and overlays — for every user in the account.
  • It takes effect immediately for all users on their next load.
  • It respects each user’s light/dark preference, switching schemes accordingly.
  • Unauthenticated pages (such as sign-in) keep Cube’s default appearance.
Turn the switch off to return the console to Cube’s default look while keeping your embedded surfaces branded.