Skip to content

A web application to listen to Quranic recitations, Built with React, Redux Toolkit, and TypeScript.

License

Notifications You must be signed in to change notification settings

itxSaaad/quran-player-app-react

Repository files navigation

Quran Player App - React

A Quran Player application built with React, Redux Toolkit, Tailwind CSS, TypeScript, and online API links using Redux Async Thunk. The app allows users to list and play Quranic recitations by various reciters.


Contributors Forks Stargazers Issues MIT License

Live Preview Project

Live Preview

Features

  • List All Reciters: View a list of all available reciters.
  • Top Reciters on Discover Page: Discover the top reciters.
  • List All Surahs for Each Reciter: View all surahs for a selected reciter.
  • Play Surah: Play the first surah by clicking on the reciter's image.
  • Surah Player: Play the desired surah from the list of surahs.
  • Music Player Controls: Next, Previous, Pause, Mute, Volume control, and Seekbar.
  • Responsive Design: User-friendly interfaces designed for various screen sizes

Built With

  • React.js - A JavaScript library for building user interfaces
  • Redux/Toolkit - The official, opinionated, batteries-included toolset for efficient Redux development
  • Tailwind CSS - A utility-first CSS framework for rapidly building custom designs
  • React Icons - Include popular icons in your React projects easily with react-icons
  • React Toastify - React-Toastify allows you to add notifications to your app with ease
  • React Spinner - A collection of loading spinner components for React
  • TypeScript - TypeScript is a superset of JavaScript that compiles to clean JavaScript output
  • Vite - Vite is a build tool that aims to provide a faster and leaner development experience for modern web projects
  • Axios - Promise based HTTP client for the browser and node.js

Getting Started

Prerequisites

  • Node.js - JavaScript runtime built on Chrome's V8 JavaScript engine
  • NPM - Node Package Manager

Installation

1.Clone the repo

git clone https://github.com/itxSaaad/quran-player-app-react.git

2.Install NPM packages

npm install

3.Start the development server

npm run dev

4.Build the project

npm run build

API Endpoints

  • Chapters/Surah Information: https://api.quran.com/api/v4/chapters
  • Reciters and their Audio Servers: https://mp3quran.net/api/_english.php
  • Arabic Verses: https://raw.githubusercontent.com/risan/quran-json/main/dist/quran.json

Contributing

Contributions are what make the open-source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the repo
  2. Clone the project
  3. Create your feature branch (git checkout -b feature/AmazingFeature)
  4. Commit your changes (git commit -m "Add some AmazingFeature")
  5. Push to the branch (git push origin feature/AmazingFeature)
  6. Open a pull request

Contact

License

Distributed under the MIT License. See LICENSE for more information.

Support

Give ⭐️ if you like this project!

About

A web application to listen to Quranic recitations, Built with React, Redux Toolkit, and TypeScript.

Resources

License

Stars

Watchers

Forks