web design uiJune 30, 20269 min read

منبع حقیقت Figma جابجا شد: Figma حالا مستندات است

تیم‌های بیشتری حالا کدبیس را به عنوان تنها منبع حقیقت می‌بینند و Figma را به عنوان مستنداتی که آن را توصیف می‌کند. اینجاست که چه چیزی تغییر کرد، Figma هنوز برای چه کاری است، و چطور یک سیستم طراحی کد-اول را بدون از دست دادن تیم اداره کنید.

By Boone
XLinkedIn
figma documentation not source of truth

کدبیس حالا منبع حقیقت است، و Figma مستنداتی است که آن را توصیف می‌کند. این تغییری است که مجموعه‌ای رو به رشد از تیم‌های محصول در طول ۲۰۲۶ انجام دادند، و این ضد-Figma نیست. این نتیجه منطقی سه چیزی است که همزمان به بلوغ رسیدند.

این یک جابجایی است، نه مراسم خاکسپاری. Figma از جایی که حقیقت در آن زندگی می‌کند به جایی که تیم‌ها کاوش و مستندسازی می‌کنند، در حال حرکت است. این یک تنزل مقام است، و ارزش دارد قبل از اینکه کسی را دور آن سازماندهی کنید، آن را درک کنید.

«منبع حقیقت» واقعاً به چه معناست

منبع حقیقت «جایی که طراحی زیباترین است» نیست. این آرتیفکتی است که وقتی دو نسخه با هم اختلاف دارند، برنده می‌شود. اگر فایل Figma یک radius بگوید و کامپوننت شیپ‌شده بگوید دیگری، منبع حقیقت همان است که دیگری را برای تطابق با آن تصحیح می‌کنید.

سال‌ها این Figma بود. طراحان مقادیر را تعریف می‌کردند، مهندسان آن‌ها را ترجمه می‌کردند، و وقتی پروداکشن دور می‌زد، فایل Figma مرجعی بود که دوباره به آن بازمی‌گشتید.

مشکل همیشه مرحله ترجمه بود. یک فایل طراحی نمی‌تواند شیپ شود. کد شیپ می‌شود. پس «Figma منبع حقیقت است» واقعاً به این معنا بود که «Figma منبع حقیقت است تا زمانی که یک مهندس آن را بازتفسیر کند»، که این روش مودبانه‌ای برای گفتن این است که حقیقت در هر handoff دست عوض می‌کرد و هیچ‌کس مالک شکاف نبود.

تغییر، کد-اول با Figma به عنوان مستندات

کد-اول پیش‌فرض را معکوس می‌کند. مقادیر، کامپوننت‌ها، و رابط کاربری شیپ‌شده در ریپو تعریف می‌شوند. Figma آن سیستم را توصیف می‌کند به جای اینکه آن را تعریف کند.

هیچ چیز در روز طراح نباید بدتر شود. شما هنوز در Figma طراحی می‌کنید. هنوز آنجا کاوش، شاخه‌بندی، نقد، و پروتوتایپ می‌کنید. آنچه تغییر می‌کند جهت اقتدار است: ریپو دیگر فایل را دنبال نمی‌کند، فایل به ریپو ارجاع می‌دهد.

ویوکسل سلسله‌مراتب: یک ستون مخزن-کد مرجانی درخشان بلند روی پایه‌ای با نور فیروزه‌ای به عنوان تنها منبع حقیقت، کنار یک ستون کوتاه‌تر تیره آرتبرد Figma که حالا به عنوان مستندات عمل می‌کند.
ویوکسل سلسله‌مراتب: یک ستون مخزن-کد مرجانی درخشان بلند روی پایه‌ای با نور فیروزه‌ای به عنوان تنها منبع حقیقت، کنار یک ستون کوتاه‌تر تیره آرتبرد Figma که حالا به عنوان مستندات عمل می‌کند.

اینجاست که هر لایه وقتی تغییر را صادقانه انجام می‌دهید، چه چیزی دارد.

لایهحالا دارددیگر ندارد
کدبیس / ریپومقادیر توکن، رفتار کامپوننت، رابط کاربری واقعی شیپ‌شدههیچ چیز که واگذار کرده باشد؛ مقادیر را به دست آورد
Figmaکاوش، فلوها، پروتوتایپ‌ها، اسپک‌ها، مستندات، بررسی طراحیمقادیر کانونیکال و کامپوننت «صحیح»
طراحانقصد، سلسله‌مراتب، طراحی تعامل، جهت سیستمحرف آخر را زدن روی پیکسلی که پروداکشن آن را نادیده می‌گیرد
مهندسانپیاده‌سازی توکن‌ها و کامپوننت‌ها همانطور که در کد تعریف شدهتفسیر مجدد یک فایل استاتیک با دست هر بار

