راهنماهای سناریومحور
هر راهنما از یک کار واقعی شروع میشود و با یک صفحهٔ کارکننده تمام میشود: دستورهایی که میزنی، پرامپتی که به ایجنت میدهی و چیزی که در پایان باید ببینی. پرامپتهای آماده برای کارهای کوچکتر در کتابخانهٔ پرامپت هستند.
صفحهٔ ورود با رمز یکبارمصرف
حدود ۱۰ دقیقهیک صفحهٔ ورود کامل با شمارهٔ موبایل و کد تأیید، با برند خودت، بدون نوشتن دستی هیچ کامپوننتی.
- ۱
دیگ را نصب کن. init رنگ برند، فونت و ایجنتت را میپرسد و فایل قواعد ایجنت را میسازد.
npx digdesign@latest init - ۲
ایجنت را به MCP دیگ و دیگچه وصل کن (دستور هر ایجنت در صفحهٔ راهاندازی ایجنت است).
- ۳
این را به ایجنت بده:
با MCP دیگ صفحهٔ ورود با شمارهٔ موبایل و رمز یکبارمصرف بساز. اول list_blocks را ببین و از بلاک login-otp شروع کن، چکلیست adapt آن را انجام بده، آیکونها را از دیگچه بگیر و در پایان کد را با review_code بازبینی کن.
- ۴
صفحه را در موبایل و دسکتاپ، روشن و تیره ببین. اگر ایجنت جایی از قاعدهها رد شد، همان را با review_code به او نشان بده.
داشبورد مالی از یک بلاک آماده
حدود ۱۵ دقیقهداشبورد تراکنشها و موجودی با نمودار، کارت آماری و جدول، با دادهٔ فارسی و ارقام درست.
- ۱
صفحهٔ بلاک داشبورد مالی را باز کن: کد کامل و یک دستور نصب برای همهٔ کامپوننتهایی که لازم دارد آنجاست. ایجنتِ وصل به MCP همین را با get_block میگیرد.
- ۲
بعد از ایجنت بخواه داده را با دادهٔ خودت عوض کند:
با get_block از بلاک dashboard-finance شروع کن و آن را با دادهٔ API ما (endpoint: /api/transactions) وصل کن. مبلغها تومان با جداکنندهٔ هزارگان و ارقام فارسی، تاریخها شمسی و نسبی. قبل از تحویل get_page_patterns برای dashboard را بخوان و کد را با review_code بازبینی کن.
- ۳
رنگ وضعیتها را چک کن: ورودی سبز، خروجی رنگ متن عادی، و هیچ وضعیتی فقط با رنگ گفته نشده باشد.
فرم چندمرحلهای با اعتبارسنجی فارسی
حدود ۱۵ دقیقهثبتنام سهمرحلهای با کد ملی، موبایل و تاریخ تولد شمسی، با خطاهای انسانی کنار هر فیلد.
- ۱
از بلاک ثبتنام مرحلهای شروع کن (کد و دستور نصب در صفحهٔ بلاک، یا get_block در MCP).
- ۲
از ایجنت بخواه مرحلهها و اعتبارسنجی را بسازد:
فرم ثبتنام سهمرحلهای بساز: اطلاعات فردی (نام، کد ملی، تاریخ تولد شمسی)، تماس (موبایل، ایمیل) و تأیید. از TextField با label و description استفاده کن، خطا را بعد از ترک فیلد و کنار همان فیلد نشان بده («کد ملی ۱۰ رقم است، ۹ رقم وارد شده»). همهٔ کنترلها در ControlSizeProvider size=xl باشند و در پایان review_code بزن.
- ۳
فرم نیمهپر را رفرش کن؛ داده نباید بیصدا پاک شود.
تم برند خودت: از یک رنگ تا فیگما
حدود ۵ دقیقهیک رنگ برند بده و تم روشن و تیرهٔ کامل با کنتراست تضمینی بگیر، هم در کد هم در فیگما.
- ۱
در صفحهٔ راهاندازی ایجنت رنگ برند را بزن یا از پالت انتخاب کن و پیشنمایش زنده را ببین.
- ۲
یا مستقیم در پروژه:
npx digdesign@latest theme brand "#2563eb" - ۳
برای فیگما، توکنها را در قالب DTCG بگیر و هر حالت را یک mode وارد کن:
https://docs.digdesign.ir/api/tokens?mode=light&brand=%232563eb
دستیار هوش مصنوعی داخل محصول
حدود ۲۰ دقیقهصفحهٔ گفتوگو با دستیار که وضعیت کارش را نشان میدهد، منبع میآورد و پیش از کار پرهزینه تأیید میگیرد.
- ۱
از بلاک چت هوش مصنوعی شروع کن (کد و دستور نصب در صفحهٔ بلاک، یا get_block در MCP).
- ۲
از ایجنت بخواه تجربه را کامل کند:
بلاک ai-chat را به API ما وصل کن. وضعیت کار با Thinking و ToolChips دیده شود، پاسخ با StreamingText بیاید و دکمهٔ ارسال در حین پاسخ «توقف» شود، منبعها با ContextCards کنار پاسخ باشند و قبل از هر پرداخت یا حذف ApprovalCard نشان بده. قاعدههای get_page_patterns برای chat را رعایت کن و با review_code بازبینی کن.
- ۳
شش لحظهٔ راهنمای طراحی تجربهٔ AI را روی صفحه چک کن.