Skip to main content

Background Tokens

When discussing color tokens, we need to distinguish backgrounds and content colors (texts). Feel free to jump to Foreground Color Tokens if you're looking for text and icon colors, however, this section is much easier to understand when first familiarizing yourself with colors tokens. That's why we recommend starting here.

Prerequisites

In this section assumes that you are already familiar with the concept of Intents, Attentions, and States explained in the Color Tokens section.

Naming Convention

background.<intent>.<attention>.<state>

To create background color tokens we combine three aspects: intent, attention, and state. Each intent creates a combination with all attention and state levels, resulting in a complete set of background color tokens that can be applied to specific UI components.

Not every application will need all combinations, so choose the ones that best fit your use cases.

Where is blending?

Blending levels would add another dimension to the combinations which we currently decided to avoid for background tokens. Later we will discuss using blending on the component level as needed.

Default Background Tokens

warning

The following set of tokens represent the default combinations that should cover most use cases in our design system. No values are strictly enforced here, however, we recommend using these as a starting point for your products.

Pick Intent Token:

Intent: neutral, attention: base

Token namelightdark
background.neutral.base.default#ffffff#000000
background.neutral.base.hovered#e3ddd3#4c473f
background.neutral.base.pressed#c2bdb3#67635a
background.neutral.base.selected#d3cdc3#3e3a32

Intent: neutral, attention: low

Token namelightdark
background.neutral.low.default#d3cdc3#59554c
background.neutral.low.hovered#b3ada4#858076
background.neutral.low.pressed#948e85#a39e94
background.neutral.low.selected#a39e94#948e85

Intent: neutral, attention: medium

Token namelightdark
background.neutral.medium.default#b3ada4#948e85
background.neutral.medium.hovered#948e85#b3ada4
background.neutral.medium.pressed#767168#d3cdc3
background.neutral.medium.selected#858076#c2bdb3

Intent: neutral, attention: high

Token namelightdark
background.neutral.high.default#948e85#b3ada4
background.neutral.high.hovered#b3ada4#948e85
background.neutral.high.pressed#d3cdc3#767168
background.neutral.high.selected#c2bdb3#858076

Intent: neutral, attention: strong

Token namelightdark
background.neutral.strong.default#59554c#d3cdc3
background.neutral.strong.hovered#858076#b3ada4
background.neutral.strong.pressed#a39e94#948e85
background.neutral.strong.selected#948e85#a39e94

Intent: neutral, attention: full

Token namelightdark
background.neutral.full.default#000000#ffffff
background.neutral.full.hovered#4c473f#e3ddd3
background.neutral.full.pressed#67635a#c2bdb3
background.neutral.full.selected#3e3a32#d3cdc3

Up Next


Foreground Color Tokens

Content color tokens define colors for text, icons, and other foreground elements.

Foreground Color Tokens ->

Border Color Tokens

Border color tokens define the colors used for borders and dividers.

Border Color Tokens ->

Defining Intents

Defining intents allows you to tailor color tokens to better fit your product's unique requirements.

Defining Intents ->