Lesson 00 / Orientation Local sky 12:00 / Daylight Seven lessons, one evening

Dark mode is not inverted light mode.

DUSK is a school for designing dark themes on purpose. No pure black, no neon, no shadows nobody can see. Scroll down and the sun sets on this page; drag the sun in the header and the whole site follows you into the night.

Live specimensurfaces e0 to e5
Day: shadows liftNight: light lifts
Drag the sun to set the hour.
Or simply scroll.
The evening timetableKeep scrolling: the light keeps falling

Seven lessons between golden hour and night.

  1. 17:4001Why pure black hurtsPure #000 next to white text smears on OLED and glows on LCD. Start at #121318.
  2. 18:1002Desaturate the accentsSaturated colour vibrates on dark ground. Lift lightness, drop chroma.
  3. 18:4503Text opacity levelsThree steps of white: 87, 60 and 38 percent. Hierarchy without new colours.
  4. 19:3004Elevation through lightnessShadows vanish at night. Higher surfaces get lighter instead.
  5. 20:1505Contrast in the darkAim for roughly 12 to 16:1, not 21:1. Maximum contrast is not maximum comfort.
  6. 21:0006Images at nightDim photos a little, calm their chroma, and lose the white boxes.
  7. 22:4007Semantic tokens for both themesName the role, not the colour, and one stylesheet serves day and night.
Lessons 01 + 02 / 18:10Step 0 of 5

Inverted is wrong.

As designed. A light task app. Warm off-white, soft shadows, three saturated tags. Now flip it the lazy way.

Problems
Fixed
base #f7f6f3 accent chroma 0.21 text #1a1b20
Lesson 04 / 19:30Shadow elevation

Elevation by light.

Six surfaces at six heights, separated only by shadow. On #121318 the shadows have nowhere to fall.

Side viewcloser to the light = lighter
Lessons 03 + 05 / 20:15These numbers follow the sun in the header

Turn the text down, not the contrast off.

Text on surface e1#ffffff
High emphasis / 87%

Ship the dark theme tokens

0.0:1AAA
Medium / 60%

Due today at 18:00, two subtasks

0.0:1AA
Disabled / 38%

Archived on Monday

0.0:1n/a
#ffffff on #000000 / 21:1

Maximum contrast. On a dark room screen the letters bloom and the strokes seem to glow and blur at the edges.

87% on #121318 / 12.5:1

Still well past AAA, and calm enough to read for an hour. The ground is dark grey, the text slightly dimmed.

Dark themes fail in two directions: too little contrast for small grey text, and too much for long reading. A comfortable band for body text is roughly 12:1 to 16:1.

Lesson 06 / 21:00Drag the divider

Pictures need night eyes too.

As shippedNight tuned

A photo graded for daylight is the brightest thing in a dark interface. It pulls the eye and flattens everything around it. Pull it back a little.

Spot illustration

The day file ships on a white box. At night it is a glowing rectangle.

Lesson 07 / 22:40Regroup with Flip

Name the role, not the colour.

Components ask for --surface-2, never for #ffffff. Each role holds two values, and the theme decides which one is live.

tokens.css

Now make one yourself.