create-next-app

أسهل طريقة للبدء مع Next.js هي باستخدام create-next-app. هذه الأداة عبر سطر الأوامر تمكنك من البدء بسرعة في بناء تطبيق Next.js جديد، مع كل الإعدادات الجاهزة لك.

يمكنك إنشاء تطبيق جديد باستخدام قالب Next.js الافتراضي، أو باستخدام أحد الأمثلة الرسمية لـ Next.js.

الوضع التفاعلي

يمكنك إنشاء مشروع جديد بشكل تفاعلي عن طريق تنفيذ:

Terminal
npx create-next-app@latest
Terminal
yarn create next-app
Terminal
pnpm create next-app
Terminal
bunx create-next-app

ثم سيتم سؤالك الأسئلة التالية:

Terminal
ما اسم مشروعك؟ my-app
هل ترغب في استخدام TypeScript؟ لا / نعم
هل ترغب في استخدام ESLint؟ لا / نعم
هل ترغب في استخدام Tailwind CSS؟ لا / نعم
هل ترغب في استخدام دليل `src/`؟ لا / نعم
هل ترغب في استخدام موجه التطبيق؟ (موصى به) لا / نعم
هل ترغب في تخصيص اسم مستعار للاستيراد الافتراضي (@/*)؟ لا / نعم

بعد الإجابة على الأسئلة، سيتم إنشاء مشروع جديد مع التكوين الصحيح بناءً على إجاباتك.

الوضع غير التفاعلي

يمكنك أيضًا تمرير وسائط سطر الأوامر لإعداد مشروع جديد بشكل غير تفاعلي.

بالإضافة إلى ذلك، يمكنك إلغاء الخيارات الافتراضية عن طريق إضافة بادئة --no- (مثل --no-eslint).

انظر create-next-app --help:

Terminal
الاستخدام: 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 نفسها، مما يضمن عملها كما هو متوقع مع كل إصدار.