Check out our Theming documentation!
Backgrounds colors
Backgrounds are colors assigned to any container element, We classify a container as an element with textual content.
Some examples of background colors can be:
- The color of a Card
- The color of a Text Field
- The color of a Button (NOT ITS LABEL)
- The color of a Tooltip
- The color of a Tag
Identifying a background color
Background colors will always have background at the start of their name
Background color Palette
Interactive color
Interactive elements are those that can cause a reaction when clicked, such as Buttons or Segmented Controls.
Although links are considered an interactive element, they don’t possess a background color, only a foreground color.
Interactive elements and their states
Primary
Secondary
Tertiary
Ghost
Subtle
Danger
Containers colors
Pages vs elevated surfaces
Pages are the bottom-most layer of an interface, and surfaces displayed on top of it, like Cards, Widgets, or Modals, are considered Elevated surfaces.
Since elevated surfaces are often interactive, we have colors for each state and a color for the background of their header if needed.
Surface/edge color pairing
We highly recommend pairing a surface edge color according to the surface background colors, for example, if a card is using background/container/elevated/hover the edge of the surface should use border/container/edges/hover to match.
Read more about edge colors here.
Pages and elevated surfaces
Page
Elevated
High-contrast
As the name suggests, high contrast is used on elements that are needed to pop up in a sea of information, like a tooltip in a crowded dashboard.
Chat bubbles
We offer some chat bubble colors for specific chat users.
We highly recommend pairing these background colors with high-emphasis foreground colors for the text inside.
AI Features
We have two types of background gradients.
Tonal subtle — For elements that contain a decent body of text, like Cards.
Tonal medium — For elements that contain a few words, like Tags.
Text highlight
We also have a color for highlight a part of the text, useful when the high emphasis color won’t cut it.
This highlight can also be used over chat bubbles.
Form colors
Text-based inputs
We call the container of the input a track.
Click-based inputs
Click-based inputs can also possess a track, such as the track on a Toggle component.
System colors
Any element that transmits processes or system information to the user is considered a system element, like In-Line alerts, Tags, and Badges.
Feedback
We have 4 main types of feedback: informative, success, error, and warning.
Background/Border feedback color pairing
We highly recommend pairing a system/feedback border color according to the feedback background colors, for example, if an alert is using background/system/success/tonal_subtle the edge of the surface should use border/system/success to match.
Read more about system border colors here.
Feedback colors on an alert.
Agent Status
Status colors for agents are used on Avatars mostly.
Progress and loading
Since most of our loading components are shapes, we classify their colors as backgrounds.
Custom accents
Custom accents are used to identify categories, like Tags.