ShafeeZekr

ShafeeZekr is a modern Android application designed to remind you to send blessings upon the Prophet Muhammad (Peace Be Upon Him). Built with Jetpack Compose and Material Design 3, it provides a clean, customizable experience with multi-language support and privacy-focused design.

Features

• Periodic Reminders: Set automatic audio reminders at customizable intervals (1 minute to 2 hours, or custom intervals)
• Quiet Hours: Configure time-based rules to pause reminders during specific periods, with support for weekly schedules and specific dates
• Master Volume Control: Independent volume control that temporarily overrides system volume during playback
• Multiple Sound Options: Choose from various reminder sounds with instant preview
• Material Design 3: Dynamic color theming (Monet), Light/Dark mode support, and smooth animations
• Multi-language Support: Fully localized in 8 languages:
  • English
  • Arabic (العربية)
  • Indonesian (Bahasa Indonesia)
  • Russian (Русский)
  • German (Deutsch)
  • Urdu (اردو)
  • Persian (فارسی)
  • Turkish (Türkçe)
• Boot Persistence: Reminders automatically resume after device restart
• Battery Optimization Handling: Intelligent management of battery optimization settings for reliable reminder delivery
• Privacy Focused: No data collection, no tracking, no analytics. See our Privacy Policy

Screenshots

Requirements

• Android 12 (API 31) or higher
• Android Studio Ladybug or newer
• JDK 17

Installation

1. Clone the repository:

   git clone https://github.com/islamalorabi/ShafeeZekr.git

2. Open the project in Android Studio
3. Sync Gradle files
4. Build and run on your device or emulator

Tech Stack

• Language: Kotlin
• UI Framework: Jetpack Compose
• Design System: Material 3
• Data Persistence: DataStore Preferences
• Architecture: MVVM pattern
• Libraries:
  • AndroidX Core and Lifecycle
  • Compose Navigation
  • Retrofit and Gson

Contributing

Contributions are welcome. To contribute:

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

Contact

• Telegram: @IslamAlorabI
• GitHub: github.com/islamalorabi

License

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