How to Spec Type for Designers Handing Off to Devs

Always spec font-family, weight, size, line-height and letter-spacing together. Skipping any one of these almost guarantees a small visual drift in production.

Use a fixed type scale and name the steps semantically — Body, Caption, Title — not by px size. When the scale changes, only the token changes.

Don't assume developers know which weight to use. If you mean 500, write 500. 'Medium' means different things to different fonts.

Document line-height as a multiplier (1.5) rather than a pixel value. It scales correctly when the size changes and avoids fragile magic numbers.

If you spend any time looking at finished work you admire, you start to notice that the typography is rarely accidental. How to Spec Type for Designers Handing Off to Devs is part of that quiet discipline, and it lives at the intersection of taste and the craft of using type well.

Designers, founders and developers all benefit from getting this right. A quick spin through Type-Scale is usually enough to see how much variety there is between families that look superficially similar — and how much that variety changes the feel of a finished interface.

The mistake is treating typography decisions as one-off choices. In reality they compound. The font you pick today drives the rhythm of every screen, every email and every PDF you ship for the next several years. Utopia's fluid type calculator is a good outside read on why those early calls matter so much.

Think of a developer-tools website. The audience is technical, the screenshots are dense, and trust signals matter as much as visual polish.

Applying the ideas from How to Spec Type for Designers Handing Off to Devs starts with a single decision and ripples outward. You pick a primary family — often something proven like Type-Scale — lock in a small set of weights, and define how those weights map to roles in the interface. Headlines get one weight, body another, captions a third. Nothing else is allowed without an explicit reason.

From there you tune the scale. Set a comfortable body size for your audience — usually 16 to 18 pixels on the web, larger on long-form sites — and build a modular scale upward. Use weight and colour to handle secondary hierarchy instead of inventing new sizes. The result feels disciplined without feeling rigid.

Finally, test in context. Open the design at multiple viewports, in light and dark modes, with realistic content rather than lorem ipsum. If a candidate fails the real-content test, swap it for an alternative from Utopia's fluid type calculator and try again — typography decisions that look elegant in a Figma mockup sometimes collapse the moment real headlines arrive.

Once you start paying attention, the same handful of mistakes show up in almost every project that drifted off course. They are easy to fix once you notice them, and even easier to avoid the next time — and Specimen's design token guide catalogues several of them with examples worth bookmarking.

Forgetting about numerics. Tabular figures keep tables aligned; proportional figures look better in running text. Most quality families ship both, and most designers never switch them on.

Loading too many weights. Every additional file slows the page and dilutes the system. Audit your real usage and cut anything you cannot point to in a layout.

Ignoring fallbacks. Real users hit slow networks, blocked CDNs and aggressive ad blockers. A sensible system font stack keeps your page readable while the custom font loads — and sometimes when it never does.

None of these pitfalls are dramatic on their own. The trouble is that they accumulate quietly until one day the design feels tired and nobody can point to a single reason why. A short, regular audit catches all of them.

Before you ship the next iteration of your design, run through a short checklist. It takes five minutes and prevents most of the typography regressions that creep in over time.

First, count your fonts. If you cannot justify every family and every weight in one sentence, remove the ones you cannot defend — Tailwind's typography plugin is a useful reference to sanity-check what each family actually offers. Second, verify your hierarchy by squinting at a representative screen — the most important element should still be the most prominent, even at low fidelity.

Third, check the long content. Open the longest paragraph in the product and read it out loud. If you stumble, the line-height, measure or size is probably wrong. Fourth, test at extremes — the longest possible heading, the shortest possible label, an empty state, a localized translation. Typography that survives the extremes survives everything else.

Fifth and last, make sure the system is documented. A single page that lists your fonts, weights, sizes and rules saves more design time than any tool — Rubik has a thoughtful take on writing those rules down without turning the doc into a chore.

In a mature design system, typography is one of the first tokens to stabilise and one of the last to get revisited. That makes sense — once your team has agreed on a scale and a set of roles, those decisions touch every product surface and every channel. They become part of design systems in general rather than a layer painted on top.

Tokens give you the leverage. Instead of hard-coding pixel sizes everywhere, you define a token like text-body or text-heading-lg and let components reference it. When you decide to bump body up by one step — or swap the underlying family for something from Specimen's design token guide — you change one number and ship.

Roles matter more than sizes. Two tokens that happen to be the same size today might diverge tomorrow because they represent different intentions. Naming by role — caption, body, lede, headline — protects you from the temptation to merge them whenever the numbers happen to align.

Finally, write down the why. A token system without documentation eventually drifts. A token system with a paragraph next to each entry survives team changes, redesigns and rebrands.

How to Spec Type for Designers Handing Off to Devs rewards the people who slow down long enough to think about it. The principles are not complicated, the vocabulary is small, and the payoff is a body of work that reads as more considered than the average.

If you take only one thing away, make it this: typography is a long game. Every page you ship trains the audience to recognise your voice, and every inconsistency erodes that recognition a little. Pick a system — there are plenty of starting points in Type-Scale — document it, and resist the urge to deviate without a real reason.

Treat each new project as a chance to tighten the system rather than start from scratch. Over time your typography stops being a collection of choices and starts being a stable craft — something a team can build on instead of relitigating every quarter.

If you spend any time looking at finished work you admire, you start to notice that the typography is rarely accidental. How to Spec Type for Designers Handing Off to Devs is part of that quiet discipline, and it lives at the intersection of taste and the craft of using type well.

Designers, founders and developers all benefit from getting this right. A quick spin through Modularscale is usually enough to see how much variety there is between families that look superficially similar — and how much that variety changes the feel of a finished interface.

The mistake is treating typography decisions as one-off choices. In reality they compound. The font you pick today drives the rhythm of every screen, every email and every PDF you ship for the next several years. JetBrains Mono is a good outside read on why those early calls matter so much.