聖 Qurān 應用
透過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 ↗



