Someone just booked an audit
Handoff · a direct answer

How do you hand off a design so developers build it correctly?

A design handoff survives the build when it describes behaviour rather than appearance. That means naming every state, loading, empty, error, overflow, permission, with the motion timings and the exact copy inside each one. Any state you leave unnamed will be invented by the developer, and it will be the fastest version to build.
Written 29 October 2026 · last changed 29 October 2026

Screenshots communicate the happy path and almost nothing else. The gap between a beautiful comp and a working interface is entirely made of states nobody drew: what the list looks like with 400 items, what the button says while it is saving, what happens when the request fails at 3am.

The acceptance test matters as much as the spec. If the criterion is an opinion, the build will be argued about; if it is a screenshot diff against a named state, it can only pass or fail.

The fix, in four steps

  1. Name the five states per component Default, loading, empty, error, overflow. Add permission and disabled where relevant.
  2. Write the copy inside each state Most rework is a missing sentence, not a missing pixel.
  3. Give motion numbers, not adjectives “Snappy” is not a spec. 180ms, cubic-bezier(.32.72,0,1) is.
  4. Make the diff the acceptance test Screenshot comparison against each named state, in the same viewport, before sign-off.

“He doesn't approach problems like a typical consultant. He challenges assumptions, finds opportunities we hadn't considered, and thinks several steps ahead.”

Joseph, Founder

The same engine, set up for one kind of work. It is not software you log into. You get the modules, the procedures and the documentation, and you own them.

audit USD 500₹30,000 · sprint USD 3,500₹2,10,000 · retainer from USD 250/mo₹15,000/mo
Seven a month, slots open on the 1st

Only taking seven audits a month. We check the fit before you pay.

Get this applied to your business

USD 500, fixed scope, 3 days, every finding cites what I read. Seven a month, and we check the fit before you pay: if you are not a fit you are not charged.

AI workflow audit, USD 500→

Questions

What states do developers most often have to invent?+
Empty and error. Both are skipped in most handoffs and both are visible on the first day of real data.
Should the handoff be a document or a Figma file?+
Both, with the document as the source of truth. A file shows the intent; a document states the behaviour, and behaviour is what gets built.
How do you handle responsive behaviour in a handoff?+
Name the breakpoints and what changes at each one. “It's responsive” is a wish; “below 720px the sidebar becomes a bottom bar” is a spec.

More answers