Skip to content

Repository files navigation

📖 Al-Furkan — الفُرقان

One of the most advanced open-source Quran apps built with Flutter, combining BLoC, Clean Architecture, and precise Uthmanic script rendering with audio, Tafsir, and daily Islamic tools.


تطبيق قرآني متكامل صُمم بأحدث التقنيات مع واجهة استخدام حديثة

Platform Open Source Built with Flutter License Developer


About

Al-Furkan is a production-ready, cross-platform Flutter Quran app — not a demo, not a UI showcase, but a real Islamic application built with BLoC + Clean Architecture and Uthmanic (QCF) script rendering that feels close to reading from a physical Mushaf.

It is designed for daily reading, deep study, memorization, and personalization — combining an interactive mushaf, 61 tafsirs in 25 languages, 209+ translations in 50+ languages, a word-level Ayah library with 7 analysis tabs, 56 reciters with advanced audio controls, prayer times, qibla, azkar, khatma tracking, smart notifications, and a fully customizable "Ayah of the Day" home widget — all in one app.

Whether you are a daily Quran reader, a student of knowledge, a hafiz, or a Flutter developer building a serious product… Al-Furkan is made to serve you.

Why Al-Furkan?

  • Not just text + audio — QCF Uthmanic Mushaf + Word-level Ayah Library + Resource Management
  • BLoC + Clean Architecture — not random state scattered inside screens; testable, scalable, maintainable
  • Offline-first — core features work without internet using hive_ce; no API keys required
  • 61 Tafsirs & 209+ Translations — the largest resource library in any open-source Quran app
  • 56 Reciters with multiple Qira'at — Hafs, Warsh, Qalun, with word-by-word audio tracking
  • Customizable Home Widget — "Ayah of the Day" with live preview, 20+ Arabic fonts, theme customization
  • Production-grade performance — lazy font loading, deferred initialization, bundle size optimization

Screenshots

👨‍💻 Built By

تبني وتصميم واجهة المستخدم، وتطوير سائر تقنيات التطبيق، والخروج بنسخة المشروع النهائية بواسطة:
IDRISIUM Corp | المهندس إدريس غامد

GitHub Instagram TikTok Telegram Portfolio

✨ Features (المزايا الحالية داخل التطبيق)

🚀 Core Highlights

  • 📖 Advanced Uthmanic (QCF) Quran rendering engine — محرك عرض قرآني متقدم بالرسم العثماني
  • 🧠 Word-level Ayah analysis — تحليل لغوي متقدم على مستوى الكلمة (linguistics + tafsir + grammar)
  • Production-ready BLoC + Clean Architecture — معمارية احترافية قابلة للتوسع والصيانة
  • 🕌 All-in-one Islamic toolkit — مجموعة أدوات إسلامية متكاملة (Quran + Prayer Times + Qibla + Azkar + Khatma)
  • 🎨 Modern UI/UX with Organic Minimalism — واجهة مستخدم عصرية بتصميم نظيف وأنيق (Quiet Luxury)
  • 📦 61 Tafsirs & 209+ Translations — 61 تفسيراً بـ 25 لغة و 209+ ترجمة بأكثر من 50 لغة
  • 🎙️ 56 Reciters with Advanced Audio Controls — 56 قارئاً بروايات متعددة (حفص، ورش، قالون) مع تحكم صوتي متقدم
  • 🔔 Smart Notification System — نظام إشعارات ذكي للختمة والأذكار وآية اليوم
  • 📱 Customizable Home Widget — ويدجت قابل للتخصيص بالكامل لآية اليوم
  • 🌙 Ayah-Inspired Light/Dark Theme — وضع داكن/فاتح بألوان مستوحاة من تطبيق آية (Sage Green + Warm Beige)
  • 📐 3 Mushaf Layout Modes — 3 تخطيطات مصحف: صفحة واحدة، صفحة مزدوجة، تمرير مستمر
  • 🔤 6 Quran Fonts — 6 خطوط قرآنية: QPC Hafs، KFGQPC Uthmanic، Uthman Taha Naskh، AlQuranNeo، Indopak Nastaleeq، MeQuranVolt
  • 🧠 Hifz/Memorization Mode — وضع الحفظ مع 3 مستويات إخفاء (مرئي/مضبب/مخفي) + وضع الاختبار
  • 📴 Offline Audio Player — مشغل صوتي أوفلاين مع تحميل سور كاملة وإدارة التخزين
  • 🌙 Night Reading Mode — وضع القراءة الليلية بألوان كهرمانية + تفعيل تلقائي عند الغروب

📖 تجربة قراءة المصحف | Mushaf Reading Experience

محرك العرض القرآني المتقدم

  • مصحف QCF تفاعلي بالخط العثماني (Uthmanic Script) مع تجربة قريبة جداً من المصحف الورقي
  • 3 تخطيطات عرض للمصحف: صفحة واحدة (PageView)، صفحة مزدوجة (DoublePage)، تمرير مستمر (ContinuousScroll)
  • 6 خطوط قرآنية: QPC Hafs، KFGQPC Uthmanic-HAFS، Uthman Taha Naskh، AlQuranNeo، Indopak Nastaleeq، MeQuranVolt
  • نص عثماني + نص تجويد ملون + QCF Glyph-based rendering (604 صفحة)
  • وضع القراءة الليلية — ألوان كهرمانية مريحة + تقليل إضاءة + تفعيل تلقائي عند الغروب
  • دعم كامل للوضع الداكن والفاتح مع ألوان ديناميكية وتباين محسّن
  • Typography متجاوبة تضبط الخطوط تلقائياً لمئات أحجام الشاشات
  • حل جذري لمشاكل قص التشكيل (Font Clipping) مع عرض مثالي للحركات

