The handoff problem is not Figma versus code — it is missing decisions. Engineers should not guess spacing, states, or empty cases. Designers should not re-litigate layout in Slack after sprint planning.
What every screen includes
- All interactive states — default, hover, focus, disabled, loading, error
- Responsive behavior at defined breakpoints, including RTL
- Token references, not one-off hex values
- Annotations for edge cases: empty, partial, overflow, long Arabic strings
Async-friendly reviews
We record Loom walkthroughs for complex flows, but the source of truth stays in Figma with linked decision logs. That lets distributed clients in Palestine, Jordan, and Europe approve without midnight meetings.
A handoff is complete when engineering can estimate without a clarification call.
The decision log that prevents rework
Pretty frames are not a contract. We attach a short decision log to each major flow: what was chosen, what was rejected, and why. When requirements change mid-sprint, the log makes the delta visible instead of restarting the debate from memory.
- Link each frame to the ticket or user story ID
- Call out content that is placeholder vs approved copy
- Mark components that already exist in the design system vs net-new
- Flag motion and accessibility requirements next to the visual
Tokens beat screenshots
When spacing and color live only as pixels in a mock, every engineer reinvents the values. Mapping Figma variables to CSS/React tokens once — and refusing one-off hex in production — is how handoffs stay stable across web and mobile. Screenshots become illustrations; tokens become the build contract.
iFynx takeaway
Handoff quality is measured by how few clarification calls engineering needs. Spec states, annotate RTL, bind tokens, and write decisions down.
Related reading
- Figma Code Layers and Specs (Config India, 15 Oct 2026): A Hands-On Checklist for Arabic RTL Products — Design-to-Code Handoff, Specs for AI Coding Agents, and the Figma MCP in Claude Code and Cursor
- Design tokens that survive web and mobile
- Micro-interactions that feel premium
- How distributed teams ship without losing context
- All featured articles
Acceptance checklist for a handoff designers and engineers both sign
A Figma file is not a contract. Product teams need a shippable handoff package that survives a MENA bilingual review and a Friday deploy.
- Every screen links to named design tokens — no hard-coded hex or spacing that engineers must reverse-engineer
- Interactive states (hover, focus, error, loading, empty, offline) are annotated or prototyped, not left as designer folklore
- RTL variants exist for every new layout that ships Arabic; mirroring is verified, not assumed
- Copy keys are listed with max length and truncation rules for EN and AR
- Accessibility notes cover focus order, contrast, and screen-reader labels for primary actions
- A one-page “decisions log” records open questions closed in review — so Slack threads do not become the source of truth
If engineering still opens Figma to guess padding, the handoff failed — regardless of how polished the mock looks.
Failure modes that burn a sprint after “design is done”
Most handoff debt shows up as rework, not as a dramatic launch failure. Script the boring failures.
- Token names diverge between Figma and code; a “fix” rename silently breaks three products
- Arabic copy is longer than the EN box; truncation hides the verb on mobile RTL
- Dark-mode and high-contrast variants were never exported; QA files defects as “engineering bugs”
- Prototype used magic numbers for animation; production implements a different curve and PM calls it “off-brand”
- Component variants exist in Figma but not in the shared library — engineers rebuild one-offs that never sync again
Acceptance should include a 30-minute pair walkthrough: designer + engineer click every primary path in both languages.
Ops playbook: week 1–4 to make handoff boring
- Week 1: inventory the top 20 components; map each to a code library entry or explicitly mark as one-off
- Week 2: enforce token binding in lint or CI for new PRs that touch UI
- Week 3: add an RTL screenshot diff job for the five highest-traffic screens
- Week 4: publish a one-page handoff template the whole studio reuses — including copy keys and a11y notes
- Success metric: handoff-related reopen rate under 10% of design tickets, measured for two sprints
Handoff maturity is not prettier Figma files. It is fewer surprise tickets after design review closes.
MENA and bilingual constraints on design-to-code
Studios shipping for UAE, KSA, and Egypt routinely discover that “mirror the frame” is not localization.
- Numerals, currency, and date formats change density; leave flexible width, not fixed 48px chips
- Arabic typography needs line-height and letter-spacing tokens separate from Latin — do not reuse EN type ramps blindly
- Form labels often sit above fields in AR for clarity; do not force side-by-side layouts that crush at 360px
- Legal and disclosure strings can double in length — reserve expandable slots in the design, not after legal review
Treat bilingual layout as a first-class acceptance criterion, not a post-launch localization ticket.
