Noor - Your Companion for a Mindful Muslim Life

Noor is a beautifully designed Islamic mobile application built with Flutter. It's your all-in-one tool to help you stay on top of your daily prayers, read the Quran, track your progress, and much more. This project is open-source and we welcome contributions from the community.

✨ Features

🕌 Core Islamic Features

• Prayer Times: Get accurate prayer times based on your location with beautiful countdown timers.
• Qibla Direction: An easy-to-use compass to find the direction of the Kaaba with real-time accuracy.
• Quran Reader: Enhanced Quran reading experience with multiple translations, audio recitations, and bookmarking.
• Prayer Tracker: Track your daily prayers and monitor your progress with insightful statistics and streaks.
• Dhikr & Tasbih: A digital tasbih with haptic feedback and progress tracking for your daily dhikr.

🎯 New & Enhanced Features (v2.0.0)

📖 Quran Reading Enhancements

• Multi-Language Support: Read Quran in Arabic with translations in English, Amharic, and Oromo
• Audio Recitations: Listen to beautiful recitations by renowned Qaris
• Bookmarking System: Save your favorite verses and continue reading seamlessly
• Reading Progress: Track your Quran reading progress with visual indicators
• Enhanced UI: Beautiful typography and smooth scrolling for immersive reading experience

🔔 Prayer Reminders & Notifications

• Salah Reminders: Get notified 15 minutes before each prayer time
• Adhan Notifications: Beautiful Adhan sounds at prayer times
• Qadah Reminders: Never miss your missed prayers with smart Qadah tracking
• Customizable Alerts: Choose your preferred Adhan and reminder settings

🎬 Islamic Video Content

• Curated Islamic Videos: Watch verified Islamic content from trusted channels
• Shorts Mode: TikTok-style vertical scrolling for quick Islamic reminders and shorts
• Premium Video Experience: YouTube-level video browsing with elegant cards and animations
• Immersive Shorts Viewer: Full-screen shorts with double-tap likes, comments, and social features
• Offline Viewing: Download videos for offline access

⚡ Performance Enhancements

• Optimized Loading: Faster app startup and smoother navigation
• Memory Management: Improved memory usage for better performance
• Smooth Animations: Fluid transitions and micro-interactions throughout the app
• Background Processing: Efficient background tasks for notifications and updates

🤖 AI & Smart Features

• AI Assistant: An integrated AI chatbot to answer your Islamic queries
• Smart Recommendations: Personalized content suggestions based on your preferences
• Intelligent Search: Advanced search across Quran, Hadith, and Azkar

🎨 Design & UX

• Clean & Minimalist UI: A beautiful and intuitive user interface
• Dark Mode Support: Seamless dark/light mode switching
• Multi-Language Support: Available in English, Amharic, and Oromo
• Accessibility: Screen reader support and high contrast options

📸 Screenshots

Home Screen	Quran Reader	Qibla Compass
Prayer Stats	Islamic Videos	Shorts Viewer

🚀 Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Flutter SDK: Installation Guide
• An editor like VS Code or Android Studio.

Installation

1. Fork the repository

2. Clone the repo

   git clone https://github.com/your-github-username/noor.git
   

3. Install packages

   flutter pub get
   

4. Run the app

   flutter run
   

🆕 What's New in v2.0.0

Major Updates

• 🎬 Islamic Video Hub: Added comprehensive video content with premium YouTube-style browsing and TikTok-like shorts
• 📖 Enhanced Quran Experience: Multi-language support, audio recitations, and improved reading interface
• 🔔 Advanced Prayer Notifications: Adhan sounds, Qadah reminders, and customizable prayer alerts
• ⚡ Performance Boost: Significant improvements in app speed, memory usage, and user experience
• 🌍 Localization: Full support for English, Amharic, and Oromo languages

Technical Improvements

• Optimized state management with Riverpod
• Enhanced offline capabilities
• Improved accessibility features
• Better error handling and user feedback

🛠 Tech Stack & Packages

• Framework: Flutter
• State Management: Riverpod
• HTTP Requests: http
• Audio: just_audio & audioplayers
• Video: youtube_player_flutter & youtube_explode_dart
• Location & Compass: geolocator, geocoding, flutter_compass
• Local Storage: shared_preferences
• Notifications: flutter_local_notifications
• UI: google_fonts, flutter_svg, lottie, shimmer
• AI: flutter_gemini
• And many more...

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

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

Distributed under the MIT License. See LICENSE for more information.

📧 Contact

Anexon - @n3x0dev - anwarnasir0970@gmail.com

Project Link: https://github.com/anexdev1/noor

---

Made with ❤️ for the Muslim community