Markdown · UI/UX
Design handoff checklist
Everything a developer needs before a screen is 'done', so the questions stop arriving one at a time.
Look inside first
# Design handoff: [screen name] Designer: ______ Developer: ______ Date: ______ ## The screen - [ ] Purpose in one line: what can someone do here that they could not before? - [ ] Entry points: where do people arrive from? - [ ] Primary action, and what happens after it - [ ] Out of scope for this release ## States (a screen is not done until all of these exist) - [ ] Empty: first use, nothing to show, with a next step - [ ] Loading: skeleton or spinner, and what stays visible - [ ] Partial: some data missing or still arriving - [ ] Error: what went wrong, in plain words, and how to recover - [ ] Success or confirmation - [ ] Long content: longest realistic name, 3-line heading, 200 rows ## Responsive - [ ] 360 px, 768 px, 1280 px behaviour described, not just drawn - [ ] What reflows, what stacks, what gets hidden (and why hiding it is safe) - [ ] Touch targets at least 44 px on phone ## Tokens used - Spacing: ______ Radius: ______ Shadow: ______ - Type styles: ______ - Colors by token name, not hex: ______ ## Interaction - [ ] Hover, focus, active, disabled for every control - [ ] Focus order and keyboard path through the screen - [ ] Animation: what moves, how far, how long - [ ] What happens on slow connections ## Accessibility - [ ] Contrast checked for every text and background pair - [ ] Alt text written for meaningful images - [ ] Form fields have visible l [...]