the-holy-quran-app
Holy Qur'an application developed via Flutter
- Stars
- 886
- Forks
- 223
- Last push (UTC)
- Sep 10, 2026
- Project status
- Active
Original README
English project snapshot. Visit GitHub for the latest content.
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!
📁 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) andpackages/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







☀ Light Mode Theme






🔗 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
🔑 License
- This project is licensed under the MIT License - see the LICENSE file for details
🧑 Author
Muhammad Hamza
You can also follow my GitHub Profile to stay updated about my latest projects:
If you liked the repo then kindly support it by giving it a star ⭐!
Copyright (c) 2020 MUHAMMAD HAMZA
Categories
Dependencies used
Dependency list 28 items
- flutter
{"sdk":"flutter"} - al_quran_repo
{"path":"packages/al_quran_repo"} - al_quran_api
{"path":"packages/al_quran_api"} - intl
0.20.3 - share_plus
13.3.0 - recase
4.1.0 - shimmer
4.0.0 - cupertino_icons
1.0.8 - supercharged
2.1.1 - dio
5.11.1 - url_launcher
6.3.2 - provider
6.1.5+1 - equatable
2.1.0 - flutter_bloc
9.1.1 - get_it
9.2.1 - freezed_annotation
3.1.0 - json_annotation
4.12.0 - iconsax
0.0.8 - hive_ce
2.19.3 - hive_ce_flutter
2.3.4 - shared_preferences
2.5.5 - package_info_plus
10.2.1 - collection
1.19.1 - flutter_testDevelopment
{"sdk":"flutter"} - flutter_lintsDevelopment
6.0.0 - mocktailDevelopment
1.0.5 - bloc_testDevelopment
10.0.0 - flutter_launcher_iconsDevelopment
0.14.4
Rankings
How do I choose a repository?
Start with your use case, compare repository activity, and check the original project before adopting it.
- Search by repository name, owner or description, then narrow the results by topic.
- Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
- Read the README, license and issues on GitHub before using a project.
Sources and maintenance
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗
- mhmzdev/the-holy-quran-app · GitHub ↗
- GitHub Docs — Saving repositories with stars ↗
- Directory maintained by Ducafecat ↗



