搜尋套件、儲存庫與 APP 分類

GitHub 儲存庫abdulwahed-s/Huda

胡達

胡達——伊斯蘭伴侶應用

胡達 專案封面
星標
7
分支
1
最近推送(UTC)
2026年9月28日
專案狀態
未封存

原始 README

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

Huda App Logo

Huda - Islamic Companion App

Version Github Downloads Badge

Get it on Google Play Get it at IzzyOnDroid Get it on GitHub Get it on Microsoft Store Get it on App Store Get it on App Store


Huda is a comprehensive Flutter-based Islamic companion application designed to help Muslims practice their faith with ease and convenience. The app provides essential Islamic tools, resources, and features to support daily worship and spiritual growth.

📑 Table of Contents


📸 Screenshots

Home Quran Reader Prayer Times
Home Screen Quran Reader Prayer Times
Qiblah Compass Islamic Reminder Daily Checklist
Qiblah Compass Islamic Reminder Islamic Checklist

🚀 Quick Start

Prerequisites
  • Flutter SDK: 3.44.2 (pinned in .fvmrc)
  • Dart SDK: 3.12.2 (bundled with Flutter 3.44.2)
  • Android builds: JDK 17, Android SDK Platform 37.0, and Build Tools 37.0.0
Installation
1. Clone the repository
git clone https://github.com/abdulwahed-s/Huda.git
cd Huda
2. Install dependencies
flutter pub get
3. Configure Firebase (Optional but Recommended)
  1. Create a Firebase project and register your applications.
  2. Place google-services.json inside:
android/app/
  1. Place GoogleService-Info.plist inside:
ios/Runner/
  1. Configure your API keys in:
lib/core/keys/hadith_key.dart

For more information, see: https://github.com/abdulwahed-s/Huda/issues/1

4. Run the application
flutter run

🌟 Key Features

📖 Quran Reading & Study
  • Complete Quran with authentic Uthmanic script
  • Multiple translations and Tafsir support
  • Audio recitations with offline playback
  • Smart reading position tracking
🕌 Prayer Times & Adhan
  • Accurate location-based prayer times
  • Adhan notifications and countdown timers
  • Multiple calculation methods
🧭 Qiblah Compass
  • Accurate Qiblah direction
  • Smooth animations with haptic feedback
📿 Digital Tasbih
  • Persistent Dhikr counter
  • Notes and tracking support
🤲 Athkar & Duas
  • Categorized daily supplications
  • Audio pronunciation support
✅ Islamic Daily Checklist
  • Track prayers and habits
  • Hijri calendar integration
  • Daily streak tracking
🤖 Huda AI Assistant
  • AI-powered Islamic Q&A assistant
  • Responses based on authentic Sunni sources, Quran, and Hadith
📚 Hadith & Islamic Library
  • Curated Islamic books and Hadith collections
  • Built-in offline PDF reader
📱 Home Screen Widgets
  • Quick access to prayer times and core features
🌍 Multilingual Support & Themes
  • RTL Arabic support
  • Dynamic language switching
  • Dark and Light themes

🤝 Contributing

Contributions are always welcome and greatly appreciated.

Whether you're fixing bugs, improving performance, adding features, or translating content, your support helps make Huda better for the Ummah.

How to Contribute
  1. Fork the repository
  2. Create a new branch
git checkout -b feature/amazing-feature
  1. Commit your changes
git commit -m "Add amazing feature"
  1. Push to your branch
git push origin feature/amazing-feature
  1. Open a Pull Request

Please ensure all contributions align with authentic Islamic principles and the purpose of the application.


📄 License & Contact

This project is licensed under the MIT License. See the LICENSE file for more information.

🐛 Bug Reports & Feature Requests

Please use GitHub Issues to report bugs, request features, or share suggestions.


🤲 Islamic Disclaimer

Huda is designed to assist Muslims in worship, learning, and daily practice.

While we strive to provide authentic and accurate Islamic content, users are encouraged to consult qualified scholars for religious guidance and important matters.

The AI assistant provides responses based on established Islamic sources and should not replace knowledgeable scholars or trusted religious authorities.


May Allah ﷻ accept this work and make it beneficial for the Ummah. Ameen.

“And whoever does righteous deeds, whether male or female, while being a believer — those will enter Paradise and will not be wronged, even as much as the speck on a date seed.” — Quran 4:124

Abdulwahed GitHub avatar
GitHub 作者

Abdulwahed ↗

語言DartKotlinSwiftTypeScriptC++CMakeRubyPythonPowerShellInno SetupShellCHTMLObjective-C

分類

使用的依賴

依賴清單 75 項

App 分類

如何選擇適合專案的儲存庫?

先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。

  1. 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
  2. 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
  3. 使用前在 GitHub 確認 README、授權條款與 Issues。

來源與維護

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

GitHub Docs — About repositories ↗