Skip to content

Mavdii/Quran-Companion

Repository files navigation

📖 رفيق القرآن — Quran Companion

تطبيق إسلامي متكامل لقراءة القرآن الكريم مع تتبع التقدم، ومواقيت الصلاة، والتسبيح، والبحث، والقراءة الجماعية

يعمل بدون إنترنت — جميع البيانات محفوظة على جهازك


🖼️ لقطات من التطبيق


الرئيسية

فهرس السور

قارئ المصحف

البحث

التقدم

الإعدادات

القراءة الجماعية

✨ المميزات

📖 قارئ المصحف الشريف

  • عرض صفحات المصحف مطابقة لمصحف المدينة المنورة (٦٠٤ صفحة)
  • تقليب الصفحات بالسحب يمينًا ويسارًا كالمصحف الحقيقي
  • خط عربي أنيق (Scheherazade New) مع إطارات ذهبية زخرفية
  • أرقام الآيات بالأرقام العربية ﴿١﴾ ﴿٢﴾ ﴿٣﴾
  • لافتة عنوان السورة والبسملة بتصميم تقليدي

🔍 البحث في القرآن

  • بحث نصي شامل في ٦٢٣٦ آية
  • نتائج فورية مع عرض اسم السورة ورقم الآية
  • الانتقال المباشر إلى الآية من نتائج البحث

🎧 الاستماع للتلاوة

  • تلاوة الشيخ مشاري العفاسي
  • تشغيل/إيقاف من شريط أدوات الآية
  • صوت عالي الجودة من شبكة Islamic Network

📊 تتبع التقدم

  • خريطة حرارية (Heatmap) للقراءة اليومية
  • إحصائيات شاملة: عدد الآيات المقروءة، أيام متتالية، سور مكتملة
  • هدف قراءة يومي قابل للتعديل
  • تحديد الآيات كمقروءة بنقرة واحدة

🕌 مواقيت الصلاة

  • حساب مواقيت الصلاة تلقائيًا حسب موقعك الجغرافي
  • استخدام مكتبة Adhan للحسابات الدقيقة
  • عرض الوقت المتبقي للصلاة القادمة

📿 التسبيح (الذكر)

  • عداد تسبيح رقمي بارتجاج حسي (Haptic Feedback)
  • أذكار متعددة مع إمكانية التنقل بينها
  • تتبع عدد التسبيحات

👥 القراءة الجماعية

  • إنشاء جلسات قراءة مشتركة
  • مشاركة عبر رمز QR أو كود الجلسة
  • متابعة تقدم القراءة الجماعية

🔖 المفضلة والإشارات المرجعية

  • حفظ الآيات المفضلة للرجوع إليها لاحقًا
  • تنظيم الإشارات حسب السورة

🌐 تصفح متعدد

  • تصفح حسب السورة (١١٤ سورة)
  • تصفح حسب الجزء (٣٠ جزء)
  • تصفح حسب الحزب (٦٠ حزب)

🛠️ التقنيات المستخدمة

التقنية الاستخدام
React Native إطار العمل الرئيسي
Expo SDK 54 أدوات التطوير والبناء
TypeScript لغة البرمجة
Expo Router التنقل بين الصفحات
AsyncStorage تخزين البيانات محليًا
expo-audio تشغيل التلاوات
expo-location تحديد الموقع لمواقيت الصلاة
expo-haptics الارتجاج الحسي
adhan حساب مواقيت الصلاة
quran-json بيانات القرآن الكريم
FlashList قوائم عالية الأداء

🏗️ هيكل المشروع

📦 quran-companion
├── 📂 app/                    # صفحات التطبيق (Expo Router)
│   ├── 📂 (tabs)/             # التبويبات الرئيسية
│   │   ├── index.tsx          # الرئيسية
│   │   ├── quran.tsx          # فهرس القرآن
│   │   ├── pair.tsx           # القراءة الجماعية
│   │   ├── progress.tsx       # التقدم
│   │   └── settings.tsx       # الإعدادات
│   ├── 📂 surah/
│   │   └── [id].tsx           # قارئ المصحف
│   ├── search.tsx             # البحث
│   ├── bookmarks.tsx          # المفضلة
│   ├── tasbih.tsx             # التسبيح
│   └── onboarding.tsx         # شاشة الترحيب
├── 📂 contexts/               # إدارة الحالة
│   ├── AppContext.tsx          # سياق التطبيق العام
│   └── QuranContext.tsx        # سياق بيانات القرآن
├── 📂 constants/               # الثوابت
│   ├── colors.ts              # الألوان
│   ├── quranMeta.ts           # بيانات السور والأجزاء
│   └── quranPages.ts          # خريطة صفحات المصحف (٦٠٤ صفحة)
├── 📂 screenshots/             # لقطات التطبيق
└── 📂 server/                  # الخادم (Express)

🚀 التشغيل

المتطلبات

  • Node.js v18+
  • npm أو yarn
  • تطبيق Expo Go على هاتفك (اختياري للاختبار على الجهاز)

التثبيت

# استنساخ المشروع
git clone https://github.com/Mavdii/Quran-Companion.git

# الدخول إلى المجلد
cd Quran-Companion

# تثبيت المكتبات
npm install

# تشغيل التطبيق
npx expo start

التشغيل على الأجهزة

المنصة الطريقة
📱 iOS/Android امسح رمز QR باستخدام تطبيق Expo Go
🌐 الويب اضغط w في الطرفية لفتح المتصفح

🎨 التصميم

التطبيق مصمم بروح إسلامية أصيلة:

  • اللون الأخضر الداكن #1B4332 — اللون الرئيسي المستوحى من التراث الإسلامي
  • اللون الذهبي #C9A84C — للزخارف والعناصر المميزة
  • خلفية كريمية #FDF6E3 — تحاكي صفحات المصحف القديم
  • خطوط عربية أنيقة — Scheherazade New للقرآن، Cairo لواجهة المستخدم
  • دعم كامل لـ RTL — واجهة عربية من اليمين إلى اليسار

📱 المنصات المدعومة

المنصة الحالة
iOS ✅ مدعوم عبر Expo Go
Android ✅ مدعوم عبر Expo Go
Web ✅ مدعوم بالكامل

🔒 الخصوصية

  • لا نجمع أي بيانات شخصية
  • جميع بيانات القراءة والتقدم محفوظة محليًا على جهازك فقط
  • لا يتطلب إنشاء حساب أو تسجيل دخول
  • الاتصال بالإنترنت مطلوب فقط لتشغيل التلاوات الصوتية

🤝 المساهمة

المساهمات مرحب بها! إذا أردت المساهمة:

  1. Fork المشروع
  2. أنشئ فرعًا جديدًا (git checkout -b feature/amazing-feature)
  3. أضف تغييراتك (git commit -m 'إضافة ميزة رائعة')
  4. ادفع الفرع (git push origin feature/amazing-feature)
  5. افتح Pull Request

👨‍💻 المطوّر

Umar

صُنع بحب ❤️ لخدمة كتاب الله

المنصة التواصل
📨 تيليجرام @dev_umar
💬 ديسكورد dev.umar
📱 واتساب 01550875414

📄 الرخصة

هذا المشروع مرخص تحت رخصة MIT — راجع ملف LICENSE للتفاصيل.


«خَيْرُكُمْ مَنْ تَعَلَّمَ القُرْآنَ وَعَلَّمَهُ»
رواه البخاري


⭐ إذا أعجبك المشروع، لا تنسَ إضافة نجمة على GitHub ⭐

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors