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

important

The following set of tokens represent the default options 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#322d26
background.neutral.low.hovered#b3ada4#59554c
background.neutral.low.pressed#948e85#767168
background.neutral.low.selected#a39e94#67635a

Intent: neutral, attention: medium

Token namelightdark
background.neutral.medium.default#a39e94#59554c
background.neutral.medium.hovered#858076#767168
background.neutral.medium.pressed#67635a#948e85
background.neutral.medium.selected#767168#858076

Intent: neutral, attention: high

Token namelightdark
background.neutral.high.default#767168#767168
background.neutral.high.hovered#948e85#59554c
background.neutral.high.pressed#b3ada4#3e3a32
background.neutral.high.selected#a39e94#4c473f

Intent: neutral, attention: strong

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

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 ->