Search packages, repositories and app categories

GitHub repositorymhmzdev/the-holy-quran-app

the-holy-quran-app

Holy Qur'an application developed via Flutter

the-holy-quran-app project cover
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!

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

Hamza GitHub avatar
GitHub author

Hamza ↗

Beyond prompts: Engineering AI systems | Product engineering | Helping others how to flutter 😃

LanguagesDartEJSHTMLJavaScriptRakuRubyShellSwiftKotlinObjective-C

Categories

Dependencies used

Dependency list 28 items

Rankings

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. 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 ↗