هيكل وتنظيم المشروع
توفر هذه الصفحة نظرة عامة على جميع اصطلاحات المجلدات والملفات في Next.js، وتوصيات لتنظيم مشروعك.
اصطلاحات المجلدات والملفات
مجلدات المستوى الأعلى
تُستخدم مجلدات المستوى الأعلى لتنظيم كود التطبيق والأصول الثابتة.

app | موجه التطبيق (App Router) |
pages | موجه الصفحات (Pages Router) |
public | الأصول الثابتة التي سيتم تقديمها |
src | مجلد مصدر التطبيق الاختياري |
ملفات المستوى الأعلى
تُستخدم ملفات المستوى الأعلى لتكوين التطبيق، وإدارة التبعيات، وتشغيل الوسيط (middleware)، ودمج أدوات المراقبة، وتحديد متغيرات البيئة.
Next.js | |
next.config.js | ملف تكوين Next.js |
package.json | تبعيات المشروع والنصوص البرمجية |
instrumentation.ts | ملف OpenTelemetry والأدوات (Instrumentation) |
middleware.ts | وسيط طلبات Next.js |
.env | متغيرات البيئة |
.env.local | متغيرات البيئة المحلية |
.env.production | متغيرات بيئة الإنتاج |
.env.development | متغيرات بيئة التطوير |
.eslintrc.json | ملف تكوين ESLint |
.gitignore | ملفات ومجلدات Git لتجاهلها |
next-env.d.ts | ملف تعريف TypeScript لـ Next.js |
tsconfig.json | ملف تكوين TypeScript |
jsconfig.json | ملف تكوين JavaScript |
اصطلاحات الملفات
_app | .js .jsx .tsx | تطبيق مخصص |
_document | .js .jsx .tsx | مستند مخصص |
_error | .js .jsx .tsx | صفحة خطأ مخصصة |
404 | .js .jsx .tsx | صفحة خطأ 404 |
500 | .js .jsx .tsx | صفحة خطأ 500 |
الطرق (Routes)
اصطلاح المجلد | ||
index | .js .jsx .tsx | الصفحة الرئيسية |
folder/index | .js .jsx .tsx | صفحة متداخلة |
اصطلاح الملف | ||
index | .js .jsx .tsx | الصفحة الرئيسية |
file | .js .jsx .tsx | صفحة متداخلة |
الطرق الديناميكية
اصطلاح المجلد | ||
[folder]/index | .js .jsx .tsx | مقطع طريق ديناميكي |
[...folder]/index | .js .jsx .tsx | مقطع طريق شامل (Catch-all) |
[[...folder]]/index | .js .jsx .tsx | مقطع طريق شامل اختياري |
اصطلاح الملف | ||
[file] | .js .jsx .tsx | مقطع طريق ديناميكي |
[...file] | .js .jsx .tsx | مقطع طريق شامل (Catch-all) |
[[...file]] | .js .jsx .tsx | مقطع طريق شامل اختياري |