Checklist handoff Figma ke React untuk design engineer
Checklist handoff Figma ke React: token dan variable, variant yang dipetakan ke props, state UI, aturan responsif, motion, aksesibilitas, dan Code Connect.
Kebanyakan masalah handoff bukan masalah kode. Layarnya terlihat selesai di Figma, versi React-nya terlihat selesai di browser, lalu keduanya tidak sepakat soal apa yang terjadi kalau nama pengguna panjangnya 60 karakter, request-nya gagal, atau seseorang menelusuri form dengan tombol Tab.
Saya membawa interface dari Figma sampai jadi React di production di MedRoyale, tempat design system yang saya bangun memangkas waktu handoff dari desain ke development sekitar 80%. Design system hanya terbayar kalau setiap layar datang dengan pertanyaannya sudah terjawab, jadi ini checklist yang saya jalankan untuk sebuah layar sebelum layar itu jadi komponen. Jalankan bersama designer-nya, bukan sebagai daftar tuntutan untuk mereka.
Token dan variable
- Setiap warna, radius, spacing, dan nilai tipografi adalah variable atau style, bukan hex mentah.
#3B6CF6mentah di frame akan jadi nilai mentah di kode, lalu keduanya pelan-pelan berbeda. Kalau sebuah nilai belum punya token, putuskan sekarang: perlu token baru, atau itu kesalahan. - Nama variable sama dengan nama di kode. Kalau kodenya memakai
--color-inkatau class Tailwindtext-ink, variable di Figma sebaiknyacolor/ink, bukanText Primary Dark. Atur code syntax variable untuk Web supaya Dev Mode menampilkan nama aslinya saat di-inspect. - Tema adalah mode, bukan frame duplikat. Light dan dark sebaiknya dua mode dari collection variable yang sama. Jadi kamu cukup mengecek satu frame di dua mode, bukan membandingkan dua frame dengan mata.
- Spacing mengikuti skala. Jarak 13 px hampir selalu hasil geser-geser, bukan keputusan. Sesuaikan dengan skala, atau tulis alasan kenapa berbeda.
Komponen, variant, dan props
- Setiap komponen Figma dipetakan ke satu komponen React. Kalau designer punya
Button,Button Small, danButton Iconsebagai komponen terpisah, sepakati apakah di kode itu satuButtondengan props atau tiga komponen. - Property variant terbaca seperti props.
size=sm|md|lg,variant=primary|secondary|ghost,disabled=true|false. Kalau sebuah property tidak bisa dinamai seperti props, kemungkinan itu dua komponen yang bersembunyi dalam satu. - Property boolean dan instance swap dicatat. “Ada ikon”, “tampilkan badge”, dan slot ikon yang bisa ditukar semuanya jadi props atau children. Kalau terlewat, ujungnya komponen punya enam salinan yang mirip.
- Instance yang di-detach ditemukan dan dijelaskan. Tombol yang di-detach itu entah one-off yang seharusnya tidak ada, atau variant baru yang belum dimasukkan ke library.
- Cocokkan dengan library yang sudah ada. Kalau sisi kodenya memakai sesuatu seperti shadcn/ui, petakan komponen Figma ke bagian-bagiannya sebelum membangun sesuatu yang baru.
State
- Elemen interaktif punya state hover, focus-visible, active, dan disabled. Focus paling sering terlupa, padahal itu yang diandalkan pengguna keyboard.
- Layar async punya state loading, empty, dan error. Tabel butuh skeleton atau spinner saat pertama dimuat, state “tidak ada hasil”, state “error, coba lagi”, dan tampilan saat gagal sebagian.
- Form punya state validasi dan pesannya. Teks error-nya muncul di mana, isinya apa, dan kapan muncul: saat blur, saat submit, atau saat mengetik?
- State sukses juga didesain. Apa yang dilihat pengguna setelah menyimpan, mengirim, atau menghapus adalah bagian dari layar itu.
Aturan responsif
- Ada frame untuk breakpoint yang dipakai di kode. Minimal mobile dan desktop, dengan nilai breakpoint yang ditulis jelas, bukan ditebak dari lebar frame.
- Auto layout menjelaskan apa yang melebar. Fill container atau hug contents menentukan apakah kartu ikut membesar atau menyisakan celah. Lebar tetap di sebuah frame harus disengaja.
- Perilaku di antara breakpoint dijelaskan. Apa yang turun ke baris baru, apa yang dilipat jadi menu, apa yang di-scroll horizontal, apa yang disembunyikan. Dua frame statis tidak menunjukkan ini.
- Tabel dan dashboard punya rencana untuk layar sempit. Scroll horizontal, kartu bertumpuk, atau kolom yang disembunyikan. Putuskan sebelum datanya datang.
Kasus tepi konten
- Teks panjang sudah dites. Nama panjang, judul panjang, angka panjang, dan label terjemahan yang paling panjang. Teks terjemahan bisa jauh lebih panjang dari versi bahasa Inggrisnya, jadi produk dua bahasa perlu dites di keduanya.
- Aturan pemotongan teks eksplisit. Elipsis setelah satu baris, clamp di tiga baris, atau dibiarkan wrap. Sebutkan yang mana, dan apakah ada tooltip yang menampilkan nilai lengkapnya.
- Bentuk data yang dipakai realistis. Nol item, satu item, seratus item, avatar yang tidak ada, nilai null. Lorem ipsum menyembunyikan semua ini.
- Angka, tanggal, dan mata uang punya format. Pemisah desimal, zona waktu, dan simbol mata uang adalah keputusan desain.
Motion
- Setiap animasi punya trigger, property, durasi, dan easing. “Fade in” bukan spesifikasi. “Saat masuk, opacity 0 ke 1 dan y 8 px ke 0, 0,4 detik, ease-out” baru spesifikasi.
- Reduced motion sudah ditentukan. Apa yang terjadi kalau
prefers-reduced-motionaktif: tanpa animasi, atau fade sederhana? - Link prototype sesuai spesifikasi. Kalau prototype memakai smart animate, tulis apa yang ingin ditunjukkan, karena kode tidak akan meniru prototype persis.
Aksesibilitas
- Kontras lolos WCAG AA. Minimal 4,5:1 untuk teks biasa, dan 3:1 untuk teks besar serta bagian UI seperti border dan ikon, sesuai panduan kontras WCAG. Cek di kedua tema.
- Urutan fokus ditulis untuk layar yang kompleks. Dialog, menu, dan form multi-kolom adalah tempat urutan visual dan urutan DOM sering berpisah.
- Setiap input punya label yang terlihat, dan tombol ikon punya nama yang aksesibel. Placeholder bukan label. Ikon tempat sampah butuh “Hapus baris” di suatu tempat, meskipun hanya di anotasi.
- Area sentuh cukup besar. WCAG 2.2 meminta minimal 24 x 24 CSS pixel, dengan beberapa pengecualian. Untuk layar sentuh saya biasanya membuatnya lebih besar.
Aset
- Ikon berasal dari satu set, sebagai komponen. Bukan vector yang di-flatten lalu ditempel dari tiga library berbeda.
- Gambar punya setting export dan perannya jelas. Format, ukuran untuk setiap breakpoint, dan apakah gambar itu dekoratif atau butuh alt text.
- Ilustrasi bisa di-export sebagai SVG kalau memungkinkan, dengan layer tersembunyi dan mask yang tidak perlu dibersihkan dulu.
Dev Mode, Code Connect, dan MCP server
- Frame sudah ditandai ready for dev. Status di Dev Mode memberi tahu developer mana yang sudah final, dan compare changes menunjukkan apa yang berubah sejak terakhir mereka lihat.
- Anotasi membawa hal yang tidak bisa ditunjukkan canvas. Perilaku, catatan aksesibilitas, dan ukuran yang penting ditulis di anotasi Dev Mode, bukan di dokumen terpisah yang cepat basi.
- Komponen dihubungkan dengan Code Connect. Code Connect memetakan komponen Figma ke komponen aslimu, lewat UI di dalam Figma atau lewat CLI di repo. Dev Mode lalu menampilkan cuplikan komponen aslimu di samping CSS yang di-generate. Saat tulisan ini dibuat (November 2026), fitur ini butuh seat Full atau Dev di paket berbayar.
- Tools AI mendapat konteks desain, bukan screenshot. Kalau kamu men-generate kode dengan agent, hubungkan Figma MCP server. Pemetaan Code Connect ikut masuk ke sana, jadi agent memakai komponenmu, bukan membuat yang baru.
Penamaan
- Layer dinamai sesuai isinya.
Frame 427tidak memberi tahu siapa pun apa-apa. Beri nama pada layer yang akan jadi komponen atau landmark. - Page dan frame mengikuti satu konvensi. Fitur, lalu layar, lalu state, misalnya
Billing / Invoices / Empty. - Nama komponen dan props sama di kedua sisi. Kalau Figma menyebutnya
Chipdan kode menyebutnyaTag, suatu hari akan ada orang yang membangun keduanya.
Cara memakai daftar ini
Jangan serahkan ke designer sebagai gerbang yang harus dilewati. Telusuri bersama di layar pertama sebuah fitur, perbaiki yang kurang di Figma, dan layar-layar berikutnya jadi lebih cepat karena celahnya sudah tertutup. Dari pengalaman saya, kebiasaan ini lebih berpengaruh daripada plugin apa pun.
Kalau kamu bertanya-tanya apakah pekerjaan ini milik designer atau developer, saya menulisnya di design engineer vs frontend developer. Dan saat situsnya sendiri siap dirilis, checklist peluncuran mengambil alih.