mhmzdev/the-holy-quran-app

The Holy Qur'an

Updated 2026-09-10. The maintained, in-depth documentation lives in docs/.

Application of Holy book of Muslims, Al-Qur'an. Developed using Flutter The data is fetched using API and now the offline mode is available. So, you need internet for the first time only!

https://user-images.githubusercontent.com/43790152/163690699-e5a08def-5b9b-49f2-93d4-7f3ff5ee1862.png

📁 Download Now

Get it from Play Store

🎥 Promo Video

Watch the promo video here.

💻 Installation steps

• Flutter 3.47.3 (Dart 3.13) pinned with FVM via .fvmrc
• Android target/compile SDK 36, min SDK 24 · iOS 15+

git clone https://github.com/mhmzdev/the-holy-quran-app.git
cd the-holy-quran-app
fvm install
fvm flutter pub get
fvm flutter run

🧱 Tech stack

• Flutter 3.47.3 / Dart 3.13 via FVM · state: flutter_bloc + provider + get_it
• Data: alquran.cloud over Dio, cached offline with Hive CE; Freezed models — split into packages/al_quran_api (client, models, data provider, codegen) and packages/al_quran_repo (repositories)
• Android: Kotlin DSL Gradle (AGP 9.1, Gradle 9.3), target/compile SDK 36, min SDK 24 · iOS: 15+, buildable but not published · Web: build currently broken

🛠 Development

fvm flutter analyze && fvm flutter test                          # gates before a PR
cd packages/al_quran_api && fvm dart run build_runner build      # after changing models
fvm flutter build appbundle --release                            # Play Store bundle (needs android/key.properties)
fvm flutter build apk --release                                  # sideload/test build

Project documentation (architecture, conventions, ADRs, domain notes, release process) lives in docs/. AI-agent guidance is in AGENTS.md with path-scoped rules and skills under .agents/.

📱 Screen Shots

https://user-images.githubusercontent.com/43790152/115233270-1c961780-a131-11eb-9dcd-16338c78f222.gif https://user-images.githubusercontent.com/43790152/115108730-73fa8300-9f8b-11eb-9001-2c57b12e059d.jpg https://user-images.githubusercontent.com/43790152/115233367-3f283080-a131-11eb-98e1-247dd43cf8ef.gif https://user-images.githubusercontent.com/43790152/115233411-4f401000-a131-11eb-91fb-d355fca4ae38.gif

https://user-images.githubusercontent.com/43790152/115233478-64b53a00-a131-11eb-88a2-88284cce1769.gif https://user-images.githubusercontent.com/43790152/115233470-60891c80-a131-11eb-9057-c177509d2f0c.gif https://user-images.githubusercontent.com/43790152/115233480-667efd80-a131-11eb-8dfb-adff08cfc463.gif https://user-images.githubusercontent.com/43790152/115233600-8b737080-a131-11eb-8ee5-bed207a234cc.gif

https://user-images.githubusercontent.com/43790152/115108661-1cf4ae00-9f8b-11eb-8947-2cbfae98016e.jpg https://user-images.githubusercontent.com/43790152/115108613-da32d600-9f8a-11eb-88dd-057b1304631a.jpg

☀ Light Mode Theme

https://user-images.githubusercontent.com/43790152/115233109-f40e1d80-a130-11eb-8c3a-ac3e2686dbad.gif https://user-images.githubusercontent.com/43790152/115233686-a7771200-a131-11eb-9502-ba8d63a40157.jpeg https://user-images.githubusercontent.com/43790152/115233677-a5ad4e80-a131-11eb-925c-8adfa04c6876.jpeg https://user-images.githubusercontent.com/43790152/115233689-a80fa880-a131-11eb-888e-e5d97424f9f2.jpeg https://user-images.githubusercontent.com/43790152/115233684-a6de7b80-a131-11eb-86cd-7d3ca74fcd79.jpeg https://user-images.githubusercontent.com/43790152/115233681-a645e500-a131-11eb-8e85-10343086412e.jpeg https://user-images.githubusercontent.com/43790152/115233695-a8a83f00-a131-11eb-9bed-202292be47e7.jpeg

🔗 API Information

API Used: https://alquran.cloud/api

🎯 Features Updated

✅ Offline Mode - Improved

✅ Search Surah

✅ Search Juz

✅ Bookmarks

✅ Other fixes from Previous verion.

⭐️ Star History

Star History Chart

🔑 License

• This project is licensed under the MIT License - see the LICENSE file for details

🧑 Author

Muhammad Hamza

LinkedIn Link

You can also follow my GitHub Profile to stay updated about my latest projects:

GitHub Follow

If you liked the repo then kindly support it by giving it a star ⭐!

Copyright (c) 2020 MUHAMMAD HAMZA