Skip to content
NewSee how this site publishes in seconds
Halftone

DesignCraft

Small changes to focus states

What we kept, what we cut, and why. The small decisions that make the product feel quieter. How we chose, tested and shipped the details.

Small changesto focusstatesHALFTONE / JOURNAL
Bo Lindqvist
Published 2 min read

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. This post covers what we changed, why, and what it means for you.

#Trade-offs

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

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.

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

#Rolling it out

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.

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

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.

ts
const key = `${route}:${hash(content)}:${hash(template)}`;
const hit = await cache.match(key);
if (hit) return hit;

#The constraint

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.

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

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.

ts
export async function publish(post: Post) {
  const problems = validate(post);
  if (problems.length) return { ok: false, problems };
  await commit(post);
  return { ok: true, url: `/blog/${post.slug}/` };
}

#Where we started

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 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.

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
  • Report problems in plain language
  • Keep the previous version one click away
  • Run independent steps in parallel

#What changed

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.

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.

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

“The safe path has to be the easy path.”
Ivo Santos
How we designour typescaleHALFTONE / JOURNAL

Design4 min

How we design our type scale

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

Jun Calder / Gus Heller
The detailsbehinddensitysettingsHALFTONE / JOURNAL

Design4 min

The details behind density settings

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

Gus Heller
In praise ofour typescaleHALFTONE / JOURNAL

Design10 min

In praise of our type scale

How we chose, tested and shipped the details. The small decisions that make the product feel quieter. Good defaults, explained.

Dee Marsh / Jun Calder