چه چیزی ریپو را به منبع حقیقت تبدیل کرد

سه چیز همزمان به بلوغ رسیدند. هیچ‌کدام از آن‌ها «هوش مصنوعی طراحان را جایگزین کرد» نیست. همه آن‌ها زیرساخت خسته‌کننده‌ای هستند که بالاخره فرود آمده.

توکن‌ها به کد رفتند. توکن‌های طراحی مقادیر خام هستند: رنگ، فاصله، radius، مقیاس تایپوگرافی. با پایپ‌لاین‌های توکن ساخته‌شده روی ابزارهایی مثل Style Dictionary، آن مقادیر یک بار در کد تعریف می‌شوند و به بیرون به هر پلتفرم همگام‌سازی می‌شوند. لحظه‌ای که رنگ کانونیکال در یک ریپو زندگی می‌کند و Figma از آن می‌خواند، ریپو منبع برای رنگ است. بقیه مقادیر پیروی می‌کنند.

طراحی و کد به هم متصل شدند. Dev Mode و Code Connect خود Figma به یک کامپوننت Figma اجازه می‌دهند به کامپوننت کد واقعی در ریپو اشاره کند. این بخشی است که مردم از کنارش رد می‌شوند. Figma با این تغییر نمی‌جنگد، آن ویژگی را که کد را هدف اتصال می‌کند، شیپ کرده.

در همان حین Storybook به یک کامپوننت کدشده یک خانه زنده می‌دهد که می‌توانید آن را ببینید و تست کنید، و shadcn/ui کامپوننت‌ها را به عنوان کد واقعی که به ریپو کپی می‌کنید توزیع می‌کند، نه یک لایه که دوباره ترسیم می‌کنید. وقتی سوال «کدام درست است» بالاخره جواب قطعی دارد، جواب کد است.

صفحه بازاریابی Figma Dev Mode، «توسعه و طراحی، در هر مرحله متصل»، Figma خودش کامپوننت کدشده را هدف اتصال می‌کند.
صفحه بازاریابی Figma Dev Mode، «توسعه و طراحی، در هر مرحله متصل»، Figma خودش کامپوننت کدشده را هدف اتصال می‌کند.

هوش مصنوعی در ریپو می‌سازد، نه در کانواس. نسل فعلی تولید رابط کاربری کد می‌خواند و می‌نویسد. لایه‌های Figma شما را نمی‌خواند و به آن‌ها برنمی‌گردد. پس حلقه ساخت حالا در ریپو شروع و تمام می‌شود، که بی‌سروصدا ریپو را به جایی تبدیل می‌کند که کار واقعاً جمع می‌شود.

ویترین کامپوننت shadcn/ui، بلوک‌های رابط کاربری شیک که به عنوان کد واقعی توزیع می‌شوند و مستقیماً به ریپو کپی می‌کنید به جای اینکه دوباره به عنوان لایه Figma ترسیم کنید.
ویترین کامپوننت shadcn/ui، بلوک‌های رابط کاربری شیک که به عنوان کد واقعی توزیع می‌شوند و مستقیماً به ریپو کپی می‌کنید به جای اینکه دوباره به عنوان لایه Figma ترسیم کنید.

Figma حالا واقعاً برای چه کاری است

برای خیلی چیزها، و بیشتر آن چیزی است که طراحان بیشتر دوست دارند.

Figma هنوز مالک ابتدای فرآیند است: کاوش، واگرایی، تکرار سریع، وسط آشفته‌ای که طراحی را پیدا می‌کنید قبل از اینکه وجود داشته باشد. کد جای بدی برای بلند فکر کردن است. Figma برای آن ساخته شده.

مستندات را هم دارد. فلوها، حالت‌ها، موارد لبه‌ای، حاشیه‌نویسی‌ها، «چرا»، پروتوتایپی که جلوی کاربر می‌گذارید. یک ریپو منبع حقیقت است، اما یک ریپو جای بدی است برای توضیح یک تصمیم طراحی به مشتری. فایل این کار را می‌کند.

کاربهترین خانه
کاوش یک ایده قبل از اینکه وجود داشته باشدFigma
تعریف مقدار توکن کانونیکالکد
نقشه‌برداری فلوها، حالت‌ها، و موارد لبه‌ایFigma
حل «کدام کامپوننت درست است»کد (از طریق Code Connect / Storybook)
نقد طراحی و بررسی مشتریFigma
آنچه واقعاً برای کاربران شیپ می‌شودکد