التنقل الذكي والبحث

  • بحث قرآني سريع ودقيق داخل النص مع تمييز النتائج
  • فهرس متعدد المستويات: السور، الأجزاء، الأحزاب، الأرباع، الركوعات، الصفحات
  • انتقال مباشر للسورة/الآية/الصفحة/الجزء/الحزب
  • تنقل سريع بين الآيات مع أزرار التالي/السابق
  • حفظ آخر موضع قراءة تلقائياً مع إمكانية العودة إليه

التفاعل مع الآيات

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

🧠 وضع الحفظ (Hifz/Memorization Mode)

  • 3 مستويات إخفاء: مرئي (visible)، مضبب (blurred)، مخفي (hidden)
  • كشف الآية بالضغط — اضغط لإظهار الآية ثم إخفاؤها مرة أخرى
  • وضع الاختبار — اختبار تقدم الحفظ
  • تتبع تقدم الحفظ — خريطة سورة → عدد آيات محفوظة
  • تكرار الآية/النطاق أثناء الحفظ — تكرار ∞ أو N مرة

🧠 مكتبة الآية المتقدمة | Advanced Ayah Library

تحليل لغوي على مستوى الكلمة

  • مكتبة مدمجة داخل المصحف تُفتح بضغطة واحدة على أي آية
  • اختيار كلمة محددة من الآية لعرض بياناتها اللغوية فقط
  • عرض الآية كاملة مع إمكانية التنقل بين الآيات داخل المكتبة
  • واجهة نظيفة ومنظمة مع تبويبات واضحة لكل نوع من المعلومات

تبويبات المكتبة الشاملة (7 تبويبات)

📝 الترجمة (Word-by-Word Translation)

  • ترجمة كلمة بكلمة لكل كلمة في الآية
  • دعم متعدد اللغات مع إمكانية تحميل ترجمات إضافية
  • عرض الترجمة الكاملة للآية من الترجمات المفعّلة

🔤 الإعراب (Grammar Analysis)

  • إعراب تفصيلي لكل كلمة في الآية
  • شرح القواعد النحوية بشكل واضح ومبسط
  • تحديد نوع الكلمة (اسم، فعل، حرف) ووظيفتها النحوية

📚 الصرف (Morphology)

  • التحليل الصرفي الكامل للكلمة
  • الجذر اللغوي والوزن الصرفي
  • التصريفات المختلفة والمشتقات

