Prayer Times & Mosque Finder

بسم الله الرحمن الرحيم

In the name of Allah, the Most Gracious, the Most Merciful

This simple web application helps Muslims find prayer times for their location and discover nearby mosques. It uses OpenStreetMap data and the Aladhan API for accurate prayer times. This project is released under the GNU General Public License v3.0 and is aligned with the principles of the Waqf General Public License as a form of Sadaqa Jariah (continuous charity).

Features

• Get prayer times based on user location or entered city
• Display current date in both Gregorian and Hijri calendars
• Show current sun position (altitude and azimuth)
• Find nearby mosques within a 5km radius
• Provide directions to mosques using OpenStreetMap

Technologies Used

• HTML5
• CSS3 (with Tailwind CSS)
• JavaScript (ES6+)
• Leaflet.js for maps
• OpenStreetMap & Nominatim for geocoding and map data
• Aladhan API for prayer times
• Overpass API for finding nearby mosques

Setup

1. Clone the repository:

   git clone https://github.com/jadmadi/prayer-times-mosque-finder.git
   

2. Navigate to the project directory:

   cd prayer-times-mosque-finder
   

3. Open index.html in your web browser.

Usage

1. Allow location access or enter a city name.
2. Click "Detect Location & Get Prayer Times" or "Get Prayer Times for City".
3. View prayer times, sun position, and nearby mosques.
4. Click on "Get Directions" for any mosque to open OpenStreetMap directions.

Contributing

Contributions are welcome! Please consider:

• Starring the repository on GitHub
• Sharing it with others who might benefit
• Contributing to its development
• Providing feedback or suggestions for improvement

By contributing to this project, you agree that your contributions will be licensed under the GNU General Public License v3.0.

License

This project is primarily licensed under the GNU General Public License v3.0. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Additionally, this work adheres to the principles of the Waqf General Public License, aiming to make the work a perpetual charitable endowment (Waqf) for the benefit of all Muslims.

Author

• Name: Jad Madi
• GitHub: @jadmadi
• Email: jad@madi.se
• Website: https://madi.se
• LinkedIn: https://linkedin.com/in/hakammadi

For professional inquiries or collaborations, please contact via LinkedIn or website.

Acknowledgements

This project utilizes the following third-party resources:

• OpenStreetMap (© OpenStreetMap contributors)
• Leaflet.js
• Aladhan API
• Tailwind CSS
• Ojuba-org - Waqf License

May Allah accept this work and make it beneficial for the Ummah.

---

Last updated: 03 Muḥarram 1446 AH (10/07/2024)