نقطه مقابل صادقانه

Figma نمی‌میرد، و هر کسی که این تیتر را به شما می‌فروشد، یک تیتر می‌فروشد.

سه محدودیت واقعی Figma را ضروری نگه می‌دارد:

  • کد برای کاوش اولیه خصمانه است، پس مرحله واگرا هنوز روی یک بوم تعلق دارد.
  • غیر-مهندسان به جایی برای خواندن سیستم نیاز دارند، و یک ریپو آن نیست.
  • اتصال تنها زمانی کار می‌کند که یک انسان طراحی و کامپوننت کدشده را همگام نگه دارد، که یک انضباط است، نه یک پیش‌فرض.

این یک جابجایی است. جایی که حقیقت در آن زندگی می‌کند جابجا شد. جایی که تیم‌ها فکر می‌کنند جابجا نشد. «Figma مستندات است» را به عنوان روشن‌سازی نقش‌ها ببینید، نه حکمی درباره ابزار، و طراحان شما سر تکان خواهند داد به جای اینکه محکم بایستند.

چطور یک سیستم طراحی کد-اول را بدون از دست دادن تیم اداره کنید

حالت شکست فنی نیست. یک جنگ handoff است که در آن طراحان احساس تنزل مقام می‌کنند و مهندسان احساس می‌کنند که یک شغل دوم به آن‌ها داده شده. آن را به عنوان یک توالی اجرا کنید، نه یک فرمان.

  1. اول توکن‌ها را جابجا کنید، هیچ چیز دیگری نه. رنگ، فاصله، تایپ، و radius را در کد تعریف کنید و آن‌ها را بیرون همگام‌سازی کنید. بگذارید Figma آن مقادیر را مصرف کند به جای اینکه آن‌ها را اعلام کند. این کوچکترین تغییری است که ریپو را مرجع می‌کند، و هنوز هیچ کامپوننتی را لمس نمی‌کند.

  2. ده کامپوننت برتر خود را متصل کنید. از Code Connect برای اشاره دادن پرکاربردترین کامپوننت‌های Figma به همتاهای کدشده‌شان استفاده کنید، و به آن‌ها یک خانه زنده در Storybook بدهید. اقیانوس را نجوشانید. ده کامپوننتی که در همه چیز هستند بیشتر drift را در خود دارند.

ویوکسل اتصال Code Connect: یک کارت رابط کاربری اسلتی که توسط یک کابل فیروزه‌ای درخشان به یک بلوک براکت-کد مرجانی متصل شده، کامپوننت کدشده به عنوان طرف اولیه و کانونیکال روشن شده.
ویوکسل اتصال Code Connect: یک کارت رابط کاربری اسلتی که توسط یک کابل فیروزه‌ای درخشان به یک بلوک براکت-کد مرجانی متصل شده، کامپوننت کدشده به عنوان طرف اولیه و کانونیکال روشن شده.
  1. منبع را بلند اعلام کنید. یک جمله در اسناد سیستم خود بنویسید: «وقتی فایل و کد با هم اختلاف دارند، کد درست است.» ابهام چیزی است که جنگ را شروع می‌کند، نه خود قانون.

  2. طراحان را upstream نگه دارید، نه downstream. طراحان باید مالک قصد، سلسله‌مراتب، و جهت سیستم باشند، جلوتر از کد کار کنند. نباید به redlining پروداکشن تقلیل یابند. اگر کد-اول طراحان شما را به QA تبدیل کند، آن را اشتباه انجام داده‌اید.

  3. همگام‌سازی را به کسی که مسئول است بسپارید. اتصال بین طراحی و کد خودش را نگه نمی‌دارد. آن را تخصیص دهید. یک نقشه Code Connect drift‌شده بدتر از هیچ نقشه‌ای است چون با اعتماد دروغ می‌گوید.

چه کسی باید تغییر کند، و چه کسی نباید

هر تیمی نباید پیش‌فرض را برگرداند، و عامل تعیین‌کننده این است که آیا یک کدبیس واقعی شیپ می‌کنید که از طراحی drift می‌کند.

تغییر کنید اگر:

  • یک اپ پروداکشن با یک کتابخانه کامپوننت در کد دارید
  • drift مکرر طراحی-در-مقابل-ساخت می‌بینید
  • مهندسان شما قبلاً در Storybook یا یک راه‌اندازی مشابه زندگی می‌کنند

ریپو جایی است که حقیقت شما قبلاً جمع می‌شود. آن را رسمی کنید.