🎵 القراءات (Qira'at)

  • القراءات العشر للكلمة المختارة
  • الفروق بين القراءات مع الشرح
  • أسماء القراء ورواياتهم
  • hasKhilaf badge — علامة عند وجود خلاف بين القراءات

📖 المتشابهات (Mutashabihat)

  • الآيات المتشابهة في القرآن الكريم
  • الربط بين الآيات المشتركة في الألفاظ والمعاني

📑 الموضوعات (Topics)

  • تصنيف الآيات حسب الموضوعات (العقيدة، العبادات، الأخلاق، وغيرها)

🔤 النطق اللاتيني (Transliteration)

  • النطق اللاتيني لكل آية لمساعدة غير الناطقين بالعربية

مشاركة وتصدير

  • مشاركة الآية كنص مع التفسير والترجمة
  • مشاركة كصورة بتصميم احترافي قابل للتخصيص
  • نسخ سريع للآية أو الترجمة أو التفسير

📚 نظام إدارة الموارد القرآنية | Resource Management System

مكتبة موارد شاملة

  • 61 تفسيراً موزعة على 25 لغة:
    • 12 تفسيراً عربياً: الطبري، ابن كثير، القرطبي، السعدي، الميسر، البغوي، الوسيط، المختصر، السراج، تنوير المقباس، الجلالين، أسباب النزول (الواحدي)
    • 5 تفاسير بنغالية: فتح المجيد، ابن كثير، أبو بكر زكريا، أحسن البيان، وغيرها
    • 10 تفاسير إنجليزية: ابن كثير المختصر، تذكير القرآن، معارف القرآن، المختصر، الجلالين، ابن عباس (تنوير المقباس)، أسباب النزول، القرطبي، الطبري، البغوي
    • 7 تفاسير أردية: بيان القرآن، السعدي، تذكير القرآن، ابن كثير، الجلالين، القرطبي، معارف القرآن
    • 4 تفاسير روسية: السعدي، المختصر، ابن كثير، الجلالين
    • 4 تفاسير إندونيسية: المختصر، ابن كثير، الجلالين، القرطبي
    • 3 تفاسير تركية: المختصر، ابن كثير، الجلالين
    • 3 تفاسير فارسية: المختصر، ابن كثير، الجلالين
    • 2 تفسير ماليزي: ابن كثير، الجلالين
    • تفاسير بـ 8 لغات أخرى: بوسنية، إسبانية، إيطالية، صينية، كردية، مالايالامية، فرنسية، أسامية، يابانية، ألبانية، خميرية، سواحيلية، هوسا، أمهرية
  • 209+ ترجمة بأكثر من 50 لغة:
    • 25 ترجمة إنجليزية: Saheeh International، Pickthall، Yusuf Ali، Muhsin Khan، Asad، وغيرها
    • 11 ترجمة أردية: تفهيم القرآن، فتح محمد جالندهري، محمد جوناگڑھی، وغيرها
    • 6 ترجمات إسبانية، فرنسية، أوزبكية
    • 5 ترجمات بنغالية، روسية، تركية
    • ترجمات بـ 40+ لغة أخرى: عربية، صينية، يابانية، كورية، فيتنامية، إندونيسية، ملايو، تايلاندية، هندية، فارسية، كردية، أمازيغية، سواحيلية، هوسا، يوروبا، صومالية، وغيرها الكثير
  • موارد كلمة بكلمة (Word-by-Word) بلغات متعددة
  • معلومات لغوية متقدمة (إعراب، صرف، قراءات، جذور الكلمات)

إدارة ذكية للتحميلات

  • عرض حجم الملف قبل التحميل لكل مورد
  • تتبع حالة التحميل مع شريط تقدم دقيق
  • إدارة التخزين مع عرض المساحة المستخدمة لكل مورد
  • حذف فردي أو جماعي للموارد المحملة
  • تحديث تلقائي للموارد عند توفر إصدارات جديدة

واجهات منفصلة ومنظمة

  • شاشة المكتبة المعاد تصميمها — NestedScrollView مع SliverAppBar + TabBar مدور بـ indicator متحرك
  • كروت موارد بورقية — ألوان AppColors + badge "مفعّل" + أنيميشن fade+slide سلسة
  • شاشة مستقلة للترجمات مع تصنيف حسب اللغة
  • شاشة مستقلة للتفاسير مع معلومات عن كل مفسر
  • شاشة موارد الكلمات لإدارة البيانات اللغوية
  • اختيار متعدد لتفعيل أكثر من ترجمة أو تفسير في نفس الوقت
  • نظام Fallback CDN — تحميل تلقائي من مصادر بديلة لو السيرفر الأساسي مش شغال

🎙️ نظام الصوتيات المتقدم | Advanced Audio System

مكتبة قراء ضخمة

  • 56 قارئاً من مختلف أنحاء العالم الإسلامي:
    • قراء مشهورون: عبد الباسط عبد الصمد، محمود خليل الحصري، مشاري راشد العفاسي، سعد الغامدي، ماهر المعيقلي، محمد صديق المنشاوي، ياسر الدوسري، عبد الرحمن السديس، أبو بكر الشاطري، وغيرهم
  • روايات متعددة: حفص عن عاصم، ورش عن نافع، قالون، الدوري، وغيرها
  • جودات صوتية: من 40kbps إلى 192kbps حسب الاحتياج

تحكم صوتي احترافي

  • شريط تحكم عائم يظهر أثناء التشغيل مع معلومات الآية الحالية
  • تشغيل مستمر للسورة كاملة أو نطاق محدد من الآيات
  • التكرار الذكي: تكرار آية واحدة، نطاق آيات، أو السورة كاملة (∞ أو N مرة)
  • تتبع كلمة بكلمة أثناء التشغيل (Audio Segments Highlighting) — تمييز الكلمة الحالية
  • تشغيل كلمة واحدة صوتياً + تشغيل تسلسل كلمات مع callback لكل كلمة
  • سرعة التشغيل القابلة للتعديل (0.5x إلى 2x)
  • التشغيل في الخلفية مع إشعار تحكم في شريط الإشعارات
  • الإيقاف التلقائي بعد مدة محددة (Sleep Timer) — دقائق أو نهاية السورة
  • الاستماع لنطاق آيات — من آية X إلى آية Y

تحميل وإدارة الصوتيات

  • تحميل السور بشكل فردي أو جماعي (Offline Audio)
  • مشغل أوفلاين كامل — 3 تبويبات: محتوى محمل، تحميل جديد، إدارة التخزين
  • قوائم تشغيل مخصصة — إنشاء/حذف/إعادة تسمية/إضافة سور
  • تشغيل أوفلاين تلقائي — يكتشف الملف المحلي تلقائياً
  • عرض حجم الملف قبل التحميل
  • إدارة التخزين مع إمكانية حذف السور المحملة
  • تشغيل مباشر من الإنترنت بدون تحميل (Streaming)

🕌 أدوات المسلم اليومية | Daily Muslim Utilities

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

  • حساب دقيق لمواقيت الصلاة حسب الموقع الجغرافي
  • طرق حساب متعددة: الهيئة العامة المصرية، رابطة العالم الإسلامي، أم القرى، الجامعة الإسلامية بكراتشي، وغيرها
  • تنبيهات قبل الأذان بوقت قابل للتخصيص
  • عرض الوقت المتبقي للصلاة القادمة
  • تقويم شهري يعرض أوقات الصلاة لكل يوم
  • تحديد تلقائي للموقع أو إدخال يدوي للمدينة

اتجاه القبلة

  • بوصلة دقيقة تحدد اتجاه القبلة باستخدام GPS والبوصلة المغناطيسية
  • عرض المسافة بينك وبين الكعبة المشرفة
  • واجهة ثلاثية الأبعاد مع رسوم توضيحية للكعبة
  • معايرة البوصلة لضمان الدقة

أذكار المسلم الشاملة

  • أذكار الصباح والمساء كاملة مع عدادات للتكرار
  • أذكار النوم والاستيقاظ
  • أذكار الصلاة (بعد كل صلاة)
  • أذكار متنوعة: دخول المسجد، الخروج من المنزل، الطعام، السفر، وغيرها
  • عداد تلقائي لكل ذكر مع إمكانية إعادة التعيين
  • تصميم جميل مع خلفيات متدرجة وخطوط واضحة

دليل السنن النبوية

  • سنن يومية مصنفة حسب الوقت والمناسبة
  • شرح مختصر لكل سنة مع الدليل الشرعي
  • تصنيفات متعددة: سنن الصلاة، الصيام، الذكر، الآداب، وغيرها
  • واجهة تفاعلية مع بطاقات منظمة وسهلة التصفح

مساحة الختمة الذكية

  • خطط ختم متعددة: ختمة شهرية، أسبوعية، أو مخصصة
  • تتبع التقدم مع رسوم بيانية توضح نسبة الإنجاز
  • تذكيرات يومية للورد المحدد
  • إحصائيات تفصيلية: عدد الصفحات المقروءة، الوقت المستغرق، معدل القراءة
  • سجل الختمات السابقة مع التواريخ

🔔 نظام الإشعارات المتقدم | Advanced Notification System

إشعارات قابلة للتخصيص بالكامل

  • تذكير الختمة اليومي بوقت محدد مع إمكانية تخصيص الرسالة
  • آية اليوم بإشعار يومي مع عرض الآية والترجمة
  • تذكير أذكار الصباح بوقت قابل للتعديل
  • تذكير أذكار المساء بوقت قابل للتعديل
  • إشعارات مواقيت الصلاة مع خيارات متعددة (قبل الأذان، عند الأذان، بعد الأذان)
  • إشعار تجريبي لاختبار النظام والتأكد من عمل الإشعارات

تحكم متقدم

  • تفعيل/تعطيل كل نوع من الإشعارات بشكل منفصل
  • اختيار نغمة الإشعار من مكتبة الأصوات أو من جهازك
  • أولوية الإشعارات (عالية، متوسطة، منخفضة)
  • إشعارات صامتة للقراءة بدون صوت
  • جدولة ذكية تتجنب الأوقات غير المناسبة

📱 التخصيص والإنتاجية | Personalization & Productivity

ويدجت آية اليوم المتقدم

  • ويدجت للشاشة الرئيسية يعرض آية مختارة يومياً
  • معاينة مباشرة (Live Preview) للتغييرات قبل التطبيق
  • تخصيص كامل للخط: اختيار من 20+ خط عربي (عثماني، نسخ، كوفي، ديواني، وغيرها)
  • تخصيص حجم الخط بدقة عالية
  • اختيار الثيم: فاتح، داكن، أو مخصص
  • ألوان قابلة للتخصيص: لون النص، لون الخلفية، لون الحدود
  • خلفية متدرجة مع اختيار لونين للتدرج
  • تثبيت آية معينة أو اختيار عشوائي يومي
  • تحديث فوري للويدجت من داخل التطبيق

إعدادات المصحف المتقدمة

  • اختيار خط القرآن: 6 خطوط قرآنية (QPC Hafs، KFGQPC Uthmanic، Uthman Taha Naskh، AlQuranNeo، Indopak Nastaleeq، MeQuranVolt)
  • اختيار تخطيط المصحف: صفحة واحدة، صفحة مزدوجة، تمرير مستمر
  • اختيار نمط النص: عثماني، تجويد ملون، إندوباك
  • حجم الخط قابل للتعديل بدقة
  • تباعد الأسطر للراحة البصرية
  • ألوان مخصصة للنص والخلفية والتشكيل
  • إظهار/إخفاء: رقم الآية، اسم السورة، رقم الصفحة، رقم الجزء
  • وضع القراءة الليلي مع سطوع قابل للتعديل + تفعيل تلقائي عند الغروب

الثيمات والمظهر

  • ألوان مستوحاة من تطبيق آية: Light Mode (Warm Beige + Sage Green) و Dark Mode (Deep Slate + Lighter Sage)
  • نظام ألوان مركزي — تغيير لون واحد في AppColors ينعكس على كل التطبيق
  • وضع فاتح/داكن/تلقائي بدون تعقيد FlexScheme — بساطة وأناقة
  • تأثيرات Glassmorphism مع شفافية وتمويه
  • كروت بورقية ناعمة مع ظلال خفيفة وborders رفيعة
  • رسوم متحركة سلسة (Flutter Animate) للانتقالات — 300-500ms، easeInOut

المجموعات والمفضلات

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

إعدادات اللغة والتوطين

  • دعم متعدد اللغات: العربية، الإنجليزية، الأردية، التركية، الإندونيسية، الملايو، الفرنسية
  • تبديل سريع بين اللغات من الإعدادات
  • واجهة RTL/LTR تلقائية حسب اللغة المختارة

🏗️ للمطورين | For Developers

معمارية احترافية

  • BLoC Pattern لإدارة الحالة بشكل منظم وقابل للاختبار
  • Clean Architecture مع فصل واضح بين الطبقات (Presentation, Domain, Data)
  • Dependency Injection باستخدام GetIt
  • Repository Pattern لإدارة مصادر البيانات
  • Use Cases منفصلة لكل عملية

جودة الكود

  • تفتيت الملفات الكبيرة: تم تقسيم mushaf_screen.dart (7600+ سطر) إلى مكونات مستقلة
  • Widgets قابلة لإعادة الاستخدام مع توثيق واضح
  • Extensions منظمة لفصل الوظائف (النطق، المشاركة، التنسيق)
  • تعليقات توضيحية باللغتين العربية والإنجليزية
  • معايير تسمية موحدة عبر المشروع

الأداء والتحسين

  • تحميل خطوط QCF عند الطلب بدلاً من تحميلها جميعاً مسبقاً
  • تقليل حجم الباندل بإزالة الأصول غير المستخدمة
  • تسريع أول تشغيل بتأجيل تهيئة الخدمات الثقيلة
  • Lazy Loading للموارد الكبيرة
  • Caching ذكي للبيانات المستخدمة بكثرة
  • تحسينات الذاكرة لتجنب التسريبات

قابلية التوسع

  • إضافة تفاسير جديدة بسهولة عبر نظام الموارد
  • إضافة ترجمات جديدة بدون تعديل الكود الأساسي
  • إضافة قراء جدد عبر ملفات JSON
  • إضافة لغات جديدة عبر ملفات التوطين
  • API جاهز للتكامل مع خدمات خارجية

الاختبار

  • Unit Tests للـ Use Cases والـ Repositories
  • Widget Tests للمكونات الأساسية
  • Integration Tests للتدفقات الكاملة
  • Mock Data جاهز للاختبار


📚 الموارد القرآنية المتاحة | Available Quranic Resources

📖 التفاسير (61 تفسيراً بـ 25 لغة)

التفاسير العربية (12):

  1. تفسير الطبري - الإمام الطبري
  2. تفسير ابن كثير - الإمام ابن كثير
  3. تفسير القرطبي - الإمام القرطبي
  4. تفسير السعدي - الشيخ عبد الرحمن السعدي
  5. التفسير الميسر - مجمع الملك فهد
  6. تفسير البغوي - الإمام البغوي
  7. التفسير الوسيط - مجمع البحوث الإسلامية
  8. المختصر في تفسير القرآن الكريم - مركز تفسير
  9. السراج في بيان غريب القرآن - الخضيري
  10. تفسير تنوير المقباس - ابن عباس
  11. تفسير الجلالين - الإمام السيوطي والمحلي
  12. أسباب النزول - الإمام الواحدي

تفاسير بلغات أخرى:

  • الإنجليزية (10): Ibn Kathir (Abridged), Tazkirul Quran, Maarif-ul-Quran, Al-Mukhtasar, Al-Jalalayn, Ibn Abbas (Tanwir al-Miqbas), Asbab Al-Nuzul, Al-Qurtubi, Al-Tabari, Al-Baghawi
  • الأردية (7): بيان القرآن، السعدي، تذكير القرآن، ابن كثير، الجلالين، القرطبي، معارف القرآن
  • البنغالية (5): فتح المجيد، ابن كثير، أبو بكر زكريا، أحسن البيان، وغيرها
  • الروسية (4): السعدي، المختصر، ابن كثير، الجلالين
  • الإندونيسية (4): المختصر، ابن كثير، الجلالين، القرطبي
  • التركية (3): المختصر، ابن كثير، الجلالين
  • الفارسية (3): المختصر، ابن كثير، الجلالين
  • الماليزية (2): ابن كثير، الجلالين
  • لغات أخرى: بوسنية، إسبانية، إيطالية، صينية، كردية، مالايالامية، فرنسية، أسامية، يابانية، ألبانية، خميرية، فيتنامية، تاغالوغية، سواحيلية، هوسا، أمهرية

🌍 الترجمات (150+ ترجمة بأكثر من 50 لغة)

أبرز الترجمات الإنجليزية (25 ترجمة):

  • Saheeh International
  • Marmaduke Pickthall
  • Abdullah Yusuf Ali
  • Muhammad Muhsin Khan & Taqi-ud-Din al-Hilali
  • Muhammad Asad
  • Dr. Mustafa Khattab (The Clear Quran)
  • Tafheem-ul-Quran (Abul A'la Maududi)
  • Maarif-ul-Quran
  • Abdul Haleem
  • Fadel Soliman (Bridges' Translation)
  • وغيرها...

الترجمات الأردية (11 ترجمة):

  • تفهيم القرآن - سيد أبو الأعلى المودودي
  • فتح محمد جالندهري
  • محمد جوناگڑھی
  • في ظلال القرآن
  • بيان القرآن
  • وغيرها...

لغات أخرى مدعومة (40+ لغة):

عربية، إسبانية، فرنسية، ألمانية، إيطالية، برتغالية، روسية، تركية، فارسية، أردية، بنغالية، هندية، إندونيسية، ملايو، صينية، يابانية، كورية، فيتنامية، تايلاندية، كردية، أمازيغية، سواحيلية، هوسا، يوروبا، صومالية، أمهرية، أوزبكية، كازاخية، طاجيكية، أذرية، تترية، أويغورية، بشتو، سندية، نيبالية، أسامية، مالايالامية، تاميلية، تيلوغو، كانادا، ماراثية، غوجاراتية، بنجابية، أورومو، أمهرية، كينيارواندا، لوغاندا، بامبارا، وغيرها...

🎙️ القراء (56 قارئاً)

قراء مشهورون:

  1. عبد الباسط عبد الصمد (مرتل 192kbps + مجود + ورش)
  2. محمود خليل الحصري (مرتل 128kbps + مجود)
  3. مشاري راشد العفاسي (مرتل 128kbps)
  4. سعد الغامدي (مرتل 40kbps)
  5. ماهر المعيقلي (مرتل 128kbps)
  6. محمد صديق المنشاوي (مرتل 192kbps + مجود)
  7. ياسر الدوسري (مرتل 128kbps + ورش)
  8. عبد الرحمن السديس (مرتل 192kbps)
  9. أبو بكر الشاطري (مرتل 128kbps)
  10. سعود الشريم (مرتل 128kbps)
  11. ناصر القطامي (مرتل 128kbps)
  12. أحمد العجمي (مرتل 128kbps)
  13. محمد أيوب (مرتل 64kbps)
  14. محمد جبريل (مرتل 64kbps)
  15. مصطفى إسماعيل (مجود 48kbps)
  16. خليفة الطنيجي (مرتل 128kbps)
  17. إدريس أبكر (مرتل 128kbps)
  18. فارس عباد (مرتل 64kbps)
  19. صلاح البدير (مرتل 128kbps)
  20. عبد الله المطرود (مرتل 128kbps)
  21. محمد اللحيدان (مرتل 128kbps)
  22. عبد الباري الثبيتي (مرتل 128kbps)
  23. محسن القاسم (مرتل 192kbps)
  24. بندر بليلة (مرتل 128kbps)
  25. علي جابر (مرتل 64kbps)
  26. هاني الرفاعي (مرتل 192kbps)
  27. محمد الطبلاوي (مجود 128kbps)
  28. محمود علي البنا (مجود 32kbps)
  29. فاتح سفر أغيتش (مرتل 64kbps)
  30. رعد الكردي (مرتل 128kbps)
  31. وديع اليمني (مرتل 128kbps)
  32. أيمن سويد (مرتل 64kbps)
  33. أكرم العلاقمي (مرتل 128kbps)
  34. ياسر سلامة (مرتل 128kbps)
  35. سهل ياسين (مرتل 128kbps)
  36. عزيز عليلي (مرتل 128kbps)
  37. توفيق الصايغ (مرتل 128kbps)
  38. عبد الله عواد الجهني (مرتل 128kbps)
  39. خالد القحطاني (ورش 192kbps)
  40. أحمد نعينع (مرتل 128kbps)
  41. عبد الله بصفر (مجود 192kbps)
  42. صلاح بوخاطر (مرتل 128kbps)
  43. إبراهيم الأخضر (مرتل 64kbps)
  44. علي الحذيفي (مرتل 64kbps)
  45. محمد عبد الكريم (مرتل 128kbps)
  46. عبد الرحمن العوسي (مرتل 128kbps)
  47. كريم منصوري (مرتل 40kbps)
  48. نبيل رفاعي (مرتل 40kbps)
  49. شهريار پرهيزگار (مرتل 48kbps)
  50. يوسف إدغوش (مرتل 128kbps)

قراء بروايات خاصة:

  • رواية ورش: عبد الباسط، إبراهيم الدوسري، ياسين الجزائري، عمر القزابري، ياسر الدوسري، خالد القحطاني
  • قراء معلمون: محمود خليل الحصري (معلم)، محمد صديق المنشاوي (معلم)

📊 إحصائيات المشروع | Project Statistics

  • أكثر من 150 ملف Dart منظمة في معمارية واضحة
  • أكثر من 60,000 سطر برمجي مع توثيق شامل
  • 61 تفسيراً بـ 25 لغة جاهز للاستخدام
  • 209+ ترجمة بأكثر من 50 لغة
  • 56 قارئاً بروايات متعددة (حفص، ورش، قالون)
  • 6 خطوط قرآنية + 3 تخطيطات مصحف
  • 8 تبويبات تفسير مع Pinnable Panels + Reorderable Tabs
  • 100+ ويدجت مخصص قابل لإعادة الاستخدام
  • 15+ شاشة رئيسية مع تنقل سلس
  • دعم كامل للوضع الداكن والفاتح (ألوان آية)
  • 290+ مورد قرآني قابل للتحميل عند الطلب

� أحدث التحديثات | Recent Changes

نظام الثيمات الجديد (Ayah-Inspired Theme)

  • إزالة FlexColorScheme — استبدال بنظام Light/Dark ثابت بألوان مستوحاة من تطبيق آية
  • AppColors مركزي — تغيير لون واحد ينعكس على كل التطبيق
  • Light Mode: Warm Beige (#F5EBE0) + Sage Green (#5D7263) + Cream surfaces
  • Dark Mode: Deep Slate (#343A40) + Lighter Sage (#839788) + Charcoal cards
  • AppTheme خالص — ThemeData مباشر بدون مكتبات خارجية

إعادة تصميم شاشة المكتبة

  • NestedScrollView + SliverAppBar — الهيدر بينقبض عند التمرير
  • TabBar مدور — indicator باللون الأساسي مع ظل خفيف
  • كروت بورقية — ألوان AppColors + badge "مفعّل" + أنيميشن fade+slide
  • إزالة الـ chip bar القديم — TabBar أنظف وأسلس

نظام تحميل الموارد المتقدم

  • HTML Detection — كشف تلقائي لو السيرفر بيرجع HTML بدل البيانات
  • Fallback CDN — تحميل تلقائي من مصادر بديلة (GitHub CDN)
  • Mutashabihat + Transliteration — fallback شغال من Waqar144 و risan CDN
  • رسائل خطأ واضحة بالعربي لو المورد مش متاح

QCF Package — ميزات جديدة

  • Sajda Verses Data — 14+1 سجدة مع نوعها (واجبة/مستحبة)
  • Surah Info Card — كروت معلومات السورة مع badge سجدة
  • Juz/Hizb Marker Overlay — علامات الجزء والحزب على صفحات المصحف
  • Page Position Indicator — Apple-style floating pill مع معلومات الصفحة
  • Reading Progress Tracker — تتبع التقدم مع streak و completion %
  • Waqf (Stop) Markers — 10 علامات وقف مع وصف عربي ولون مقترح

تحسينات المصحف

  • Responsive Rendering — حساب ديناميكي لأبعاد الصفحة حسب حجم الشاشة
  • 3 تخطيطات: صفحة واحدة، صفحة مزدوجة، تمرير مستمر
  • Classic Mushaf Border — إطار إسلامي كلاسيكي مع زخارف (قابل للتفعيل)
  • Overlay متجاوب — معلومات الجزء/الحزب/الربع بتتكبر مع المحتوى

نظام الصوتيات المتقدم

  • 56 قارئاً مع روايات متعددة
  • تتبع كلمة بكلمة أثناء التشغيل (IdrisiumAudioTracker)
  • تكرار ذكي — آية واحدة، نطاق، أو سورة كاملة
  • مؤقت النوم — دقائق أو نهاية السورة
  • تحميل أوفلاين — تحميل سور كاملة مع إدارة التخزين
  • قوائم تشغيل مخصصة — إنشاء/حذف/إعادة تسمية

معمارية الميزات الجديدة (PHASE 4–5)

  • Presentation BLoCs لكل ميزة: Audio، Tafsir، Azkar، Qibla، Hifz، Prayer — كل واحد بـ state/events محددة
  • Shared UI Widgets: SkeletonLoading، ErrorStateWidget، EmptyStateWidget، Pressable، AppCard، SectionHeader، AppChip
  • Feature Screens: Azkar (categories + items with type filter)، Qibla (custom compass painter)، Hifz (dashboard with stats grid)، Tafsir (list + detail)، Audio (reciter list)، Prayer Times (next prayer highlight)
  • Theme Compliance: ترحيل كل الـ deprecated ayaX color aliases لـ lightX token names — صفر hardcoded colors في الموديولات الجديدة
  • IDRISIUM Signature About Screen: glassmorphism cards، animated logo reveal، founder photo with glow، social links grid

وضع الحفظ والقراءة الليلية

  • 3 مستويات إخفاء: مرئي، مضبب، مخفي + وضع الاختبار
  • وضع القراءة الليلية — ألوان كهرمانية + تفعيل تلقائي عند الغروب

إزالة محتوى مخالف

  • شيلت أسباب النزول (الواحدي) — مش موثوق
  • شيلت الجلالين من 5 لغات + الوسيط + تنوير المقباس
  • مراجعة كاملة للترجمات والتفاسير — إزالة أي تأويل أو مخالفة

�🎯 الجمهور المستهدف | Target Audience

للمستخدمين

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

للمطورين

  • مطورو Flutter الذين يريدون دراسة معمارية احترافية في مشروع حقيقي
  • المهتمون بـ BLoC Pattern وتطبيقه في مشاريع كبيرة
  • المساهمون في المصادر المفتوحة الذين يريدون المشاركة في مشروع إسلامي نافع
  • المهتمون بتقنيات Rendering والتحديات المتعلقة بالخطوط العربية والعثمانية

🏗️ Architecture (BLoC + Clean Architecture)

التطبيق مبني كـ open-source Quran application حقيقي، مش مجرد واجهة—والهدف إن التطوير يفضل سهل ومضمون مع الوقت.

✅ مبادئ سريعة

  • Presentation: UI + Bloc/Cubit + Widgets.
  • Domain: Use-cases + Entities (منطق نظيف مستقل عن Flutter).
  • Data: Repositories + DataSources (Local/Assets/Downloads) + Models.

🔧 Tech Stack (مختصر وقوي)

  • Flutter 3.x + Dart 3+ (Records, Patterns, Sealed Classes)
  • flutter_bloc / Cubit (State Management)
  • qcf_quran_with_update (Uthmanic/QCF rendering + Sajda + Waqf + Reading Progress)
  • hive_ce (Offline local storage)
  • just_audio (Audio engine)
  • home_widget + workmanager (Home widget updates)
  • awesome_notifications (Notifications)
  • share_plus (Sharing)
  • flutter_animate (Subtle UI motion)
  • flutter_screenutil (Responsive design)
  • google_fonts / Cairo (Arabic typography)

🧩 Deep Refactor (معلومة مهمة للمساهمين)

تم تفتيت شاشة المصحف العملاقة mushaf_screen.dart (التي تجاوزت 7600 سطر) إلى مكونات مستقلة:

  1. widgets/: (الفهرس، الخيارات السفلية، الختمة، البحث، والتقييم) لتقليل الـCoupling.
  2. extensions/: فصل وظائف النطق/المشاركة كصورة باستخدام part.
  3. تحسينات لونية مركزية لدعم الوضع الداكن في النوافذ المنبثقة.

⚡ Performance & Packaging

تمت إضافة مسار واضح لتحسين الأداء وتقليل حجم الحزمة قبل التثبيت:

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

🚀 Installation

لتشغيل تطبيق "الفُرقان" على جهازك أو المساهمة في تطويره:

المتطلبات الأساسية (Prerequisites)

  • Flutter (3.x أو أحدث)
  • VS Code أو Android Studio

الخطوات (Steps)

  1. Clone
git clone https://github.com/IDRISIUMCorp/al-furkan-quran-flutter-app.git
  1. Install dependencies
flutter pub get
  1. Run (Android)
flutter run

ملاحظة للمطورين: التطبيق يعتمد على قواعد بيانات محلية (hive_ce) ولا يتطلب أي إعدادات خوادم أو مفاتيح API خارجية للتشغيل المبدئي.

🔍 SEO Keywords

الكلمات دي مقصودة لتحسين اكتشاف المشروع على GitHub والبحث وAI models بدون حشو.

  • Flutter Quran app
  • open-source Quran application
  • production-ready Flutter Quran application
  • BLoC + Clean Architecture Flutter
  • Uthmanic script rendering
  • QCF mushaf Flutter
  • word-by-word Quran (word-level tools)
  • tafsir and translation resources Flutter
  • Quran home widget (Ayah of the Day)
  • prayer times qibla azkar Flutter
  • offline-first Flutter app (Hive)

🤝 شكر وتقدير (Acknowledgments)

إن هذا الإنجاز التقني لم يكن ليخرج بهذا الكمال لولا فضل الله، ثم البناء على أعمال إخوة ومطورين كرام:

  1. العرض العثماني للقرآن (QCF Quran): تم الاستعانة بالمكتبة البرمجية الأساسية qcf_quran للمطور محمود عاطف (جزاه الله خيراً كبيراً).

    • إعادة الهندسة والتطوير: قام المهندس إدريس غامد بإجراء عملية إعادة بناء وتخصيص عميقة للمكتبة لتتوافق مع معايير الفُرقان، حيث شملت:
      • بناء وتكامل نظام QcfThemeData لدعم الألوان الديناميكية والـ(Dark/Light Mode).
      • تطوير Responsive Typography لضبط الخطوط تلقائيًا لمئات أحجام الشاشات.
      • إصلاح جذري لمشاكل قص التشكيل (Font Clipping).
  2. العمود الفقري وقاعدة البيانات: اعتمدنا في القواعد الأساسية (قاعدة بيانات القراء، تفريعات التفاسير، الترجمات، ومحرك حساب مواقيت الصلاة) على مشروع al_quran_v3 للمطور Ismail Hosen (بارك الله في جهده).

  3. مصادر الموارد القرآنية:

    • التفاسير والترجمات: Quranic Universal Library - مكتبة شاملة للموارد القرآنية
    • التلاوات الصوتية: EveryAyah.com و Quran.com - مصادر موثوقة للتلاوات القرآنية
    • البيانات الوصفية: Tanzil Project - بيانات دقيقة عن السور والآيات

⚖️ الترخيص الوقفي (Charity & License)

هذا المشروع يخضع لترخيص Apache License 2.0 مقترناً بـ شرط وقفي قطعي الدلالة:

التطبيق وكامل المصدر البرمجي (Source Code) الخاص به متاحان كـ "صدقة جارية" لوجه الله تعالى عن المطور الرئيسي إدريس غامد وشركة IDRISIUM Corp.

يُمنع منعاً باتاً وتاماً وتحت طائلة أي ظرف من الظروف بيع هذا الكود، أو طرح أي تطبيق مبني عليه بهدف التربح أو الاستخدام التجاري المغلق أو إضافة مساحات إعلانية ربحية. يجب أن تظل كافة النسخ المستنسخة منه مجانية للمسلمين 100% مع وجوب الالتزام بذكر المصدر والمطور الأصلي.

لمزيد من التفاصيل المعقمة وشروط الاستخدام، يرجى مراجعة ملف حقوق الملكية والترخيص المرفق LICENSE.


يقول عز وجل

"إِنَّا نَحْنُ نَزَّلْنَا الذِّكْرَ وَإِنَّا لَهُ لَحَافِظُونَ"


Star History

Star History Chart

About

One of the most advanced open-source Quran apps built with Flutter, combining BLoC, Clean Architecture, and precise Uthmanic script rendering with audio, Tafsir, and daily Islamic tools.

Topics

Resources

Code of conduct

Contributing

Stars

15 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages