Skip to content

Latest commit

 

History

History
198 lines (148 loc) · 9.24 KB

README.md

File metadata and controls

198 lines (148 loc) · 9.24 KB

Contributors Forks Stargazers Issues MIT License LinkedIn Telegram


Logo

Islam

Quran, Hadiths, Sunnah and Dhikrs in one place!
Download the latest app »

Screenshots · Report Bug · Request Feature

Table of Contents

About The Project

The Islam Application is a mobile app created for Muslims, offering access to the Quran, Sunnah, and Dhikrs. The app is designed to serve as a valuable resource for Muslims who are looking to enhance their knowledge and practice of Islam.

The app has been developed with the intention of being a source of reward for its contributors. Contributors to the app can earn sadaqah jariyah, a form of ongoing charity that continues to benefit the giver even after they have passed away, by contributing to its development.

The Islam Application has been built using the Ionic iOS theme, and offers both dark and white modes for the user's convenience. We welcome contributions to the app from the community, and encourage contributors to refer to the CONTRIBUTING.md file for guidelines on how to contribute.

We hope that the Islam Application will prove to be a valuable resource for Muslims worldwide, and we welcome your feedback and suggestions on how we can improve the app further.

(back to top)

Features

The Islam Application includes the following features:

  • Read the Holy Quran with 147+ translations
  • Dark and white mode options for reading
  • Built with the Ionic iOS theme for a seamless and responsive experience
  • Location-based prayer times feature provides accurate timings for sunset, sunrise, first third, last third, and midnight times
  • Choose from over 15+ prayer time calculation methods, default to Ummul Qura University
  • Set reminders for prayer times with notifications to never miss a prayer again
  • About screen with contributors list
  • Change font size and font family from 18+ handpicked options
  • Easily switch between reading mode and translations, and move to next or previous chapter or scroll to top of the chapter
  • Sort Quran chapters by Surah no, revelation order, or juzs order
  • Efficient search function for Quran chapters
  • Countdown for the next prayer
  • Display of Hijri and Gregorian date of today.

(back to top)

Getting Started

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

Prerequisites

  • npm or yarn (yarn preferred)
  • nodejs version 18.12+

Installation and running

  1. Install ionic and capcitor globally npm i -g @ionic/cli @capacitor/cli.
  2. Install dependencies yarn install
  3. To start development server locally run ionic serve

Testing

  1. Install playwright browsers yarn playwright install --with-deps chromium chrome
  2. Run test cases yarn playwright test

Contributing

We welcome and greatly appreciate your contributions to the Islam app project. If you're interested in contributing, please refer to the guidelines outlined in the CONTRIBUTING.md file. May Allah (SWT) reward you for your efforts and bless your contributions to this Islamic project.

(back to top)

Join our Telegram community group.

Join our community on Telegram to stay up-to-date with the latest updates of the app, ask questions, and share your feedback and ideas with other members. To join our Telegram group, follow these steps:

Telegram

We look forward to connecting with you on Telegram and hearing your thoughts about our app!

(back to top)

Technologies Used

The Islam project is built using the following technologies:

  • TypeScript
  • React
  • Ionic
  • Capacitor
  • Tailwind CSS
  • Vite
  • Playwright

(back to top)

Contact Author

Gmail Twitter LinkedIn

(back to top)

License

The Islam Application is licensed under the MIT License. See LICENSE.txt for more information.

(back to top)