یک داشبورد SaaS با ردیاب پیشرفت، چک‌لیست و نوار کناری مستندات بسازید.
- صفحات: نمای کلی، کارها، تنظیمات.
- مدل داده: Task { id, title, status: 'todo' | 'in-progress' | 'done', owner, dueDate }.
- ویژگی‌ها: جستجو، فیلتر براساس وضعیت، تکمیل دسته‌ای، اعلان‌های اسنک‌بار.
- UX: طرح واکنش‌گرا، میان‌برهای صفحه‌کلید برای اقدامات سریع، حالت تاریک.

ذخیره محلی را با لایه REST API با استفاده از fetch جایگزین کن.
- نقاط پایانی: /tasks.
---
## رفع اشکال: وقتی Bolt.new شما را اشتباه می‌فهمد
- نیت را روشن کنید: «شکل داده‌ها تغییر کرده؛ لطفاً بازگردان و فقط فیلد «توضیحات» اضافه شود.»
- محدوده را محدود کنید: «فقط کامپوننت «داشبورد» را به‌روزرسانی کن، نه کل طرح.»
- مثال‌ها را ارائه دهید: «شکل JSON مورد انتظار {...} است. پارسر را مطابق به‌روزرسانی کن.»
- نام‌گذاری را قفل کنید: «فایل‌ها یا export ها تغییر نام نده.»
اگر مشکل ادامه داشت، نیازمندی‌ها را به صورت مشخصات کوتاه بازنویسی و از Bolt بخواهید اجرا را با آن تطبیق دهد.
---
## نمونه: از درخواست تا اپ اصلاح‌شده در ۵ تکرار
هدف: ردیاب شخصی مطالعه با آمار و برچسب‌ها.
- درخواست ۱: «یک ردیاب مطالعه بساز با افزودن/ویرایش کتاب، وضعیت (در حال خواندن/تمام شده)، امتیاز ۱–۵ و فیلترهای برچسبی. از UI تمیز و واکنش‌گرا استفاده کن.»
- درخواست ۲: «یک صفحه آمار اضافه کن: کل کتاب‌ها، میانگین امتیاز، برچسب‌های برتر.»
- درخواست ۳: «جستجو هنگام تایپ با debounce و برجسته کردن موارد تطبیق داده شده پیاده‌سازی کن.»
- درخواست ۴: «واردات/صادرات از طریق JSON اضافه کن. هنگام بازنویسی کادر تأیید نمایش بده.»
- درخواست ۵: «عبور accessibility: ناوبری صفحه‌کلید، حلقه‌های فوکوس، aria-live برای توست‌ها.»
نتیجه: ابزار شخصی کاملاً قابل استفاده‌ای که می‌توانید به اپ عمومی تبدیلش کنید.
---
## حرکات حرفه‌ای: میانبرها و الگوهایی که زمان را ذخیره می‌کنند
- با کامپوننت‌ها شروع کنید: «از الگوی Card، Button، Modal استفاده کن و با slots ترکیب کن.»
- زود تست درخواست کنید: «تست‌های واحد برای ابزارهای داده و تست پایه برای نمای اصلی اضافه کنید.»
- نمای ورود لاگ: «پنل توسعه‌دهنده که تماس‌های API و تغییرات وضعیت را نشان دهد اضافه کن.»
- مستندات درون خطی: «ویژگی‌ها و توابع را با JSDoc مستند کنید برای هر نماد صادر شده.»
برای مرور عمیق ساخت اپ‌های انتها به انتها با Bolt، راهنمای ویدیویی بسیار مفید است.
---
## کی از Bolt.new استفاده کنیم و کی از توسعه سنتی؟
از Bolt.new زمانی استفاده کنید که:
- به نمونه اولیه یا ابزار داخلی سریع نیاز دارید.
- این هفته با ذینفعان UX را اعتبارسنجی می‌کنید.
- کد پایه زمان‌بر است و کار را کند می‌کند.
زمان استفاده از روش سنتی:
- زیرساخت سفارشی عمیق یا هماهنگی چندسرویس پیچیده لازم دارید.
- محدودیت‌های امنیتی، انطباق یا عملکرد نیاز به کد بهینه‌سازی شده دارد.
- از ابتدا یک کدبیس طولانی‌مدت با الگوهای سختگیرانه می‌سازید.
---
## نکته قابل توجه: با [Sider.AI](https://sider.ai) قدرت درخواست‌هایتان را افزایش دهید
اگر پیش از شروع مشخصات، داستان کاربر یا معیارهای پذیرش بنویسید، خروجی‌های تمیزتری از Bolt.new می‌گیرید. [Sider.AI](https://sider.ai) به شما کمک می‌کند ایده‌های خام را به درخواست‌های شفاف تبدیل کنید، ویژگی‌ها را به تیکت تقسیم کنید و حتی تست‌هایی تولید کند که می‌توانید مستقیماً در چت Bolt جای‌گذاری کنید. راستی، استفاده از «چک‌لیست» یا قالب مشخصات، خطاها را کاهش و تکرارها را کم می‌کند.
این طرح کلی آماده برای [Sider.AI](https://sider.ai) را امتحان کنید:
- بیان مسئله
- نقش‌ها و مجوزهای کاربر
- مدل داده با فیلدها/نوع‌ها
- جریان‌های بحرانی کاربر
- موارد لبه و نیازمندی‌های غیرفنی
---
## گام‌های بعدی: دفترچه بازی ۳۰ دقیقه‌ای شما
- یک ایده اپ کوچک انتخاب کنید (داشبورد، ردیاب یا مینی CMS).
- قالب درخواست شروع را جای‌گذاری و شخصی‌سازی کنید.
- در ۵–۷ درخواست متمرکز تکرار کنید و بعد از هر تغییر تست کنید.
- دسترسی، حالت‌های خطا و تست پایه اضافه کنید.
- نسخه اول را ارسال کنید؛ بازخورد جمع‌آوری و دوباره تکرار کنید.
خواهید دید سریع‌تر و حتی لذت‌بخش‌تر از ساخت از صفر با دست است.
---
## منابع و یادگیری بیشتر
- معرفی رسمی Bolt (جریان کاری درخواست تا محصول).
- ویدیوی آموزشی گام‌به‌گام کامل درباره استفاده از Bolt.new.
- نکات جامعه: اجتناب از بازنویسی‌های ناخواسته پرس‌وجو و تکرار ایمن.
### سوالات متداول
س1: Bolt.new برای چیست؟
Bolt.new یک IDE مبتنی بر هوش مصنوعی است که درخواست‌های متنی را به اپ‌های عملیاتی با پیش‌نمایش زنده تبدیل می‌کند. مناسب نمونه‌سازی سریع، ابزارهای داخلی، داشبورد و اثبات مفهوم UI-محور است.
س2: چطور پروژه‌ای در Bolt.new شروع کنم؟
bolt.new را باز کنید، وارد شوید و اپ خود را در یک درخواست واضح توصیف کنید. Bolt کد، فایل‌ها و پیش‌نمایش زنده ایجاد می‌کند تا از طریق گفتگو یا ویرایش مستقیم تکرار کنید.
س3: چطور درخواست‌های خوبی برای Bolt.new بنویسم؟
ویژگی‌ها، مدل داده، انتظارات UX و محدودیت‌ها را مشخص کنید. مثلاً فیلدها، صفحات و رفتارها را تعریف کنید؛ سپس در هر تکرار تغییرات کوچک و متمرکز بخواهید.
س4: آیا می‌توانم برنامه‌های Bolt.new را به APIهای واقعی متصل کنم؟
بله. ابتدا با داده‌های جعلی شروع کنید و بعد درخواست مبدل REST یا GraphQL دهید، که نوع‌ها را حفظ و مدیریت خطا را بهینه کند. این روش باعث سریع‌تر و ایمن‌تر بودن تکرارهای اولیه می‌شود.
س5: چه زمانی نباید از Bolt.new استفاده کنم؟
اگر اپ شما نیازمند رعایت سختگیرانه قوانین، هماهنگی پیچیده چندسرویس یا عملکرد بهینه بسیار بالا است، بهتر است از ابتدا از روش توسعه سنتی استفاده کنید.