دليل مفصل لإعداد البيئة وتشغيل الخادم المحلي
المتطلبات المسبقة
قبل البدء، تأكد من تثبيت ما يلي:
- Node.js (الإصدار 22 أو أعلى، يُنصح بإصدار LTS)
- Git (التحكم في الإصدارات)
- IDE (يُنصح بـ VS Code)
الخطوة 1: عمل Fork للمشروع
ابدأ بإنشاء نسختك الخاصة من المستودع على GitHub.
- انتقل إلى مستودع Hogwarts
- انقر على زر "Fork" في الزاوية العلوية اليمنى
الخطوة 2: إنشاء Fork الخاص بك
تأكد من أن اسم المستودع متاح وأنشئ Fork الخاص بك.
- تحقق من أن اسم المستودع متاح
- احتفظ بالإعدادات الافتراضية (إلا إذا كنت بحاجة لتغييرها)
- انقر على "Create fork" لإتمام العملية
الخطوة 3: فتح VS Code
شغّل محرر الكود وتحضّر لاستنساخ المستودع.
- افتح نافذة جديدة في VS Code
- انقر على أيقونة Git في الشريط الجانبي الأيسر
- انقر على Clone
- الصق عنوان URL للمستودع الخاص بك أو اتصل بـ GitHub من شريط البحث العلوي
الخطوة 4: الاستنساخ من GitHub
احصل على عنوان URL لمستودعك المُفَرَّع واستنسخه محلياً.
- ارجع إلى مستودعك المُفَرَّع على GitHub
- انقر على زر "Code" الأخضر
- انسخ عنوان HTTPS URL إلى الحافظة
- الصقه في مربع حوار الاستنساخ في محررك
الخطوة 5: اختيار الدليل المحلي
اختر أين تريد تخزين المشروع على جهازك.
- اختر دليلاً لمشاريعك (مثل
~/Documents/projects/)
- أنشئ مجلداً جديداً إذا لزم الأمر
- حدد الموقع وأكد
الخطوة 6: الفتح في المحرر
افتح المشروع المستنسخ في محرر الكود الخاص بك.
- انتظر اكتمال عملية الاستنساخ
- انقر على "Open" عند المطالبة
- مشروعك جاهز الآن للتطوير
الخطوة 7: تثبيت التبعيات
استخدم pnpm لتثبيت جميع التبعيات المطلوبة.
- افتح الطرفية المدمجة (
Ctrl/Cmd + ~)
- شغّل أمر التثبيت:
pnpm install
- انتظر اكتمال التثبيت
الخطوة 8: إعداد البيئة
- أنشئ ملف
.env في المجلد الجذر
- الصق المحتوى من مجموعة WhatsApp
الخطوة 9: بدء خادم التطوير
شغّل خادم التطوير وشاهد تطبيقك يعمل.
- شغّل أمر التطوير:
pnpm dev
- انتظر بدء الخادم
- افتح متصفحك على
http://localhost:3000
