Skip to content

the-moezzat/qradio

Repository files navigation

QRadio(react-version) | Holy Quran all the time

Qradio is a simple web application that allows users to listen to the Quran anytime and anywhere with any device from all around the world, removing the hesitation of starting to choose the sura and reciter. Build with Beautiful UI/UX and good performance and the best practices for easy maintenance, add features, and be futureproof

Features

  • Beautifully designed UI created using Figma
  • Stream Quran audio in multiple languages
  • The app work seamless on any device and screen size
  • Easily navigate between stations
  • Pause, play, and adjust the volume of the audio player
  • Add your best station to favorite list.
  • Search between more than 130 live station.
  • Share stations with your friends (incoming)
  • Install the app in your phone using Progressive Web Application (PWA) (incoming)
  • Listen to specific sura with specific reciters (incoming)
  • Support for multiple languages.
  • And more ...

Installation

To install and run qradio-react-version on your local machine, follow these steps:

  1. Clone this repository using Git:
   git clone https://github.com/the-moezzat/qradio-react-version.git
  1. Install the necessary dependencies using NPM:
npm install

Usage

To start the app, run the following command:

npm run dev

Once the app is running, you can navigate to http://localhost:5173 in your web browser to access the app.

Limitations

  • The app requires an internet connection to stream Quran audio.
  • The app is currently only available in the English language.

Project Structure

The project is organized using function as follows:

  • src/: The source code for the application.
  • src/store/index.js: Entry point for the Redux store and all RTK query API and redux Slices.
  • src/store/slices: Redux slices.
  • src/store/apis/: RTK query APIs.
  • index.js: The entry point for the application.
  • public/: Public assets for the application.
  • package.json: NPM package metadata.

Credits

This project was created by Mohamed Ezzat. It makes use of the following open-source packages and resources:

Contributing

If you would like to contribute to the project, please follow the guidelines outlined in CONTRIBUTING.md.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Contact

If you have any questions or feedback about the app, please contact me at dev.moezzat@gmail.com.

About

Qradio: an app that show Quran stations from mp3.Quran API using RTK query and Redux-toolkit to manage app state and use tailwindcss to style the app

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors