ویرگول
ورودثبت نام
آرش فدائی
آرش فدائیتوسعه‌دهنده ارشد وب و متخصص PHP
آرش فدائی
آرش فدائی
خواندن ۴ دقیقه·۳ ماه پیش

چگونه Cursor را به Figma متصل کنیم!

چگونه Cursor را به Figma متصل کنیم!
چگونه Cursor را به Figma متصل کنیم!

چه چیزهایی نیاز دارید؟

برای شروع به موارد زیر نیاز دارید:

  • Cursor با فعال بودن پلاگین Figma یا سرور MCP مربوط به Figma

  • یک حساب Figma با دسترسی به فایل طراحی موردنظر

  • یک پروژه محلی؛ برای مثال WordPress Theme، پروژه Laravel/Vue/React یا HTML/CSS ساده

  • آدرس فایل Figma؛ اگر قصد دارید یک فریم مشخص را انتخاب کنید، بهتر است URL شامل node-id باشد.


مرحله ۱: احراز هویت Figma در Cursor

ابتدا باید اتصال Figma را در Cursor برقرار کنید.

  1. Cursor را باز کنید و مطمئن شوید Figma MCP Server در دسترس است.

  2. اگر ابزارها با خطای احراز هویت مواجه شدند، فرایند Authentication مربوط به Figma را که نمایش داده می‌شود تکمیل کنید.

  3. دسترسی را با یک بررسی ساده تأیید کنید؛ برای مثال از Cursor بخواهید حساب Figma متصل‌شده را بررسی و تأیید کند.

بدون انجام احراز هویت، حتی اگر Promptهای شما کاملاً صحیح باشند، عملیات خواندن یا نوشتن اطلاعات طراحی با خطا مواجه خواهد شد.


مرحله ۲: دو مسیر اصلی اتصال Figma و Cursor را بشناسید

به‌طور کلی دو گردش‌کار مهم وجود دارد:

  • Design → Code: گرفتن یک فریم از Figma و پیاده‌سازی آن در پروژه

  • Code → Design: ارسال ساختار یک صفحه یا کامپوننت از کد به Figma برای بررسی و بازبینی

در بیشتر پروژه‌های طراحی وب، معمولاً کار را با مسیر Design → Code شروع می‌کنید.


مرحله ۳: پیاده‌سازی Design → Code به روش صحیح

زمانی که URL مربوط به یک فایل Figma را در Cursor قرار می‌دهید، باید اطلاعات زیر را از آن استخراج کنید:

  • مقدار fileKey از بخش /design/:fileKey/...

  • مقدار nodeId از پارامتر node-id=1-2

در node-id باید خط تیره (-) را به دونقطه (:) تبدیل کنید؛ بنابراین:

1-2

به:

1:2

تبدیل می‌شود.

سپس می‌توانید از Cursor بخواهید همان Node را در پروژه پیاده‌سازی کند.

یک Prompt مناسب می‌تواند چیزی شبیه این باشد:

Implement this Figma frame in our existing project. URL: https://www.figma.com/design/FILE_KEY/Name?node-id=12-34 Rules: - Reuse existing components and CSS variables - Match spacing and typography from the design - Do not invent a parallel design system - Keep the change limited to the landing hero section

در پشت صحنه، Cursor باید ابتدا Skill مربوط به Design-to-Code را بارگذاری کند و سپس ابزارهای دریافت Design Context را برای Node موردنظر اجرا کند.

نکته مهم این است که Markup و کدی که از طراحی دریافت می‌کنید را به‌عنوان Reference در نظر بگیرید، نه کدی که بدون بررسی مستقیماً وارد Production کنید.


مرحله ۴: از Design Tokenها و Componentهای موجود پروژه استفاده کنید

اگر وب‌سایت یا اپلیکیشن شما از قبل دارای موارد زیر است:

  • متغیرهای CSS مانند:

--color-accent
  • کامپوننت‌های آماده مانند Button، Card و Section

  • سیستم Grid و Layout مشخص

به Cursor بگویید استایل‌های Figma را با همین Primitiveهای موجود در پروژه تطبیق دهد.

این کار اهمیت زیادی دارد؛ چون از ایجاد یک Design System جداگانه و یک‌بارمصرف توسط AI جلوگیری می‌کند؛ سیستمی که بعداً ممکن است با ساختار اصلی Theme یا پروژه شما تداخل داشته باشد.


مرحله ۵: پروژه را بخش‌به‌بخش پیاده‌سازی کنید

