圣 Quran 应用
通过Flutter开发的神圣古兰经应用程序
- 星标
- 886
- 复刻
- 223
- 最近推送(UTC)
- 2026年9月10日
- 项目状态
- 未归档
原始 README
以下为英文项目原文快照,最新内容请访问 GitHub。
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
分类
使用的依赖
依赖清单 28 项
- 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_test开发依赖
{"sdk":"flutter"} - flutter_lints开发依赖
6.0.0 - mocktail开发依赖
1.0.5 - bloc_test开发依赖
10.0.0 - flutter_launcher_icons开发依赖
0.14.4
所在榜单
如何选择适合项目的代码仓?
先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。
- 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
- 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
- 使用前在 GitHub 核对 README、许可证与 Issues。
来源与维护
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗



