A modern, elegant web application for listening to and studying the Quran. Built with NextJS, this app provides a seamless experience for accessing Quranic recitations, translations, and study tools. Whether you're a student of the Quran, a regular listener, or someone looking to connect with the divine words, Quran Player offers a beautiful and intuitive interface for your spiritual journey.
- 🎧 High-Quality Audio - Crystal clear recitations from renowned reciters
- 📚 Comprehensive Content - Access to multiple translations
- 🔍 Smart Search - Find specific verses or topics instantly
- 📱 Cross-Platform - Seamless experience across all devices
- Beautiful Design - Modern, clean interface that enhances your listening experience
- Easy Navigation - Intuitive controls and organized content structure
- Rich Features - Everything you need for Quran study in one place
- Privacy Focused - Your data stays secure and private
- Clone the repository
- Set up your environment variables
- Run database migrations
- Start development server
quran-player/
├── app/ # Next.js app directory
│ ├── api/ # API routes
│ ├── (auth)/ # Authentication routes
│ └── (player)/ # Player and Quran content routes
├── components/ # Reusable components
│ ├── player/ # Audio player components
│ ├── surah/ # Surah display components
│ └── ui/ # UI components
├── lib/ # Utility functions
├── prisma/ # Database schema
└── public/ # Static assets
- Play/pause controls
- Progress bar
- Volume control
- Playback speed adjustment
- Surah list with metadata
- Verse-by-verse display
- Multiple translations
- Reciter selection
- Deploy to Vercel
- Configure environment variables
- Run database migrations:
pnpm prisma db push
- Enable Row Level Security (RLS) in Supabase
- Keep service keys secure
- Use server-side Supabase calls
- Implement proper authentication checks
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.