الأداة Create Next App

إن أسهل الطرق لتبدأ بناء تطبيقات Next.js هو استخدام create-next-app. تمكنك هذه الأداة التي تستخدم واجهة سطر الأوامر CLI أن تبدأ بناء تطبيق Next.js جديد بسرعة بعد أن تهيئ لك كل شئ. بغمكانك بناء تطبيق جديد بالاستفادة من قالب Next.js الافتراضي أو باستخدام أحد قوالب Next.js الرسمية.

نفّذ الأوامر التالية لتبدأ:

npx create-next-app@latest
# أو
yarn create next-app
# أو
pnpm create next-app

بإمكانك أيضًا إنشاء مشروع TypeScript باستخدام الرايتين ts, --typescript-- :

npx create-next-app@latest --ts
# أو
yarn create next-app --typescript
# أو
pnpm create next-app --ts

خيارات الأداة

تأتي الأداة create-next-app مع الخيارات التالية:

الخيار typescript-- أو ts--

ويُستخدم تهيئة التطبيق كمشروع TypeScript.

الخيار example [name]|[github-url]-- أو e--

ويقدّم مثالًا لتحميل التطبيق من خلاله. بإمكانك استخدام اسم المثال من مستودع Next.js أو من خلال لعنوان URL على GitHub. يمكن ان يضم العنوان أي فرغ أو/و مجلد فرعي.

الخيار example-path [path-to-example]--

قد يتضمن عنوان URL في حالات نادرة على اسم فرع يضم المحرف "/" (مثل bug/fix-1) ومسارًا إلى المثال (مثل foo/bar). لا بد في هذه الحالة من تخصيص المسار إلى المثال بشكل مستقل: example-path foo/bar--.

الخيار use-npm--

يجبر CLI صراحة على استخدام npm في تحميل التطبيق.

الخيار use-pnpm--

يجبر CLI صراحة على استخدام pnpm في تحميل التطبيق.

ملاحظة: ننصحك بتنفيذ الأمر yarn create next-app للتحميل باستخدام yarn.

إيجابيات استخدام Create Next App

تساعدك الأداة في إنشاء تطبيق Next.js خلال ثوانٍ، وتجري صيانته باستمرار من قبل مصممي Next.js. تقدم الأداة إضافة إلى ذلك الفوائد التالية:

التجربة التفاعلية: يؤدي تنفيذ الأمر npx create-next-app@latest إلى تشغيل دليل يرشدك بأسلوب تفاعلي إلى خطوات إعداد المشروع.
لا حاجة لإدراج اعتماديات: لا تحتاج الإداة إلى أية اعتماديات لإنشاء مشروع، ويهيأ خلال ثوانٍ.
دعم دون اتصال: تستشعر الداة تلقائيًا انك دون اتصال، وتحمّل مشروعك من الذاكرة المؤقتة المحلية.
دعم الأمثلة: تُحمّل الأداة تطبيقك باستخدام مثال من مجموعة أمثلة (مثل npx create-next-app --example api-routes).
أداة مختبرة: هذه الحزمة جزء من مستودع Next.js وهي مختبرة باستخدام اختبارات التكامل ذاتها التي تُطبق على Next.js لضمان عملها في أي إصدار.

المصادر

الصفحة Create Next App من توثيق Next.js الرسمي.

Next.js/create next app