mhmzdev/the-holy-quran-app

技術主題

# flutter # flutter-app # dartlang # dart # android-app

使用的依賴

依賴清單 28 項

flutter{"sdk":"flutter"}
al_quran_repo{"path":"packages/al_quran_repo"}
al_quran_api{"path":"packages/al_quran_api"}
intl0.20.3
share_plus13.3.0
recase4.1.0
shimmer4.0.0
cupertino_icons1.0.8
supercharged2.1.1
dio5.11.1
url_launcher6.3.2
provider6.1.5+1
equatable2.1.0
flutter_bloc9.1.1
get_it9.2.1
freezed_annotation3.1.0
json_annotation4.12.0
iconsax0.0.8
hive_ce2.19.3
hive_ce_flutter2.3.4
shared_preferences2.5.5
package_info_plus10.2.1
collection1.19.1
flutter_test開發依賴{"sdk":"flutter"}
flutter_lints開發依賴6.0.0
mocktail開發依賴1.0.5
bloc_test開發依賴10.0.0
flutter_launcher_icons開發依賴0.14.4

所在榜單

Production#112

原始 README

以下為英文專案原文快照，最新內容請造訪 GitHub。

展開 / 收合專案 README

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

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

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 ⭐!

Hamza ↗