صفحه بازاریابی Storybook، «کامپوننت‌ها را بسازید، تست کنید و مستند کنید»، خانه زنده‌ای که یک کامپوننت کدشده در آن به چیزی تبدیل می‌شود که یک تیم می‌تواند ببیند و به آن اعتماد کند.
صفحه بازاریابی Storybook، «کامپوننت‌ها را بسازید، تست کنید و مستند کنید»، خانه زنده‌ای که یک کامپوننت کدشده در آن به چیزی تبدیل می‌شود که یک تیم می‌تواند ببیند و به آن اعتماد کند.

صبر کنید اگر:

  • خروجی شما بیشتر تحویلی‌های استاتیک، صفحات بازاریابی، یا کار ارائه است
  • هیچ چیزی به عنوان یک کتابخانه کامپوننت پایدار پیاده‌سازی نمی‌شود

اگر کدبیسی وجود ندارد که حقیقت در آن زندگی کند، «کد-اول» یک شعار است، نه یک سیستم. ماندن Figma به عنوان منبع حقیقت تصمیم درستی است.

سیگنالکد-اول را ترجیح دهیدFigma-اول بمانید
کتابخانه کامپوننت کدشده پایداربلهخیر
drift مکرر طراحی-به-ساختبلهنادر
مهندسان قبلاً در Storybookبلهخیر
خروجی بیشتر استاتیک یا کار ارائهخیربله

سوالات متداول

آیا Figma در ۲۰۲۶ هنوز منبع حقیقت است؟

برای تعداد رو به رشدی از تیم‌های محصول، نه. ریپو توکن‌ها و کامپوننت‌ها را تعریف می‌کند، و Figma آن سیستم را مستند می‌کند. برای تیم‌هایی بدون کدبیس پایدار، Figma بودن به عنوان منبع حقیقت هنوز تنظیم درستی است.

آیا کد-اول به این معناست که طراحان از Figma استفاده نمی‌کنند؟

نه. طراحان هنوز در Figma کاوش، پروتوتایپ، و مستندسازی می‌کنند. آنچه تغییر می‌کند این است که مقادیر کانونیکال و کامپوننت «درست» در کد زندگی می‌کنند، و Figma به جای اینکه آن‌ها را تعریف کند، به آن‌ها ارجاع می‌دهد.

نقش Figma Code Connect اینجا چیست؟

Code Connect به یک کامپوننت Figma اجازه می‌دهد به کامپوننت کدشده واقعی در ریپو اشاره کند. این مکانیزمی است که به سوال «کدام درست است» جواب قطعی می‌دهد، و نشان می‌دهد که Figma خودش کد را هدف اتصال می‌بیند.

توکن‌های طراحی کجا جا می‌افتند؟

توکن‌ها اهرم هستند. وقتی رنگ، فاصله، و تایپ در کد از طریق یک پایپ‌لاین مثل Style Dictionary تعریف می‌شوند و به بیرون همگام‌سازی می‌شوند، ریپو منبع این مقادیر می‌شود. جابجا کردن توکن‌ها اول کم‌ریسک‌ترین راه برای شروع است.

درباره Storybook و shadcn/ui چه؟

هر دو کد را به خانه زنده برای کامپوننت‌ها تبدیل می‌کنند. Storybook به یک کامپوننت کدشده یک خانه قابل‌مشاهده و قابل‌تست می‌دهد، و shadcn/ui کامپوننت‌ها را به عنوان کد واقعی که به ریپو کپی می‌کنید توزیع می‌کند به جای یک لایه که دوباره ترسیم می‌کنید. اینجاست که تیم‌ها اشاره می‌کنند وقتی می‌گویند کد منبع است.

نتیجه‌گیری

حقیقت در یک جا زندگی می‌کند. تنها سوال واقعی این است که آیا آن جا را عمداً انتخاب کردید یا گذاشتید به حال خود پیش برود.

برای تیم‌های بیشتری در ۲۰۲۶، ریپو آن جاست: توکن‌ها در کد، کامپوننت‌هایی که از طریق Code Connect و Storybook متصل شده‌اند، و یک حلقه ساخت که در کدبیس شروع و تمام می‌شود. Figma کارش را از دست نداد. یک کار واضح‌تر گرفت: ابتدای فرآیند و مستندات سیستم.

منبع حقیقت خود را عمداً انتخاب کنید، اقتدار را به ترتیب جابجا کنید، و بنویسید چه کسی برنده می‌شود وقتی فایل و کد با هم اختلاف دارند. این کار را بکنید و کد-اول یک ارتقاست. از آن بگذرید و یک جنگ handoff با مراحل اضافه خواهید داشت.

Want a design system where truth lives in one place? Brainy builds it.

Get Started

More from Brainy Papers

Keep reading