Figma for Product Teams · 22 min · 150 XP

Dev Mode, specs and every state

Mark work ready, annotate what the file cannot show, and cover the states nobody designs.

Handoff fails in a predictable way. The file has one beautiful screen with plausible data, and every question an engineer actually has (what happens with no results, what the error says, how wide before it wraps, which token this grey is) has to be asked in Slack and answered from memory.

Dev Mode is the engineer's view of the file: measurements between any two layers, the resolved values of a selection, assets to export, and a diff of what changed since they last looked. Two habits make it worth having. Mark sections Ready for dev, so it's unambiguous which frames are real and which are Tuesday's experiment. And use annotations to pin the things the canvas cannot express: behaviour, constraints, the rule behind the layout.

Dev Mode's generated CSS is a reading aid, not a spec. It describes the rectangles you drew, not the component in the codebase, and it will happily emit a hard-coded hex and a magic pixel value. Where you've bound variables, those surface as named tokens, which is the part worth copying.

Then design the states. For almost any surface that loads data, there are five beyond the happy path, and they are where the bugs live: - Empty: nothing here yet, and what to do about it. - Loading: what fills the space while waiting. - Error: what failed, and what the person can do next. - Extremes: one character, ninety characters, 1,240 items. - Permissions: what someone who can't edit this sees.

An annotation that prevents a Slack thread
Orders table · annotation

Sort: default is newest first. Sorting is server-side,
so the empty state below applies while a sort is loading.

Row height is fixed at 56 even when the customer name wraps:
the name truncates with an ellipsis at one line. Full name
is in the row's tooltip.

Do it in Figma: take a screen you've already designed, mark it Ready for dev, and add the five states beside it. Then add one annotation describing something that happens over time rather than something you could measure with the ruler.

Loading your workspace…