create-next-app
تتيح لك واجهة سطر الأوامر create-next-app إنشاء تطبيق Next.js جديد بسرعة باستخدام القالب الافتراضي أو مثال من مستودع Github العام. إنها أسهل طريقة للبدء مع Next.js.
الاستخدام الأساسي:
npx create-next-app@latest [project-name] [options]مرجع
الخيارات المتاحة هي:
| الخيارات | الوصف |
|---|---|
-h أو --help | عرض جميع الخيارات المتاحة |
-v أو --version | إخراج رقم الإصدار |
--no-* | إلغاء الخيارات الافتراضية. مثلاً --no-eslint |
--ts أو --typescript | تهيئة المشروع كنوع TypeScript (افتراضي) |
--js أو --javascript | تهيئة المشروع كنوع JavaScript |
--tailwind | تهيئة مع إعدادات Tailwind CSS (افتراضي) |
--eslint | تهيئة مع إعدادات ESLint |
--app | تهيئة المشروع كموجه تطبيق (App Router) |
--src-dir | تهيئة داخل مجلد src/ |
--turbo | تمكين Turbopack افتراضيًا للتطوير |
--import-alias <alias-to-configure> | تحديد اسم مستعار للاستيراد (افتراضي "@/*") |
--empty | تهيئة مشروع فارغ |
--use-npm | إخبار واجهة سطر الأوامر صراحةً باستخدام npm |
--use-pnpm | إخبار واجهة سطر الأوامر صراحةً باستخدام pnpm |
--use-yarn | إخبار واجهة سطر الأوامر صراحةً باستخدام Yarn |
--use-bun | إخبار واجهة سطر الأوامر صراحةً باستخدام Bun |
-e أو --example [name] [github-url] | مثال لتهيئة التطبيق به |
--example-path <path-to-example> | تحديد مسار المثال بشكل منفصل |
--reset-preferences | إخبار واجهة سطر الأوامر صراحةً بإعادة تعيين التفضيلات |
--skip-install | إخبار واجهة سطر الأوامر صراحةً بتخطي تثبيت الحزم |
--yes | استخدام التفضيلات السابقة أو الإعدادات الافتراضية لجميع الخيارات |
أمثلة
مع القالب الافتراضي
لإنشاء تطبيق جديد باستخدام القالب الافتراضي، قم بتنفيذ الأمر التالي في طرفيتك:
npx create-next-app@latestثم سيتم سؤالك الأسئلة التالية:
ما اسم مشروعك؟ my-app
هل تريد استخدام TypeScript؟ لا / نعم
هل تريد استخدام ESLint؟ لا / نعم
هل تريد استخدام Tailwind CSS؟ لا / نعم
هل تريد وضع الكود داخل مجلد `src/`؟ لا / نعم
هل تريد استخدام موجه التطبيق (موصى به)؟ لا / نعم
هل تريد استخدام Turbopack لـ `next dev`؟ لا / نعم
هل تريد تخصيص اسم الاستيراد (`@/*` افتراضيًا)؟ لا / نعمبعد الإجابة على الأسئلة، سيتم إنشاء مشروع جديد مع التكوين الذي اخترته.
مع مثال رسمي من Next.js
لإنشاء تطبيق جديد باستخدام مثال رسمي من Next.js، استخدم علامة --example مع الأمر التالي:
npx create-next-app@latest --example [your-project-name] [example-name]يمكنك عرض قائمة بجميع الأمثلة المتاحة مع تعليمات الإعداد في مستودع Next.js.
مع أي مثال عام من Github
لإنشاء تطبيق جديد باستخدام أي مثال عام من Github، استخدم خيار --example مع رابط مستودع Github. على سبيل المثال:
npx create-next-app@latest --example [your-project-name] "https://github.com/.../"