Theme Playground reference

The Theme Playground is the editor where a colour theme is built. This page lists every control on the editor screen: the header buttons, the name and base theme fields, and all 31 colour pickers with what each one colours. Creating, applying, publishing and deleting a theme are described in Branding and themes.

Open the editor

  1. In the sidebar, click Admin, then open the Theme Configuration tab.
  2. Click Add theme for a new theme, or Edit on a theme card for an existing one.

The screen title reads Create theme on a new theme and Edit theme on an existing one.

The editor screen

The top bar holds the title and, next to it, the Theme name field. The action buttons sit at the top right. Below the bar the screen splits in two:

The preview is a static mock and nothing in it can be clicked. It shows a header tile, status badges, a sample dialog and confirmation, a Lake table popup, a workflow jobs table, chart tiles and a SQL editor, so you can check how the palette reads across the product before you save.

Header actions

ButtonWhat it does
Restore original colorsPuts every swatch back to the colours the theme started from. It appears only after you change at least one colour.
Publish / UnpublishPublishes the theme so other people can find it, or takes it back to private. It appears only while you edit an existing theme and your role allows publishing. Disabled while a save or a publish runs.
DeleteOpens the delete confirmation. It appears only while you edit an existing theme and your role allows removing it. Disabled while the delete runs.
CancelCloses the editor and discards the draft.
Save / Create & applySaves the theme and closes the editor on success. The button reads Create & apply on a new theme and Save on an existing one, and is disabled with a spinner while a save runs.

Name and base theme

The Theme name field sits next to the title; its placeholder reads Theme name. A theme cannot be saved without a name.

The Base theme section heads the left column. The picker's placeholder reads Base theme; open it to search. The search box reads Search themes..., and an empty result reads No themes found.

What each swatch colours

Each swatch is one picker. Open it to choose a colour, or type a value into the hex field under it. The swatches sit in six groups.

Surfaces

SwatchWhat it colours
Surface lowCards, sidebars, popovers and inputs.
Surface baseThe page canvas and the main content background.
Surface highElevated panels, table headers and hovered rows.

Text

SwatchWhat it colours
TextHeadings, labels and body copy.

Brand & emphasis

SwatchWhat it colours
Primary & actionsPrimary buttons, links, focus rings and the selected item in navigation.
SecondarySecondary actions and highlights in data views.
AccentHover states, subtle emphasis and decorative highlights.

Status

SwatchWhat it colours
SuccessCompleted states and positive badges.
ErrorError states, validation, alerts and delete or destructive actions.
WarningCaution states and running indicators.
InfoInformational badges and neutral status highlights.
PendingPending and in-progress status badges.

There is no separate colour for destructive actions: delete buttons and other destructive elements follow Error.

Chart colors

SwatchWhat it colours
Chart 1 to Chart 12Data visualisations, avatars and pickers. All twelve slots can be changed.

Editor colors

SwatchWhat it colours
AliasesPredefined names and aliases in SQL editors.
TypesType names such as INT and VARCHAR in SQL editors.
QuotesQuoted strings and identifiers in SQL editors.
NumberNumeric literals in SQL editors.
CommentComments in SQL editors.
OperatorOperators such as +, - and = in SQL editors.
KeywordsReserved keywords such as SELECT and FROM in SQL editors.

Saving and messages

When a save succeeds, the editor closes and your theme becomes the one you are using. If a save cannot go through, the message says why:

Two behaviours are worth knowing:

Other messages from this area are listed in Administration troubleshooting.

Questions, answered

What does each swatch in the editor change?

Each swatch sets one colour of the palette. The tables above list all of them by group; a swatch affects every part of the interface that uses its colour, so one pick can show up in several places.

How many chart colours does a theme have?

Twelve, Chart 1 to Chart 12. They colour data visualisations, avatars and pickers, and all twelve can be changed.

Can I set the colour of delete buttons separately?

No. There is no separate picker for destructive actions; delete buttons and other destructive elements take the Error colour.

Can I change the SQL editor colours?

Yes. The Editor colors group holds seven swatches: Aliases, Types, Quotes, Number, Comment, Operator and Keywords. The preview panel includes a SQL sample so you can check them.

What is the difference between Base theme and the Light and Dark buttons?

Base theme lists every palette you can start from: the built-in palettes, your own themes and themes other people published. Choosing one loads its colours into the swatches. Light and Dark choose which built-in DataMind OS palette the theme starts from.

Why can't I see the app preview?

The preview needs a wide screen: the editor shows it beside the controls when there is room, and hides it in a narrow window. Your colours apply the same way either way; you just do not see the preview while the window is small.

What does Restore original colors do?

It puts every swatch back to the colours the theme started from. The button appears only after you change at least one colour.

Why is Save greyed out?

A save is running; the button shows a spinner and comes back when the save finishes. Publish and Delete are disabled the same way while their own action runs.

Why was my theme not saved?

Read the message: Name required means the name field is empty, Could not build palette means a colour pick is not valid, and any other failure shows Could not save with the reason under it. Fix what the message names and save again.

Do my changes appear in the app before I save?

No. Until you save, your picks show only in the preview panel. When the save succeeds, the editor closes and the theme is applied to your interface. See Branding and themes for applying and switching themes.