first commit

Author: Mavdii

.gitignore

@@ -0,0 +1,52 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+ios/
+android/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+.env
+
+# typescript
+*.tsbuildinfo
+.vercel
+
+# Playwright/cache
+.cache/
+/tmp/
+
+# Replit
+.replit
+replit.nix
+.upm/
+.config/
+.local/
+generated/

README.md

@@ -0,0 +1,265 @@
+<div align="center">
+
+# 📖 رفيق القرآن — Quran Companion
+
+### تطبيق القرآن الكريم الشامل
+
+<p>
+  <img src="https://img.shields.io/badge/React_Native-0.81-blue?logo=react" />
+  <img src="https://img.shields.io/badge/Expo-SDK_54-000020?logo=expo" />
+  <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white" />
+  <img src="https://img.shields.io/badge/Platform-iOS%20%7C%20Android%20%7C%20Web-green" />
+  <img src="https://img.shields.io/badge/License-MIT-yellow" />
+</p>
+
+<p>
+  <strong>تطبيق إسلامي متكامل لقراءة القرآن الكريم مع تتبع التقدم، ومواقيت الصلاة، والتسبيح، والبحث، والقراءة الجماعية</strong>
+</p>
+
+<p dir="rtl">
+  يعمل بدون إنترنت — جميع البيانات محفوظة على جهازك
+</p>
+
+---
+
+</div>
+
+## 🖼️ لقطات من التطبيق
+
+<div align="center">
+<table>
+  <tr>
+    <td align="center"><img src="screenshots/home.png" width="200" /><br /><b>الرئيسية</b></td>
+    <td align="center"><img src="screenshots/quran.png" width="200" /><br /><b>فهرس السور</b></td>
+    <td align="center"><img src="screenshots/reader.png" width="200" /><br /><b>قارئ المصحف</b></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="screenshots/search.png" width="200" /><br /><b>البحث</b></td>
+    <td align="center"><img src="screenshots/progress.png" width="200" /><br /><b>التقدم</b></td>
+    <td align="center"><img src="screenshots/settings.png" width="200" /><br /><b>الإعدادات</b></td>
+  </tr>
+  <tr>
+    <td align="center" colspan="3"><img src="screenshots/pair.png" width="200" /><br /><b>القراءة الجماعية</b></td>
+  </tr>
+</table>
+</div>
+
+---
+
+## ✨ المميزات
+
+### 📖 قارئ المصحف الشريف
+- عرض صفحات المصحف مطابقة لمصحف المدينة المنورة **(٦٠٤ صفحة)**
+- تقليب الصفحات بالسحب يمينًا ويسارًا كالمصحف الحقيقي
+- خط عربي أنيق (Scheherazade New) مع إطارات ذهبية زخرفية
+- أرقام الآيات بالأرقام العربية ﴿١﴾ ﴿٢﴾ ﴿٣﴾
+- لافتة عنوان السورة والبسملة بتصميم تقليدي
+
+### 🔍 البحث في القرآن
+- بحث نصي شامل في **٦٢٣٦ آية**
+- نتائج فورية مع عرض اسم السورة ورقم الآية
+- الانتقال المباشر إلى الآية من نتائج البحث
+
+### 🎧 الاستماع للتلاوة
+- تلاوة الشيخ **مشاري العفاسي**
+- تشغيل/إيقاف من شريط أدوات الآية
+- صوت عالي الجودة من شبكة Islamic Network
+
+### 📊 تتبع التقدم
+- خريطة حرارية (Heatmap) للقراءة اليومية
+- إحصائيات شاملة: عدد الآيات المقروءة، أيام متتالية، سور مكتملة
+- هدف قراءة يومي قابل للتعديل
+- تحديد الآيات كمقروءة بنقرة واحدة
+
+### 🕌 مواقيت الصلاة
+- حساب مواقيت الصلاة تلقائيًا حسب موقعك الجغرافي
+- استخدام مكتبة **Adhan** للحسابات الدقيقة
+- عرض الوقت المتبقي للصلاة القادمة
+
+### 📿 التسبيح (الذكر)
+- عداد تسبيح رقمي بارتجاج حسي (Haptic Feedback)
+- أذكار متعددة مع إمكانية التنقل بينها
+- تتبع عدد التسبيحات
+
+### 👥 القراءة الجماعية
+- إنشاء جلسات قراءة مشتركة
+- مشاركة عبر رمز QR أو كود الجلسة
+- متابعة تقدم القراءة الجماعية
+
+### 🔖 المفضلة والإشارات المرجعية
+- حفظ الآيات المفضلة للرجوع إليها لاحقًا
+- تنظيم الإشارات حسب السورة
+
+### 🌐 تصفح متعدد
+- تصفح حسب **السورة** (١١٤ سورة)
+- تصفح حسب **الجزء** (٣٠ جزء)
+- تصفح حسب **الحزب** (٦٠ حزب)
+
+---
+
+## 🛠️ التقنيات المستخدمة
+
+<div align="center">
+
+| التقنية | الاستخدام |
+|---------|----------|
+| **React Native** | إطار العمل الرئيسي |
+| **Expo SDK 54** | أدوات التطوير والبناء |
+| **TypeScript** | لغة البرمجة |
+| **Expo Router** | التنقل بين الصفحات |
+| **AsyncStorage** | تخزين البيانات محليًا |
+| **expo-audio** | تشغيل التلاوات |
+| **expo-location** | تحديد الموقع لمواقيت الصلاة |
+| **expo-haptics** | الارتجاج الحسي |
+| **adhan** | حساب مواقيت الصلاة |
+| **quran-json** | بيانات القرآن الكريم |
+| **FlashList** | قوائم عالية الأداء |
+
+</div>
+
+---
+
+## 🏗️ هيكل المشروع
+
+```
+📦 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** على هاتفك (اختياري للاختبار على الجهاز)
+
+### التثبيت
+
+```bash
+# استنساخ المشروع
+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
+
+---
+
+## 👨‍💻 المطوّر
+
+<div align="center">
+
+### **Umar**
+
+<p>صُنع بحب ❤️ لخدمة كتاب الله</p>
+
+| المنصة | التواصل |
+|--------|---------|
+| 📨 **تيليجرام** | [@dev_umar](https://t.me/dev_umar) |
+| 💬 **ديسكورد** | `dev.umar` |
+| 📱 **واتساب** | [01550875414](https://wa.me/201550875414) |
+
+</div>
+
+---
+
+## 📄 الرخصة
+
+هذا المشروع مرخص تحت رخصة **MIT** — راجع ملف [LICENSE](LICENSE) للتفاصيل.
+
+---
+
+<div align="center">
+
+**﷽**
+
+<p dir="rtl">
+  <strong>«خَيْرُكُمْ مَنْ تَعَلَّمَ القُرْآنَ وَعَلَّمَهُ»</strong>
+  <br />
+  رواه البخاري
+</p>
+
+<br />
+
+⭐ إذا أعجبك المشروع، لا تنسَ إضافة نجمة على GitHub ⭐
+
+</div>

app.json

@@ -0,0 +1,55 @@
+{
+  "expo": {
+    "name": "Quran Companion",
+    "slug": "quran-companion",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/images/icon.png",
+    "scheme": "myapp",
+    "userInterfaceStyle": "automatic",
+    "newArchEnabled": true,
+    "splash": {
+      "image": "./assets/images/splash-icon.png",
+      "resizeMode": "contain",
+      "backgroundColor": "#1B4332"
+    },
+    "ios": {
+      "supportsTablet": false,
+      "bundleIdentifier": "com.myapp"
+    },
+    "android": {
+      "package": "com.myapp",
+      "adaptiveIcon": {
+        "backgroundColor": "#1B4332",
+        "foregroundImage": "./assets/images/android-icon-foreground.png",
+        "backgroundImage": "./assets/images/android-icon-background.png",
+        "monochromeImage": "./assets/images/android-icon-monochrome.png"
+      }
+    },
+    "web": {
+      "favicon": "./assets/images/favicon.png"
+    },
+    "plugins": [
+      [
+        "expo-router",
+        {
+          "origin": "https://replit.com/"
+        }
+      ],
+      "expo-font",
+      "expo-web-browser"
+    ],
+    "experiments": {
+      "typedRoutes": true,
+      "reactCompiler": true
+    },
+    "extra": {
+      "router": {
+        "origin": "https://replit.com/"
+      },
+      "eas": {
+        "projectId": "a760f38b-a2c0-47f7-b463-6fae2e940964"
+      }
+    }
+  }
+}