دليل البدء السريع

ابدأ مشروعك بهيكلية FSD في دقائق

‏FSD CLI أداة سطر أوامر تنشئ مشروع React أو Next.js أو Vue أو Nuxt أو SvelteKit بهيكلية Feature-Sliced Design كاملة، ثم تولّد الشرائح (features وentities وwidgets وpages) داخل المشروع كلما كبر. باقي التوثيق متاح بالإنجليزية حاليًا.

المتطلبات

تحتاج Node.js بإصدار 22.12.0 أو أحدث. مشاريع Nuxt وSvelteKit تحتاج 22.22.2 أو أحدث. تحقّق من الإصدار المثبّت:

bash

node --version

إنشاء مشروع جديد

شغّل الأمر من المجلد الذي تريد إنشاء المشروع بداخله، واختر الإطار وأدوات الحالة والنماذج من المعالج التفاعلي:

bash

npx create-fsd-architecture@latest my-app

أو اقبل الإعدادات الافتراضية مباشرةً بتحديد الإطار:

bash

npx create-fsd-architecture@latest my-app --framework react-vite --yes

توليد الشرائح

من جذر المشروع، يقرأ المولّد ملف fsd.config.json ويكتب ملفات مناسبة لإطارك. استخدم --dry-run لمعاينة الملفات قبل كتابتها:

bash

npx create-fsd-architecture@latest -g entity product --dry-run
npx create-fsd-architecture@latest -g feature cart
npx create-fsd-architecture@latest -g widget navbar
npx create-fsd-architecture@latest -g page catalog

كل شريحة تحصل على ملف index.ts يمثّل واجهتها العامة، ولا تستورد الطبقات الأخرى منها إلا عبره.

الترقية الآمنة

تثبيت إصدار أحدث من الأداة لا يغيّر مشروعك تلقائيًا. اعرض خطة الترقية أولًا، ثم طبّقها عندما تخلو من التعارضات:

bash

npx create-fsd-architecture@latest upgrade --dry-run
npx create-fsd-architecture@latest upgrade --yes

الخطوات التالية

ملف الإعداد fsd.config.json (بالإنجليزية)
دليل مولّد الشرائح (بالإنجليزية)
تفاصيل الترقية الآمنة (بالإنجليزية)