شغّل لوحة التحكم من دون Docker
ثبّت لوحة التحكم وشغّلها باستخدام Node.js و Yarn، للتطوير أو كبناء إنتاج.
قبل أن تبدأ: ثبّت Node.js 20.9 أو أحدث، ويُنصح بالإصدار 22 أو 24. لا تحتاج إلى قاعدة بيانات ولا إلى ملف .env في أول تشغيل.
نزّل القالب وفك ضغطه كما في دليل Docker، ثم افتح طرفية داخل المجلد dashboard-template-1.
شغّل خادم التطوير
فعّل Corepack
يشغّل Corepack إصدار Yarn الذي يثبّته المشروع، وهو Yarn 4.12.0. تحتاج إلى ذلك مرة واحدة فقط على كل جهاز.
الطرفيةcorepack enableتواجه مشكلة؟ثبّت الاعتماديات
الطرفيةفيdashboard-template-1yarn installالنتيجة المتوقعة: ينتهي Yarn بالكلمة
تواجه مشكلة؟Doneويظهر مجلدnode_modules.شغّلها وافتح لوحة التحكم
الطرفيةفيdashboard-template-1yarn devالمنفذ مستخدم بالفعل؟
إذا توقف بالرسالة
المنفذ مستخدم بالفعلEADDRINUSE: address already in use :::3030، فهناك برنامج آخر يستخدم المنفذ 3030. أوقفه، أو شغّل على منفذ آخر بالأمرyarn dev -p 3041وافتح localhost:3041محلي.النتيجة المتوقعة: يفتح localhost:3030/
تواجه مشكلة؟en/ loginمحلي صفحة تسجيل الدخول. وتُعاد تحميلها تلقائيًا عند حفظ أي ملف.
سجّل الدخول بالحساب المذكور في دليل Docker. وأوقف الخادم بالضغط على Ctrl+C في طرفيته.
شغّل بناء الإنتاج
خادم التطوير للتعديل. لتفحص لوحة التحكم كما يراها مستخدموك، ابنِها مرة واحدة ثم قدّم البناء:
dashboard-template-1yarn build
yarn startيستجيب أيضًا على localhost:3030/yarn start -p 3041. شغّل yarn build من جديد بعد كل تغيير: فـ yarn start يقدّم آخر بناء كما كان.
السكربتات
| السكربت | وظيفته |
|---|---|
yarn dev | خادم التطوير على المنفذ 3030 |
yarn build | بناء الإنتاج |
yarn start | يقدّم بناء الإنتاج على المنفذ 3030 |
yarn lint | يفحص الكود باستخدام ESLint وقواعد Next.js |
yarn type-check | يتحقق من أنواع TypeScript |
إعداداتك الخاصة
كل إعداد اختياري. لتغيير أحدها، انسخ .env.example إلى .env.local وعدّله هناك. تُقرأ القيم عند تشغيل التطبيق في وضع التطوير وعند البناء، لذا أعد تشغيل yarn dev أو شغّل yarn build من جديد بعد أي تغيير.
dashboard-template-1cp .env.example .env.local