Skip to content

ArslanYM/YourFavQuranReciter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Your Fav Quran Reciter πŸŒ™

License: MIT Next.js

A modern web application for listening to and reading the Holy Quran with multiple reciters. Built with Next.js and powered by the Quran API.

Features ✨

  • 🎧 Listen to Quran recitations from famous reciters
  • πŸ“– Read Quran text with multiple translations
  • πŸ” Search across surahs and verses
  • πŸŒ™ Dark/Light mode toggle
  • ⏯️ Audio playback controls with progress bar
  • πŸ“Œ Bookmark favorite verses
  • πŸ”„ Synchronized audio-text highlighting
  • 🌐 Multi-language support
  • πŸ“± Responsive design

Tech Stack πŸ’»

Getting Started πŸš€

Prerequisites

  • Node.js 18+
  • npm 9+ or yarn 1.22+
  • Quran API Key

Contributing 🀝

  • We welcome contributions! Please follow these steps :
  • Fork the project
  • Create your feature branch (git checkout -b feature/AmazingFeature)
  • Commit your changes (git commit -m 'Add some AmazingFeature')
  • Push to the branch (git push origin feature/AmazingFeature)
  • Open a Pull Request

Please read our Contribution Guidelines for details.

License πŸ“„ This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments πŸ™ Quran audio files provided by Al-Quran Cloud

Inspired by popular Quran apps

Built with ❀️ by the Muslim developer community

Support β˜• If you find this project useful, please consider:

⭐ Giving a star on GitHub

πŸ•Œ Making dua for the contributors

πŸ’» Contributing to the codebase

β˜• Buying us a coffee

Note: This project is intended for educational and spiritual purposes. Please ensure proper attribution of all Quranic texts and audio files according to Islamic guidelines.

API

  • // Reciter ID Name // 1 Mishary Rashid Al-Afasy // 2 Abu Bakr Al-Shatri // 3 Nasser Al Qatami

// Request format // Make a GET request to //_.mp3

// Example // Endpoint: /2/1_2.mp3 // Raw Url: https://quranaudio.pages.dev/2/1_2.mp3

About

Listen to Quran in your favt reciter's voice.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published