create-next-app
أسهل طريقة للبدء مع Next.js هي باستخدام create-next-app
. هذه الأداة عبر سطر الأوامر تمكنك من البدء بسرعة في بناء تطبيق Next.js جديد، مع كل الإعدادات الجاهزة لك.
يمكنك إنشاء تطبيق جديد باستخدام قالب Next.js الافتراضي، أو باستخدام أحد الأمثلة الرسمية لـ Next.js.
الوضع التفاعلي
يمكنك إنشاء مشروع جديد بشكل تفاعلي عن طريق تنفيذ:
npx create-next-app@latest
yarn create next-app
pnpm create next-app
bunx create-next-app
ثم سيتم سؤالك الأسئلة التالية:
ما اسم مشروعك؟ my-app
هل ترغب في استخدام TypeScript؟ لا / نعم
هل ترغب في استخدام ESLint؟ لا / نعم
هل ترغب في استخدام Tailwind CSS؟ لا / نعم
هل ترغب في استخدام دليل `src/`؟ لا / نعم
هل ترغب في استخدام موجه التطبيق؟ (موصى به) لا / نعم
هل ترغب في تخصيص اسم مستعار للاستيراد الافتراضي (@/*)؟ لا / نعم
بعد الإجابة على الأسئلة، سيتم إنشاء مشروع جديد مع التكوين الصحيح بناءً على إجاباتك.
الوضع غير التفاعلي
يمكنك أيضًا تمرير وسائط سطر الأوامر لإعداد مشروع جديد بشكل غير تفاعلي.
بالإضافة إلى ذلك، يمكنك إلغاء الخيارات الافتراضية عن طريق إضافة بادئة --no-
(مثل --no-eslint
).
انظر create-next-app --help
:
الاستخدام: create-next-app <دليل-المشروع> [خيارات]
الخيارات:
-V, --version عرض رقم الإصدار
--ts, --typescript
تهيئة المشروع كمشروع TypeScript. (افتراضي)
--js, --javascript
تهيئة المشروع كمشروع JavaScript.
--tailwind
تهيئة مع إعدادات Tailwind CSS. (افتراضي)
--eslint
تهيئة مع إعدادات ESLint.
--app
تهيئة كمشروع يستخدم موجه التطبيق.
--src-dir
تهيئة داخل دليل `src/`.
--import-alias <اسم-مستعار-للاستيراد>
تحديد اسم مستعار للاستيراد (افتراضي "@/*").
--use-npm
إخبار CLI صراحةً باستخدام npm لتهيئة التطبيق
--use-pnpm
إخبار CLI صراحةً باستخدام pnpm لتهيئة التطبيق
--use-yarn
إخبار CLI صراحةً باستخدام Yarn لتهيئة التطبيق
--use-bun
إخبار CLI صراحةً باستخدام Bun لتهيئة التطبيق
-e, --example [اسم]|[رابط-github]
مثال لاستخدامه في تهيئة التطبيق. يمكنك استخدام اسم مثال
من مستودع Next.js الرسمي أو رابط GitHub عام. يمكن أن يستخدم الرابط
أي فرع و/أو مسار فرعي
--example-path <مسار-المثال>
في حالات نادرة، قد يحتوي رابط GitHub على اسم فرع يحتوي
على شرطة مائلة (مثل bug/fix-1) ومسار المثال (مثل foo/bar).
في هذه الحالة، يجب تحديد مسار المثال بشكل منفصل:
--example-path foo/bar
--reset-preferences
إخبار CLI صراحةً بإعادة تعيين أي تفضيلات مخزنة
-h, --help عرض معلومات الاستخدام
لماذا تستخدم Create Next App؟
create-next-app
يسمح لك بإنشاء تطبيق Next.js جديد خلال ثوانٍ. يتم صيانته رسميًا من قبل مطوري Next.js، ويتضمن عددًا من المزايا:
- تجربة تفاعلية: تشغيل
npx create-next-app@latest
(بدون وسائط) يطلق تجربة تفاعلية ترشدك خلال إعداد المشروع. - بدون تبعيات: تهيئة المشروع سريعة جدًا وتستغرق ثانية واحدة. Create Next App لا يعتمد على أي تبعيات خارجية.
- دعم العمل دون اتصال: سيكتشف Create Next App تلقائيًا إذا كنت غير متصل بالإنترنت وسيقوم بتهيئة مشروعك باستخدام ذاكرة التخزين المؤقت المحلية للحزم.
- دعم الأمثلة: يمكن لـ Create Next App تهيئة تطبيقك باستخدام مثال من مجموعة أمثلة Next.js (مثل
npx create-next-app --example api-routes
) أو أي مستودع GitHub عام. - مختبر: الحزمة جزء من مستودع Next.js الأحادي ويتم اختبارها باستخدام نفس مجموعة اختبارات التكامل مثل Next.js نفسها، مما يضمن عملها كما هو متوقع مع كل إصدار.