تشريح بنية ملفات مشروع React.
الدرس 6 من 5016:39كورس مجاني

محتوى الدرس
تشريح بنية ملفات مشروع React
بعد ما أنشأنا المشروع وشغلناه بنجاح، جه الوقت نفتح كود المشروع على محرّر الأكواد (VS Code) ونكتشف مع بعض وظيفة كل ملف ومجلد جوه هيكل مشروعات React.
Bash
my-app/
├── node_modules/ # مجلد المكتبات والحزم الخارجية
├── public/ # الملفات العامة والمكشوفة للمتصفح
│ ├── index.html # صفحة الـ HTML الوحيدة في التطبيق (SPA)
│ └── favicon.ico # أيقونة الموقع
├── src/ # مجلد الكود الأساسي والـ Components
│ ├── App.js # المكون الرئيسي للتطبيق (Root Component)
│ ├── App.css # تنسيقات المكون الرئيسي
│ ├── index.js # نقطة البداية لتشغيل وربط React بالـ DOM
│ └── index.css # التنسيقات العامة للموقع
└── package.json # ملف معلومات المشروع وإدارة الحزم1. مجلد node_modules/
ده المجلد اللي بيحتوي على كل الكود والمكتبات الخارجية اللي بيحتاجها مشروعك عشان يشتغل (بما فيها كود React نفسه).
مجلد node_modules
ملاحظة مهمة: المجلد ده بيكون حجمه كبير جداً، ومش بنعدل فيه أي كود يدوياً، ولا بنرفعه على Github (بيتم مجاهلته عبر ملف .gitignore).
2. مجلد public/
- index.html: الملف الأهم في المجلد، وهو صفحة الـ HTML الوحيدة للموقع كله! لو فتحته هتلاقي جواه عنصر div فارغ غالباً بياخد id="root". ده العنصر اللي React بتاخد التحكم كله جواه.
- favicon.ico و manifest.json: ملفات الأيقونة وإعدادات الـ Progressive Web App.
مجلد public
بيحتوي على الملفات الثابتة (Static Files) التي لا تتغير ويتم الوصول إليها مباشرة من المتصفح.
3. مجلد src/ (قلب المشروع)
مجلد src
ده المجلد اللي هتقضي فيه 99% من وقتك، وجواه بنكتب كل أكواد الـ JavaScript والـ Components والـ CSS الخاصة بالمشروع.
أ. ملف index.js (نقطة الانطلاق)
ده أول ملف بيبدأ المتصفح يقرأه.
وظيفته الأساسية هي استدعاء React وأخذ المكون الرئيسي (App) ثم زرعه وتثبيته داخل الـ <div id="root"> الموجود في ملف index.html.
ب. ملف App.js (المكون الرئيسي)
ده المكون الأب لكل المكونات في موقعك (Root Component).
الكود اللي بتكتبه جواه هو اللي بيظهر فوراً على الشاشة، ومن جواه بنبدأ نستدعي ونربط باقي المكونات الأخرى.
ج. ملفات التنسيق index.css & App.css
- index.css: بنكتب فيه التنسيقات العامة للموقع كله (Global Styles) زي نوع الخطوط وإعادة ضبط المافات (CSS Reset).
- App.css: خاص بتنسيقات المكون App.js فقط.
4. ملف package.json (دليل المشروع)
ملف package.json
ده الملف المسؤول عن إدارة المشروع ككل، وبيحتوي على:
- معلومات المشروع: اسم المشروع وإصداره.
- dependencies (الاعتمادات): قائمة بكل المكتبات المثبتة في المشروع وأرقام إصداراتها (مثل react و react-dom).
- scripts (الأوامر): الاختصارات التي نستخدمها في الـ Terminal مثل:
- npm start: لتشغيل سيرفر التطوير.
- npm run build: لتجهيز ونشر المشروع للإنتاج (Production).
ملخص الدرس
- index.html: صفحة الـ HTML الوحيدة التي تحتوي على <div id="root">.
- src/index.js: الملف المسؤول عن ربط كود React بملف الـ HTML.
- src/App.js: المكون الأب الرئيسي الذي نصمم فيه واجهة تطبيقنا.
- package.json: بطاقة هُوية المشروع التي تسجّل أسماء المكتبات وأوامر التشغيل.