بهتر است از Cursor نخواهید کل یک وب‌سایت مارکتینگ را در یک مرحله پیاده‌سازی کند.

به‌جای آن، پروژه را به بخش‌های کوچک‌تر تقسیم کنید:

  1. Hero

  2. Feature Grid

  3. Pricing

  4. Footer

بعد از پیاده‌سازی هر بخش، موارد زیر را بررسی کنید:

  • رفتار Responsive

  • دسترسی‌پذیری (Accessibility)

  • سازگاری با ساختار فعلی پروژه

  • نام‌گذاری Classها مطابق Convention پروژه

  • استفاده صحیح از Componentهای موجود

این روش باعث می‌شود کنترل بیشتری روی خروجی AI داشته باشید و پیدا کردن مشکلات نیز بسیار ساده‌تر شود.


مرحله ۶: همگام‌سازی اختیاری Code → Figma

گاهی اوقات اعضای تیم یا Stakeholderها ترجیح می‌دهند طراحی را به‌جای محیط Staging، مستقیماً در Figma بررسی کنند.

در چنین شرایطی می‌توانید از Cursor بخواهید:

  • ابتدا Design System موجود را جست‌وجو و بررسی کند.

  • بر اساس صفحه فعلی پروژه، یک Screen در Figma ایجاد یا به‌روزرسانی کند.

  • به‌جای ایجاد عناصر کاملاً جدید، از Library Components و Variables موجود استفاده کند.

این روش به‌خصوص قبل از یک Redesign بزرگ یا هنگام آماده‌سازی برای تحویل پروژه به تیم طراحی بسیار کاربردی است.


بهترین روش‌ها

برای اینکه اتصال Cursor و Figma بهترین نتیجه را داشته باشد، این نکات را رعایت کنید:

  • همیشه URL دقیق فریم موردنظر را همراه با node-id ارائه کنید.

  • Stack پروژه را مشخص کنید؛ مثلاً WordPress Theme، React، Blade و غیره.

  • از Cursor بخواهید Tokenها و Componentهای موجود پروژه را مجدداً استفاده کند.

  • بررسی نسخه Desktop و Mobile را به‌صورت صریح درخواست کنید.

  • Assetهای تولیدشده و CSSهای یک‌بارمصرف را بدون دلیل وارد Global Styles نکنید.


اشتباهات رایج

۱. اتصال Figma بدون انجام Authentication

ممکن است Figma به Cursor متصل شده باشد، اما تا زمانی که احراز هویت انجام نشود، ابزارهای MCP نمی‌توانند اطلاعات طراحی را به‌درستی دریافت کنند.

۲. استفاده از کل صفحه به‌جای یک فریم مشخص

اگر فقط به پیاده‌سازی Hero Section نیاز دارید، بهتر است Node مربوط به همان بخش را در اختیار Cursor قرار دهید، نه کل صفحه.

۳. اجازه دادن به Cursor برای ساخت Design System جدید

اگر پروژه شما از قبل رنگ‌ها، Typography، Buttonها و Componentهای مشخصی دارد، اجازه ندهید Cursor برای هر صفحه یک سیستم طراحی جدید ایجاد کند.

۴. تبدیل مستقیم Prototype به CSS

Prototypeهای Figma همیشه قرار نیست دقیقاً همان‌طور که طراحی شده‌اند در CSS پیاده‌سازی شوند.

گاهی یک تعامل پیچیده در Prototype را می‌توان با یک ساختار ساده‌تر و استاندارد HTML/CSS/JavaScript پیاده‌سازی کرد.

۵. نادیده گرفتن Accessibility

فقط شبیه بودن خروجی به Figma کافی نیست.

مواردی مانند:

  • Focus State

  • Contrast

  • Semantic HTML

  • Heading Structure

  • Keyboard Navigation

هم باید بررسی شوند.


برای گرفتن بهترین نتیجه:

یک‌بار احراز هویت کنید، فریم‌های مشخص را از Figma دریافت کنید، آن‌ها را با Design System واقعی پروژه تطبیق دهید و رابط کاربری را بخش‌به‌بخش پیاده‌سازی کنید.

این روش باعث می‌شود استفاده از AI در فرآیند Design-to-Code به‌جای ایجاد کدهای شلوغ و غیرقابل‌کنترل، واقعاً به توسعه سریع‌تر و باکیفیت‌تر کمک کند.

Design Systemبرنامه نویسیدیزاین
۰
۰
آرش فدائی
آرش فدائی
توسعه‌دهنده ارشد وب و متخصص PHP
شاید از این پست‌ها خوشتان بیاید