FrameFlow Logo FrameFlow Contact
Contact
Advanced 11 min leestijd Maart 2026

Design Handoff: Wat Developers Écht Nodig Hebben

Figma-specs, annotaties, en responsive-breakpoints: de checklist zodat je developers niet om verduidelijking hoeven te vragen. Met template.

Laptop met design-documentatie open, specificaties zichtbaar, developer aan andere kant van tafel
Maarten van den Berg
Senior Design Systems Expert
Senior Design Systems Expert met 13 jaar ervaring in wireframing, prototyping en collaboratieve designworkflows voor Nederlandse teams.

De Kloof tussen Designer en Developer

Het moment waarop je je design aan je developer geeft, is cruciaal. Je hebt maanden aan Figma gewerkt, wireframes gemaakt, prototypes gebouwd, feedback van klanten ingewerkt. Dan staat die developer voor je scherm met drie vragen: “Wat zijn precies de paddings hier? Hoe gedraagt dit component zich op mobile? En waar zijn de specs voor deze animatie?”

Dit hoeft niet. Een goed handoff betekent dat je developer alles vindt wat ie nodig heeft. Geen vragen meer. Geen raden naar waardes. Geen terugkomen met “dit ziet er anders uit dan in jouw design”.

Wat je Developer Echt Controleert

Developers kijken eerst naar drie dingen in je Figma-file. Niet naar je design, maar naar de implementatiedetails. Ze willen weten: klopt de spacing? Zijn de font-sizes consistent? Werken de breakpoints logisch?

De meeste designers geven een file door met mooie frames, maar zonder de onderliggende structuur. Dan gaat je developer gokken. Padding 16px of 24px? Spatie tussen elementen vaste pixels of flexibel? En die button — gedraagt die zich hetzelfde op tablet als op desktop?

Je moet het expliciet maken. Niet alleen zeggen “hier is mijn design”, maar: “hier zijn mijn componenten, zo werken ze, dit zijn de specs, en zo moeten ze zich op verschillende schermen gedragen”.

Designer en developer aan tafel, design-file op groot scherm, beide wijzen naar component details
Figma-bestand met component library, spacing tokens, en design specs zichtbaar in paneel

De Checklist: Dit Moet in Je File

Je hebt waarschijnlijk veel al gedaan. Maar zorg dat dit allemaal duidelijk in je Figma staat:

Component Library: Alle componenten (buttons, cards, forms) moeten in één overzichtelijke file staan. Niet verspreid over tien artboards.
Spacing Tokens: 8px, 16px, 24px, 32px — wat je gebruikt. Schrijf het op. Maak een reference-frame.
Typography Scale: H1: 32px, H2: 28px, body: 16px. Alles. Met line-heights ook.
Color Tokens: Niet “dit is blauw”, maar “dit is –color-primary: #1e40af”. Met alle varianten.
Responsive Breakpoints: Desktop, tablet, mobile — wat zijn je breakpoints? 1440px? 768px? Zet ze in je frames.
Annotaties: Als iets niet voor de hand liggend is, schrijf het op. “Deze button is 44px hoog voor touch targets.”

“Ik haat het moment waarop de design-file aankomt en ik moet al tien keer terugvragen. Dat geeft aan dat de designer het niet helemaal doordacht heeft voor development.”

— Bas, Frontend Developer bij Ambitio

Responsive Gedrag Moet Duidelijk Zijn

Dit is waar het misgaat. Je maakt mooie designs voor desktop. Dan vraagt je developer: “Wat gebeurt er op 600px? Stapelen die elementen? Verandert de font-size? Gaat dit component verbergen?”

Je kunt hier twee dingen doen. Ofwel maak je in Figma frames voor desktop, tablet en mobile — en zorg dat alles consistent is. Ofwel schrijf je het uit. “Op screens kleiner dan 768px: stack verticaal, padding wordt 16px i.p.v. 24px, font-size wordt 14px.”

Veel developers zeggen: geef mij gewoon één desktop-design en ik zal het responsive maken. Dat werkt, maar je mist kansen om op mobile echt optimaal te ontwerpen. Touch targets moeten groter zijn. Kolommen passen niet meer naast elkaar. Dus: maak minstens drie breakpoints.

Drie telefoonschermen naast elkaar, responsive layouts voor klein, medium en groot formaat
Figma-bestand met annotaties, pijlen, en tekstnoten die design-logica uitleggen

Annotaties die Echt Helpen

Je hoeft niet alles uit te tekenen. Maar waar het ingewikkeld wordt, schrijf het op. Een goeie annotatie is niet “mooi design”, maar “deze card groeit mee met content, max-width 400px”.

Denk zoals een developer. Wat wil je dat ie weet? Dat je een mooi kleurenpaletje hebt? Nee. Je wilt dat ie weet:

  • Hoe gedraagt dit component zich als de tekst langer is?
  • Moet deze spacing vaste pixels zijn of flexibel?
  • Wat gebeurt er als een afbeelding niet laadt?
  • Zijn er states die ik niet zie (hover, active, disabled)?
  • Hoeveel tijd mag een animatie duren?

Deze vragen beantwoord je door goed in Figma te werken. Niet door “hier is mijn design, veel sterkte”.

De Template: Copy-Paste Ready

Ik gebruik dit zelf voor elk project. Maak een “Design Specs” pagina in je Figma-file. Niet als aparte doc, maar recht in Figma. Dan hoeft je developer niet tussen tien tabs heen en weer te gaan.

In die pagina zet je:

1. Spacing Scale

--spacing-xs: 4px --spacing-sm: 8px --spacing-md: 16px --spacing-lg: 24px --spacing-xl: 32px --spacing-2xl: 48px

2. Typography

H1: 32px / 40px (desktop), 28px / 36px (mobile) H2: 28px / 36px (desktop), 24px / 32px (mobile) Body: 16px / 24px Small: 14px / 20px

3. Breakpoints

Mobile: 320px - 767px Tablet: 768px - 1023px Desktop: 1024px+
Tekstbestand met design tokens en specs, duidelijk geformatteerd en gemakkelijk te kopieren

Wat je Nu Doet

Je hebt een design klaar. Volg deze stappen voor je het aan je developer geeft:

  1. Maak een “Design Specs” frame met alle tokens en breakpoints.
  2. Zorg dat alle componenten in je library staan, met variants voor states (hover, active, disabled).
  3. Maak frames voor minstens drie breakpoints — en toon hoe content zich gedraagt.
  4. Annoteer de moeilijke onderdelen. “Spacer tussen elementen groeit flexibel” of “deze animatie duurt 300ms”.
  5. Activeer “Inspect” mode in Figma zodat je developer makkelijk specs kan zien.
  6. Zet een doc-link in je brief: hier zijn de specs, hier zijn de componenten, hier zijn de breakpoints.

Dit kost je een halve dag extra. Je developer spaart er twee dagen mee uit. Dat is winst.

Opmerking

Dit artikel beschrijft best practices voor design handoff op basis van ervaring met Nederlandse design teams. Elk project is uniek — jouw workflow, tool (Figma, Sketch, Adobe XD) en team kunnen anders werken. Deze richtlijnen zijn startpunt, niet dogma. Pas ze aan naar je situatie.