the-holy-quran-app

From public sources

Holy Qur'an application developed via Flutter

ApplicationCategory: Mobile Apps · Reading & newsOpen sourcedata checked Oct 15, 2026

Overview

  • android-app
  • dart
  • dartlang
  • flutter
  • flutter-app

Installation

Commands are shown, never run by the marketplace. Check them against the official documentation.

Compatibility

Unknown means no evidence was found — not that the product is incompatible.
PlatformStatusArchitectureEvidenceConfidence
AndroidUnknown———
iOSUnknown———

Releases

checked Oct 29, 2026
No releases found on the source.

Quality profile

algorithm quality-v1.0 · assessed Oct 15, 2026
Quality Score68
Risk Score0
Confidence 1.00
Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 2016
last activity 36 days ago
Documentation · 1515
README 5953 chars, description present
Ready to use · 150
install instructions: no; releases: no
Metadata · 1010
4/4 of description, homepage, license, topics
Releases · 102
0 release(s)
Category confidence · 108
classifier confidence 0.75
Adoption · 107
888 stars (log-dampened, 10k = max)
License clarity · 55
SPDX MIT
Community · 55
issues enabled, 224 forks

License

MIT
Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/mhmzdev/the-holy-quran-appPrimary★ 888 starslast activity Sep 10, 2026Primary repository · Confidence 1.00

Reviews

Sign in to write a review

No reviews yet.

Alternatives

README

From mhmzdev/the-holy-quran-app · license MIT · fetched Oct 29, 2026

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!

[Open Source Love svg1] [GitHub Forks] [GitHub Issues] [contributions welcome]

📁 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

☀ 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

[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

Open the repository ↗