README_ar.md

تطبيق البوكيمون

🌐

مرحبًا بكم في تطبيق البوكيمون، وهو تطبيق تم تطويره باستخدام React لعرض قائمة من بوكيمون، مما يتيح عرض تفاصيل محددة وتحديد المفضلات.

📋 المتطلبات الأساسية

لاختبار وتشغيل التطبيق، تحتاج إلى إعداد البيئة التالية:

• Node.js الإصدار 18 أو 16 (يُنصح باستخدام Node.js 18 لضمان التوافق مع التبعيات).

تحقق من إصدار Node.js

للتحقق مما إذا كان الإصدار المثبت من Node.js متوافقًا، استخدم الأمر:

node -v

تأكد من أن النتيجة هي v18.x.x أو v16.x.x. إذا كنت بحاجة إلى تثبيت أو تحديث Node.js، يمكنك تنزيله هنا .

📦 التثبيت

اتبع الخطوات أدناه لتشغيل التطبيق محليًا:

1. استنساخ المستودع:

   git clone [email protected]:SamuelRocha91/pokedex.git

2. الانتقال إلى دليل المشروع:

   cd pokemon-app

3. تثبيت التبعيات:

   قم بتنفيذ الأمر أدناه لتثبيت جميع التبعيات الضرورية:

   npm install

4. تشغيل التطبيق:

   بعد تثبيت التبعيات، ابدأ التطبيق باستخدام الأمر:

   npm start

   سيؤدي ذلك إلى بدء خادم التطوير. افتح المتصفح وانتقل إلى http://localhost:3000 لمشاهدة التطبيق.

✨ الميزات

• بوكيمون: يعرض قائمة من البوكيمون مع إمكانية وضعها كمفضلة.
• تفاصيل بوكيمون: يعرض المعلومات التفصيلية للبوكيمون المحدد.
• بوكيمون المفضلة: صفحة مخصصة للبوكيمون المعلم كمفضلة.
• صفحة حول: تشرح هدف التطبيق.
• صفحة غير موجودة (404): تظهر عند الوصول إلى مسار غير موجود.

📂 هيكل المشروع

هيكل التطبيق كما يلي:

• /src: يحتوي على جميع كود المصدر للتطبيق.
  • /components: مكونات قابلة لإعادة الاستخدام.
  • /pages: صفحات التطبيق (بوكيمون، تفاصيل، مفضلة، حول، إلخ).
  • /types: أنواع PropTypes المحددة للتحقق من صحة الخصائص.
  • Routes.js: يحدد المسارات الرئيسية للتطبيق.

🧪 الاختبارات

لضمان أن التطبيق يعمل بشكل صحيح، يمكنك تشغيل الاختبارات الآلية باستخدام:

npm test

🔗 مشاريع أخرى

• 🌶️ تطبيق الوصفات
• 🎮 تريفي
• 👛 منظم النفقات