wowprompt

Design handoff notes from designer to developers

Turns a design file description into handoff notes developers can build from, covering states, edge cases, responsive behaviour, accessibility and open questions. Use it before a sprint starts, so fewer details are guessed or missed.

Design handoff notes with screen list, component states, interaction rules, responsive breakpoints, accessibility notes, edge cases and open questions
The output this prompt produced, unedited.

The prompt

Fill in these first

  • Feature and screens: [names of each screen or step]
  • What each screen shows: [describe layout, components and content from the design file]
  • Interactions: [what happens on tap, hover, submit, swipe]
  • Design system in use: [name, or components built new for this feature]
  • Platforms and breakpoints: [e.g. mobile web 360px up, tablet, desktop, Android app]
  • Data the screens need: [fields, where they come from, maximum lengths]

Task

Write handoff notes a developer can build from without a meeting, and list every decision the design does not yet answer.

Output format

  1. Screen list with purpose of each in one line.
  2. Per screen: | Component | States (default, hover, focus, disabled, loading, error, empty) | Notes |
  3. Interaction rules: triggers, transitions, validation and what the user sees after each action.
  4. Responsive behaviour at each breakpoint, mobile first.
  5. Accessibility: focus order, labels for icons, contrast checks needed, touch target sizes.
  6. Edge cases: long names, no data, slow network, offline, very large numbers.
  7. Open questions for the designer, numbered.

Rules

  • Do not invent colours, spacing values or copy; mark missing ones as [from design file].
  • Every state listed has a defined look or is raised as an open question.
  • Mobile behaviour is described first, wider screens after.
  • Keep notes in short lines, not paragraphs.

Example

| Save button | Default, loading (spinner, label "Saving"), disabled until a field changes | Shows a toast "Changes saved" for 3 seconds |

design handoffdesigner developer handoffui spec documentdesign documentationedge cases uxresponsive design notes

How to run this

Copy the prompt and paste it into Gemini, then set the aspect ratio to 3:4. No reference photo is needed for this one.

The prompt is written in Markdown with each part under its own heading, which is what the copy action hands over. Change one section at a time, keeping the rest intact, so you can tell which change did the work.

Related prompts

All productivity