📱 Al-Quran Kareem - Digital Quran App

A beautiful and comprehensive digital Quran application built with Flutter, providing Muslims worldwide with easy access to the Holy Quran.

✨ Features

📖 Quran Reading

• Complete Quran: All 114 Surahs with authentic Arabic text
• Multiple Translations: Urdu and English translations
• Beautiful Typography: Easy-to-read Arabic fonts
• Verse-by-verse navigation: Jump to any Surah or Ayah
• Night Mode: Dark theme for comfortable reading

🎵 Audio Features

• Audio Recitation: Beautiful Quranic recitation
• Multiple Reciters: Choose from various renowned Qaris
• Offline Audio: Download and listen without internet
• Playback Controls: Play, pause, and repeat functionality

🔖 Personal Features

• Smart Bookmarks: Save your reading progress
• Notes & Annotations: Add personal notes to verses
• Reading History: Track your reading journey
• Favorites: Mark your favorite verses

🕐 Islamic Tools

• Prayer Times: Accurate prayer timings based on location
• Qibla Direction: Find the direction to Mecca
• Islamic Calendar: Hijri calendar with important dates
• Tasbih Counter: Digital prayer counter

🎨 Customization

• Multiple Themes: Light and dark mode
• Font Size Control: Adjust text size for comfort
• Color Schemes: Choose from various color themes
• Language Support: Multiple interface languages

📱 Screenshots

Screenshots will be added soon

🚀 Getting Started

Prerequisites

• Flutter SDK (>=3.0.0)
• Dart SDK (>=2.17.0)
• Android Studio / VS Code
• Android SDK / Xcode (for iOS)

Installation

1. Clone the repository

   git clone https://github.com/NaeemAkmal/myquran.git
   cd myquran

2. Install dependencies

   flutter pub get

3. Run the app

   flutter run

Building for Release

Android APK:

flutter build apk --release

Android App Bundle:

flutter build appbundle --release

iOS:

flutter build ios --release

📁 Project Structure

lib/
├── main.dart                 # App entry point
├── models/                   # Data models
├── screens/                  # UI screens
├── widgets/                  # Reusable widgets
├── services/                 # API and local services
├── utils/                    # Utility functions
└── constants/                # App constants

assets/
├── images/                   # App images
├── audio/                    # Audio files
├── data/                     # JSON data files
└── fonts/                    # Custom fonts

🛠️ Built With

• Flutter - UI framework
• Dart - Programming language
• Hive - Local database
• Provider - State management
• HTTP - API calls
• Just Audio - Audio playback
• Geolocator - Location services
• Share Plus - Sharing functionality

📊 App Statistics

• 114 Surahs - Complete Quran
• 6,236 Verses - Every Ayah included
• Multiple Languages - Arabic, Urdu, English
• Offline Support - Works without internet
• Cross Platform - Android & iOS

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Quran Text: Authentic Quranic text from reliable sources
• Translations: Verified Urdu and English translations
• Audio Recitations: High-quality recitations from renowned Qaris
• Islamic Data: Prayer times and Qibla direction algorithms

📞 Contact

Developer: Naeem Akmal
GitHub: @NaeemAkmal
Email: naeemakmaltts15@gmail.com

🔒 Privacy Policy

Privacy Policy: View Privacy Policy

🌟 Support

If you find this app helpful, please give it a ⭐ star on GitHub!

---

"وَنُنَزِّلُ مِنَ الْقُرْآنِ مَا هُوَ شِفَاءٌ وَرَحْمَةٌ لِّلْمُؤْمِنِينَ"

"And We send down of the Quran that which is healing and mercy for the believers" - Quran 17:82