وایبکدینگ با پرتو
پرامپتهای آماده برای ساخت پروژه Next.js از صفر یا مهاجرت — برای وایبکدرها و توسعهدهندگان Next.js
دیزاین سیستم پرتو برای همکاری با هوش مصنوعی طراحی شده است. با پلاگین Claude Code، میتوانید UI صحیح، یکپارچه، و RTL-first بسازید — چه وایبکدر باشید چه توسعهدهنده Next.js با تجربه.
پیشنیازها
| پیشنیاز | توضیح |
|---|---|
| Claude Code | نصب CLI یا افزونه VS Code |
| پلاگین پرتو | راهنمای نصب پلاگین |
| پروژه Next.js | App Router (نسخه ۱۴ یا بالاتر) |
پلاگین، Claude را با دانش کامل کامپوننتها، قوانین RTL، و سیستم رنگ مجهز میکند — بدون نیاز به توضیح اضافه در هر پرامپت.
راهاندازی پروژه از صفر
پروژه Next.js آماده دارید اما پرتو نصب نیست؟ این پرامپت را در Claude Code اجرا کنید:
پروژه Next.js App Router جدیدم را با دیزاین سیستم پرتو راهاندازی کن.
نوع پروژه: [مثلاً: داشبورد تحلیل شبکههای اجتماعی برای برندها]
پلتفرمهای هدف: [مثلاً: اینستاگرام، تلگرام، یوتیوب]
تم پیشفرض: dark
مراحل:
۱. /parto:setup اجرا کن — next.config.mjs، tailwind.config.ts، و app/layout.tsx را تنظیم کن
۲. app/layout.tsx را با html lang="fa" dir="rtl" و ThemeProvider بساز
۳. یک app/(dashboard)/layout.tsx با Sidebar ناوبری فارسی بساز
۴. صفحه اول را scaffold کن: /parto:page dashboardمهاجرت پروژه موجود
میخواهم پروژه Next.js App Router موجودم را به دیزاین سیستم پرتو مهاجرت دهم.
۱. /parto:setup اجرا کن — پکیج را نصب و تنظیمات را اعمال کن
۲. /parto:review اجرا کن — بررسی کامل کد با اولویتبندی
۳. با app/layout.tsx شروع کن، بعد صفحه به صفحه جایگزین کنمهاجرت یک صفحه (برای پروژههای بزرگ)
فقط این صفحه را به پرتو مهاجرت بده: app/[path]/page.tsx
/parto:review app/[path]/page.tsx
مشکلات را فهرست کن، سپس یک به یک رفع کن — از تغییرات breaking شروع نکن.پرامپتهای App Router
layout و ساختار
یک layout کامل Next.js App Router برای route group داشبورد بساز:
- app/(dashboard)/layout.tsx
- Sidebar با ناوبری فارسی
- Header با نام کاربر و دکمه تغییر تم
- محتوای اصلی با Suspense boundary
- تم: dark، پلتفرمها: اینستاگرام، تلگرامServer Component با داده واقعی
یک Server Component برای صفحه [نام صفحه] بساز که:
- در app/[route]/page.tsx قرار میگیرد
- داده را از API/دیتابیس fetch میکند (async/await)
- از کامپوننتهای پرتو برای نمایش استفاده میکند
- loading.tsx جداگانه با Skeleton پرتو دارد
- error.tsx جداگانه با ErrorState پرتو داردloading.tsx با Skeleton
یک loading.tsx برای صفحه [نام صفحه] بساز.
از Skeleton کامپوننت پرتو استفاده کن.
ساختار را دقیقاً مثل صفحه اصلی بساز تا layout shift نداشته باشیم.error.tsx
یک error.tsx برای بخش [نام بخش] بساز.
از ErrorState کامپوننت پرتو استفاده کن.
دکمه retry داشته باشد که error.reset() را صدا بزند.
پیام خطا به فارسی رسمی باشد.Server Action در فرم
یک فرم با Server Action بساز برای [عملیات].
- فیلدها: [لیست فیلدها]
- Server Action در app/actions/[name].ts
- validation با zod
- وضعیت pending با useFormStatus
- پیام موفقیت/خطا با Sonner پرتو
- کامپوننتهای فرم از پرتو: Input، Select، Buttonپرامپتهای موردی
داشبورد
یک صفحه داشبورد Next.js App Router کامل بساز:
- ۴ MetricCard: دنبالکنندگان، نرخ تعامل، تعداد پست، ریچ
- PartoLineChart: روند ۳۰ روزه تعامل
- PartoBarChart: مقایسه پلتفرمها
- DataTable: ۵ پست پرتعامل اخیر
- دادههای نمونه فارسی واقعی
- Server Component با loading.tsxلیست اینفلوئنسر
صفحه لیست اینفلوئنسر با پرتو بساز (App Router):
- DataTable با ستونها: نام، پلتفرم (SocialPlatformBadge)، دسته (نانو/میکرو/ماکرو/مگا)
- ستون نرخ تعامل: EngagementRate با category prop
- ستون سنتیمنت: SentimentBadge
- FilterBar بالای جدول: فیلتر پلتفرم، دسته، بازه زمانی
- SearchInput برای جستجو
- Pagination کنترلشده
- loading.tsx با Skeletonپروفایل اینفلوئنسر
صفحه پروفایل کامل اینفلوئنسر بساز (App Router):
- ProfileCard در بالا با آمار اصلی
- ۳ MetricCard: دنبالکنندگان، نرخ تعامل، تعداد پست
- PartoLineChart: تاریخچه ۶ ماهه نرخ تعامل
- Tabs: پستهای اخیر / تحلیل مخاطبان / کمپینها
- InstagramPost در تب پستهای اخیر
- Server Component — params از URL میگیردفرم
فرم [نوع فرم] با پرتو بساز:
- فیلدها: [لیست کنید]
- Client Component با react-hook-form + zod
- کامپوننتها: Input، Select، DatePicker، Switch از پرتو
- دکمه submit با loading state
- Sonner برای پیام موفقیت/خطا
- دکمه cancel که به صفحه قبل برمیگرددنمودار
[نوع: PartoLineChart/PartoBarChart/PartoPieChart/PartoAreaChart] بساز:
- داده: [توضیح دهید]
- عنوان فارسی
- isLoading prop برای حالت loading
- Empty state اگر data آرایه خالی باشد
- width="100%" برای ریسپانسیوپرامپت مرجع سریع
این پرامپت را ابتدای هر session بفرستید:
پروژهام از @parto-system-design/ui روی Next.js App Router استفاده میکند.
قوانین:
- رنگها از سیستم پرتو: text-light نه text-gray-500، bg-surface-100 نه bg-gray-100
- RTL: ms/me/ps/pe بهجای ml/mr/pl/pr
- تم: dark
- پلتفرمهای فعال: اینستاگرام، تلگرام
- Server Components پیشفرض، "use client" فقط جایی که لازم استنکات برای نتایج بهتر
| کار | توضیح |
|---|---|
| پلاگین داشته باشید | بدون پلاگین، Claude کامپوننتهای اشتباه انتخاب میکند |
| نوع Component مشخص کنید | "Server Component" یا "Client Component" بگویید |
| پروژه را توصیف کنید | "داشبورد تحلیل اینستاگرام" بهتر از "یک صفحه" است |
| پلتفرم مشخص کنید | کامپوننتهای domain-specific (EngagementRate، SocialPlatformBadge) را فعال میکند |
از /parto:review استفاده کنید | بعد از هر تغییر بزرگ، کد را بررسی کنید |
| داده فارسی بخواهید | "داده نمونه فارسی" بگویید تا نامها و اعداد واقعی باشند |
| loading/error بخواهید | همیشه loading.tsx و error.tsx را در کنار page.tsx بخواهید |
صفحات مرتبط
- پلاگین Claude Code — نصب و راهاندازی پلاگین
- نصب و راهاندازی — نصب دستی پکیج
- مهاجرت — راهنمای مهاجرت دستی
- الگوهای UI — الگوهای آماده برای App Router