🚀 Getting Started
First Launch Setup
- Grant Location Permission: Allow location access for accurate prayer time calculations
- Choose Calculation Method: Select from 15+ trusted Islamic authorities (MWL, ISNA, Karachi, etc.)
- Set Madhab: Choose between Hanafi or Shafi/Maliki/Hanbali for Asr calculation
- Verify Settings: Check that your location and timezone are detected correctly
Initial Configuration
- Automatic location detection and timezone
- Default: Muslim World League (MWL) calculation
- 12-hour time format by default
- Beautiful light theme enabled
🕌 Main Features Guide
1. Home Screen
Overview Display: Current date, time, and today's prayer schedule
Quick Actions: Tap any prayer time for details, swipe down to refresh
Format Toggle: Switch between 12H/24H in top-right corner
2. Today's Prayers Screen ⭐
Enhanced Next Prayer System
- Current Prayer Purple indicator showing which prayer period you're in
- Smart Countdown: Color-coded timer with urgency levels
- Progress Bars: Visual countdown representation
- Tomorrow's Prayer: Automatic next-day Fajr display after Isha
Intelligent Time Display
- Long periods: "6h 2m" format for easy reading
- Urgent periods: "4m 23s" for precise countdown
- Real-time updates: Refreshes every second
3. Qibla Direction Screen
🧭 Precision Compass: Accurate direction to Mecca with smooth sensor integration
📏 Distance Display: Exact distance to Kaaba in kilometers/miles
⚙️ Calibration: Auto-calibration with manual override options
4. Monthly Times & Settings
Monthly Calendar: Complete month view with navigation
Advanced Settings: 15+ calculation methods, location override, theme selection
⭐ Enhanced Next Prayer System
🎨 Color-Coded Urgency System
The app uses intelligent colors to help you prepare for prayers:
🟣 Normal
More than 2 hours - Your brand color for distant prayers
🟢 Distant
1-2 hours remaining - Plenty of time
🟡 Soon
30 minutes to 1 hour - Start preparing
🟠 Urgent
5-30 minutes - Time to prepare for prayer
🔴 Immediate
Less than 5 minutes - Prayer time approaching!
📊 Visual Progress Features
- Progress Bar: Visual countdown representation with brand colors
- Urgency Dot: Color indicator matching current urgency level
- Smart Formatting: Adapts display based on time remaining
- Real-time Updates: Live countdown with smooth transitions
📊 Calculation Methods Guide
🌍 Global Methods
- Muslim World League (MWL): Most widely used globally
- ISNA: Popular in North America
- Egyptian General Authority: Egypt and nearby regions
🌏 Regional Methods
- University of Islamic Sciences, Karachi: South Asia
- Umm al-Qura (Makkah): Saudi Arabia official
- Institute of Geophysics, Tehran: Iran region
- Turkey Diyanet: Turkey's official calculations
⚖️ Madhab Differences
Hanafi: Asr begins when shadow = object length + original shadow
Shafi/Maliki/Hanbali: Asr begins when shadow = object length
🎯 Advanced Features
🚀 Performance Excellence
- Hermes JavaScript engine - 50% faster startup
- New Architecture support for enhanced performance
- Efficient memory usage and battery optimization
- Modern edge-to-edge display on Android 15+
🔒 Privacy & Security
- No ads, subscriptions, or data collection
- Complete offline functionality after setup
- Local storage only - no cloud data
- Minimal permissions (location for calculations only)
🔧 Troubleshooting
📍 Location Issues
Problem: Inaccurate prayer times
Solutions:
- Check location permissions in phone settings
- Ensure GPS is enabled
- Pull down to refresh on main screen
- Manually set location in Settings if needed
🕐 Time Display Issues
Problem: Times seem incorrect
Solutions:
- Verify timezone in Settings
- Try MWL calculation method for global standard
- Check Madhab setting matches your preference
- Confirm location accuracy
🌟 Pro Tips
🎯 Maximize Accuracy
- Use "High Accuracy" location setting
- Keep location services enabled
- Choose calculation method based on your region
- Update location when traveling significantly
🔋 Optimize Battery
- Use "Balanced" location mode for efficiency
- Enable auto dark theme for OLED screens
- Close app when not actively using
- Times calculate fresh each launch
✈️ Travel Tips
- App auto-detects new timezone
- Refresh after significant location changes
- Verify calculation method for new region
- Check local mosque preferences if available
🆘 Support & Contact
📞 Get Help
For additional support or feedback, please contact us through:
💡 Feature Requests
We love hearing from our users! If you have suggestions for new features or improvements, please reach out through our app store listing or website.