Skip to content

ArslanYM/YourFavQuranReciter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 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

Releases

No releases published

Packages

No packages published