A high-performance, immersive Prayer Times mobile application. Fully free, open-source, privacy-focused, and tailored for Muslims worldwide.
- Pinpoint Calculation: Powered by the industry-standard
adhan.jslibrary, ensuring calculations match your local methodology. - Continuous Precision Checks: Monitors prayer status and next-prayer countdowns every 5 seconds.
- Sunnah Times: Built-in displays for Midnight and the Last Third of the Night.
- Dynamic Adjustments: Manual offset adjustments (+/- minutes) for Fajr, Sunrise, Dhuhr, Asr, Maghrib, and Isha.
- High-Quality Recitations: Includes beautiful, clear audio streams/local assets:
- 🕌 Makkah (Al-Haram)
- 👤 Mishary Rashid Al-Afasy
- ⚡ Short Adhan (Takbir Only)
- Capacitor Notifications: Integrates with Android & iOS local notification APIs for robust offline alerts.
- Silent Mode Customization: Mute individual prayers or mute all with a single toggle.
- Dua Post-Adhan: Optional screen displaying the authentic Dua recited after the Adhan.
- Sensor Smoothing: Highly responsive, real-world compass layout using the device's magnetometers and orientation sensors.
- Declination Corrections: Calculations match the spherical trigonometry required to target the Kaaba from your precise location.
- Haptic Feedback: Feels like a real mechanical counter with crisp vibration ticks.
- Persistent Stats: Automatically saves your session totals and high-score count to local storage.
- Accent Theming: Multiple gorgeous color profiles (Teal, Emerald, Gold, Rose, Ocean, Sand).
- System Sync: Automatic detection of light/dark preferences and system language (supporting English & Arabic out of the box).
- Smooth Animations: Framer Motion (via
motion) handles entry animations, modal slides, and interface transitions flawlessly.
- Zero telemetry, zero external trackers, and no advertisements.
- Location queries are kept purely on-device (via browser/native GPS API).
- Frontend: React 19 with Vite
- Styling: Tailwind CSS v4
- Calculations: Adhan.js
- Mobile Wrapper: Capacitor v8 (Android configuration ready)
- State/Animations: Motion & date-fns
- Node.js (v18+)
- npm or yarn
- For Android: Android Studio and SDKs installed.
To build the native Android application package:
-
Compile the production assets:
npm run build
-
Sync the assets with Capacitor:
npx cap sync
-
Open the project in Android Studio:
npx cap open android
-
Run the project directly onto your connected device or virtual emulator from Android Studio.
├── android/ # Android native platform folder (Capacitor)
├── public/ # Static assets (sounds, icons)
│ └── sounds/ # High-quality Adhan MP3 files
├── src/
│ ├── hooks/ # Custom React hooks (e.g. usePrayerTimes)
│ ├── lib/ # Calculations, constants, localizations, and themes
│ ├── App.tsx # Core layout, tabs, state management
│ ├── index.css # Tailwind styles and custom base rules
│ └── main.tsx # React root initialization
├── capacitor.config.json # Capacitor runtime settings
├── vite.config.ts # Vite bundler configurations
└── tsconfig.json # TypeScript configuration settings
Contributions, feature requests, and issue reports are welcome! Feel free to open a Pull Request or create an Issue.
This project is licensed under the MIT License. See the LICENSE file for details.
Developed with ❤️ for the Ummah.