Skip to content
Browse documentation
whisk/ui

Colors

Explore the list of available default whisk/ui color families.

Color model

Whisk/UI provides primitive palette values and semantic color roles. Use primitive colors when you need a specific shade. Use semantic roles in components so the same interface can adapt when its theme changes.

  • Palette values such as blue.500 describe a specific shade.
  • Semantic roles such as surface2, text, and border describe the job a color performs.
Text color aliases

On Text and Heading, color="subtle" resolves to the textSubtle theme token. Use textSubtle when configuring or referring to the token itself.

Use semantic colors

Start with semantic roles for product UI. The active theme resolves them for its color mode and keeps related surfaces, text, borders, and statuses coherent.

Billing details

Your next invoice is ready to review.

import { Box, Text } from "@smoothie-framework/whisk-react";

<Box background="surface2" border="sm" borderColor="borderSubtle" rounded="lg" padding={4}>
  <Text textStyle="caption" color="text">Billing details</Text>
  <Text textStyle="body" color="subtle">Your next invoice is ready to review.</Text>
</Box>

Surfaces

background

light: var(--smth-colors-neutral-50)

dark: var(--smth-colors-neutral-900)

surface1

light: var(--smth-colors-neutral-100)

dark: var(--smth-colors-neutral-800)

surface2

light: var(--smth-colors-neutral-200)

dark: var(--smth-colors-neutral-700)

surface3

light: var(--smth-colors-neutral-300)

dark: var(--smth-colors-neutral-600)

Accent

accent

light: var(--smth-colors-neutral-800)

dark: var(--smth-colors-neutral-100)

accentSubtle

light: var(--smth-colors-neutral-700)

dark: var(--smth-colors-neutral-200)

accentEmphasized

light: var(--smth-colors-neutral-900)

dark: var(--smth-colors-neutral-50)

accentMuted

light: var(--smth-colors-neutral-300)

dark: var(--smth-colors-neutral-600)

Text

text

light: var(--smth-colors-neutral-900)

dark: var(--smth-colors-neutral-50)

textSubtle

light: var(--smth-colors-neutral-700)

dark: var(--smth-colors-neutral-300)

textDisabled

light: var(--smth-colors-neutral-500)

dark: var(--smth-colors-neutral-500)

textInverse

light: var(--smth-colors-neutral-50)

dark: var(--smth-colors-neutral-900)

Borders

borderSubtle

light: var(--smth-colors-neutral-300)

dark: var(--smth-colors-neutral-700)

border

light: var(--smth-colors-neutral-400)

dark: var(--smth-colors-neutral-600)

borderStrong

light: var(--smth-colors-neutral-500)

dark: var(--smth-colors-neutral-500)

borderFocus

light: var(--smth-colors-accent)

dark: var(--smth-colors-accent)

Success

success

light: var(--smth-colors-green-500)

dark: var(--smth-colors-green-400)

successSubtle

light: var(--smth-colors-green-400)

dark: var(--smth-colors-green-500)

successEmphasized

light: var(--smth-colors-green-600)

dark: var(--smth-colors-green-300)

successMuted

light: var(--smth-colors-green-100)

dark: var(--smth-colors-green-800)

Warning

warning

light: var(--smth-colors-yellow-500)

dark: var(--smth-colors-yellow-400)

warningSubtle

light: var(--smth-colors-yellow-400)

dark: var(--smth-colors-yellow-500)

warningEmphasized

light: var(--smth-colors-yellow-600)

dark: var(--smth-colors-yellow-300)

warningMuted

light: var(--smth-colors-yellow-100)

dark: var(--smth-colors-yellow-800)

Error

error

light: var(--smth-colors-red-600)

dark: var(--smth-colors-red-400)

errorSubtle

light: var(--smth-colors-red-500)

dark: var(--smth-colors-red-500)

errorEmphasized

light: var(--smth-colors-red-700)

dark: var(--smth-colors-red-300)

errorMuted

light: var(--smth-colors-red-100)

dark: var(--smth-colors-red-800)

Info

info

light: var(--smth-colors-blue-500)

dark: var(--smth-colors-blue-400)

infoSubtle

light: var(--smth-colors-blue-400)

dark: var(--smth-colors-blue-500)

infoEmphasized

light: var(--smth-colors-blue-600)

dark: var(--smth-colors-blue-300)

infoMuted

light: var(--smth-colors-blue-100)

dark: var(--smth-colors-blue-800)

Color ramps

Palette values are specific shades. Use them when defining a theme or when a specific shade is part of the application’s own visual language. Verify contrast whenever you introduce or remap a color pair.

Smoothie supports the following color tokens out of the box. Use them when you need a specific shade.

neutral

colors.neutral

50

#f6f7f8

100

#f1f1f4

200

#e3e3e8

300

#d4d5dd

400

#b8b9c7

500

#7e829a

600

#4f5164

700

#383a47

800

#22232b

900

#16171d

blue

colors.blue

50

#f0f6ff

100

#dbeafe

200

#c0dbfe

300

#a3cfff

400

#61a6fb

500

#3b83f6

600

#2663eb

700

#173da6

800

#13204a

900

#0b142e

green

colors.green

50

#f1fdf4

100

#dcfce8

200

#bcf8d0

300

#86f0ad

400

#4bde80

500

#22c55f

600

#17a34a

700

#106a32

800

#032713

900

#03180c

yellow

colors.yellow

50

#fefce8

100

#fef9c3

200

#fef18b

300

#fde047

400

#facc14

500

#ebb30b

600

#ca8a03

700

#845208

800

#432005

900

#281304

red

colors.red

50

#fef3f2

100

#ffe2e3

200

#fecaca

300

#fda5a5

400

#f97171

500

#ef4444

600

#dc2627

700

#9a1919

800

#300c0c

900

#1f0808