Colors
Each color slot takes one seed; the engine derives the rest. From a base color it builds the
.dark,
.light, .action and .active steps in a perceptually uniform space, so "darker" looks darker even for
saturated oranges and greens, with no manual tuning.Theming
Color groups
- Brand —
main,opposite,complementary: the identity of the product. The stockoppositeis the hue opposite of the stockmain, so set it whenever you changemain. - Contrast —
baseLight,baseDark,deepLight,deepDark: the anchors of the light/dark duotone.baseLightis the light page canvas; the canonical dark swap exchangesbaseLight↔baseDarkanddeepLight↔deepDark. - Function —
primary,secondary,tertiary: actions and interactive emphasis. - Response —
success,information,warning,danger: feedback states. - Tonality — the
neutralandgrayscaleramps, derived for depth and tone.
Usage
A notification
Click "Edit Primary color" to change the color
import { Button } from '@apollion-dsi/core/elements/button';
import { ApollionProvider } from '@apollion-dsi/core/themes';
<ApollionProvider colors={{ primary: '#7B2CBF' }}>
<Button text="Primary action" color="primary" />
</ApollionProvider>;Reference a step in props with a dot path: color="danger.dark", bgColor="primary.light".
Build a scheme
Pick seeds with the color picker; the palette below re-derives live.
const theme = createTheme({
"colors": {
"baseDark": "#0b0b0b",
"baseLight": "#f9f9f7",
"transparent": "transparent",
"deepDark": "#000",
"deepLight": "#FFF",
"main": "#003750",
"opposite": "#4c280a",
"complementary": "#F6BA20",
"information": "#3399FF",
"success": "#2CB567",
"danger": "#E12712",
"warning": "#FFBB00",
"primary": "#32AFDC",
"secondary": "#2D81AA",
"tertiary": "#2CE571"
}
})Brand Colors
main
base#003750
dark#000810
action#002639
active#97aab6
light#e4e9ec
opposite
base#4c280a
dark#0f0401
action#361b05
active#b5a397
light#ece7e4
complementary
base#F6BA20
dark#453203
action#b78915
active#fce5b7
light#fef9ed
Contrast Colors
contraste
baseDark#0b0b0b
baseLight#f9f9f7
deepDark#000
deepLight#FFF
Function Colors
primary
base#32AFDC
dark#072e3c
action#2281a3
active#b7e0f2
light#edf7fc
secondary
base#2D81AA
dark#061f2d
action#1f5e7d
active#aeccdd
light#ebf2f7
tertiary
base#2CE571
dark#053f1a
action#1eaa52
active#bef7c8
light#effdf1
Response Colors
information
base#3399FF
dark#072748
action#2370be
active#b3d8ff
light#ecf5ff
success
base#2CB567
dark#053017
action#1e864b
active#b6e2c2
light#edf8ef
warning
base#FFBB00
dark#483200
action#be8a00
active#ffe5b5
light#fff9ed
danger
base#E12712
dark#3e0401
action#a71a0a
active#fdb4a6
light#ffece9
Tonal Colors
neutral
0#ffffff
5#f7f9fa
10#f0f3f4
20#e1e7ea
30#d2dbdf
40#c4cfd4
50#b5c3ca
60#a7b8c0
70#99acb5
80#8ba1ab
90#7d96a1
100#708b97
110#62808d
120#557583
130#476a7a
140#3a6070
150#2c5567
160#1e4b5d
170#0d4154
180#062936
gray
0#FFF
5#eeeeee
10#dedede
20#bebebe
30#9e9e9e
40#808080
50#636363
60#484848
70#2e2e2e
80#161616
90#030303
100#000000
Surface ladder
Besides the palettes, the engine resolves a mode-aware ladder from the contrast anchors:
Group | Roles |
|---|---|
surface | canvas · sunken · paper · raised · overlay · scrim |
ink | primary · secondary · muted · disabled |
edge | hairline · border · strong |
wash | hover · pressed · selected |
Scrolls sideways inside the table. The page does not.
They are ordinary tokens (bgColor="surface.paper", color="ink.secondary"). The stock seeds are
baseLight: '#f9f9f7' and baseDark: '#0b0b0b'. To pin one role for a reference design, set it per
polarity:
createTheme({ colors: { ladder: { dark: { surface: { paper: '#1a1a19' } } } } });How the ladder behaves in each mode is on Dark Mode.