搜索插件、代码仓与 APP 分类

GitHub 代码仓mhmzdev/the-holy-quran-app

圣 Quran 应用

通过Flutter开发的神圣古兰经应用程序

圣 Quran 应用 项目封面
星标
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!

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 作者

Hamza ↗

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

@SastaTicket官方网站 ↗
语言DartEJSHTMLJavaScriptRakuRubyShellSwiftKotlinObjective-C

分类

使用的依赖

依赖清单 28 项

所在榜单

如何选择适合项目的代码仓?

先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。

  1. 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
  2. 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
  3. 使用前在 GitHub 核对 README、许可证与 Issues。

来源与维护

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