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.500describe a specific shade. - Semantic roles such as
surface2,text, andborderdescribe the job a color performs.
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.neutral50
#f6f7f8
100
#f1f1f4
200
#e3e3e8
300
#d4d5dd
400
#b8b9c7
500
#7e829a
600
#4f5164
700
#383a47
800
#22232b
900
#16171d
blue
colors.blue50
#f0f6ff
100
#dbeafe
200
#c0dbfe
300
#a3cfff
400
#61a6fb
500
#3b83f6
600
#2663eb
700
#173da6
800
#13204a
900
#0b142e
green
colors.green50
#f1fdf4
100
#dcfce8
200
#bcf8d0
300
#86f0ad
400
#4bde80
500
#22c55f
600
#17a34a
700
#106a32
800
#032713
900
#03180c
yellow
colors.yellow50
#fefce8
100
#fef9c3
200
#fef18b
300
#fde047
400
#facc14
500
#ebb30b
600
#ca8a03
700
#845208
800
#432005
900
#281304
red
colors.red50
#fef3f2
100
#ffe2e3
200
#fecaca
300
#fda5a5
400
#f97171
500
#ef4444
600
#dc2627
700
#9a1919
800
#300c0c
900
#1f0808