Skip to the content

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 stock opposite is the hue opposite of the stock main, so set it whenever you change main.
  • Contrast — baseLight, baseDark, deepLight, deepDark: the anchors of the light/dark duotone. baseLight is the light page canvas; the canonical dark swap exchanges baseLight↔baseDark and deepLight↔deepDark.
  • Function — primary, secondary, tertiary: actions and interactive emphasis.
  • Response — success, information, warning, danger: feedback states.
  • Tonality — the neutral and grayscale ramps, 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.

See also