See how this site publishes in seconds

Rethinking dark mode

What we kept, what we cut, and why. The small decisions that make the product feel quieter. Good defaults, explained.

Every color in the product now maps to a role, not a hue. Designers pick "border" or "muted text", and the system decides what that means in light and dark mode. This post covers what we changed, why, and what it means for you.

The constraint

Good defaults are invisible. You notice them only when they are missing, usually at the worst possible moment.

Hairlines carry more structure than you would expect. A single one-pixel rule can replace a card, a shadow and a background, and the page gets quieter.

We tested each change with the people who use the product all day. The best feedback was rarely about how something looked, and almost always about how it felt to repeat.

What we measured

Consistency is a feature you ship once and maintain forever. Our lint rules now catch one-off sizes and colors before they reach review.

We started from the text. Body copy sets the rhythm for everything else, so we fixed its size and line height first and derived the rest of the scale from there.

If you pinned an older version, nothing changes until you opt in.

What's next

Motion should explain, not decorate. If an animation does not tell you where something came from or where it went, we remove it.

Every color in the product now maps to a role, not a hue. Designers pick "border" or "muted text", and the system decides what that means in light and dark mode.

Good defaults are invisible. You notice them only when they are missing, usually at the worst possible moment.

A cache key must include everything that can change the output, and nothing that cannot.

What we would do differently

Hairlines carry more structure than you would expect. A single one-pixel rule can replace a card, a shadow and a background, and the page gets quieter.

We tested each change with the people who use the product all day. The best feedback was rarely about how something looked, and almost always about how it felt to repeat.

The safe path has to be the easy path.

Rolling it out

Consistency is a feature you ship once and maintain forever. Our lint rules now catch one-off sizes and colors before they reach review.

We started from the text. Body copy sets the rhythm for everything else, so we fixed its size and line height first and derived the rest of the scale from there.

Motion should explain, not decorate. If an animation does not tell you where something came from or where it went, we remove it.

Skip what has not changed

Run independent steps in parallel

Report problems in plain language