Design, before Any SoftwareLesson 72 of 74

Module 7 · Making the decision once

Specifications that survive contact

In this lesson

  • 8 min read
  • 6 reading sections
  • Knowledge check
  • Lesson 7 of 9 in this chapter

This chapter’s goalConvert a set of one-off screens into named tokens and a small component set, decide for any new element whether it is a variant of something existing or a new thing, specify every state a component can be in, and say at what point a project is large enough for the system to be worth its maintenance cost.

This chapter’s media

The film explains chapter ideas. The audiobook narrates the complete teaching text.

FormatEnglishहिंदी
Chapter filmWatch1:50Not available
Full audiobookNot availableNot available

A little at a time

Explore an idea, try it, then check what stays.

Step 1 of 8Free · no account needed
Lesson steps

Redlines are dead labour

The traditional handoff was an annotated screenshot: arrows and numbers marking every margin, every size, every hex code. It takes hours, it is obsolete the moment anything changes, and the numbers get transcribed by hand into code where they become untraceable magic values.

If you have tokens, hand over token names instead.

Text
Bad:   padding 24px, gap 8px, radius 8px, #2F6DF6, 16px/1.55
Good:  padding var(--space-4), gap var(--space-2),
       radius var(--radius-md), background var(--colour-action),
       text var(--text-md)/var(--leading-normal)

The second version is shorter to write, unambiguous, and survives a rebrand without being rewritten. It also makes deviations visible: if a developer has to ask what token 18px is, the answer is that 18px is a mistake.

Your place and first choices stay on this browser. Classroom credit is recorded separately.

Stuck on something?Ask Meher, your AI tutor

How to cite: Addaly (2026) ‘Specifications that survive contact’, in Design, before Any Software. Edited by M. Mun. Addaly. Available at: https://addaly.com/learn/design-foundations/documenting-and-handing-off (Accessed: 21 November 2026).