Skip to content

kingmathers92/ballagh-app

Repository files navigation

Embark on a spiritual journey through the verses of the Holy Quran, right from your device!

🌟 Features (So Far!)

  • 🔍 Verse Voyager: Sail through the Quran with our powerful search function
  • 🎲 Random Revelation: Discover unexpected wisdom with a random verse generator
  • 🌓 Night Owl Mode: Easy on the eyes with our sleek dark mode
  • 📱 Responsive Revelation: Beautiful on all devices, from phones to desktops

🚀 Coming Soon to a Device Near You

  • 📶 Offline Oasis: Access verses even when you're off the grid
  • 🔖 Ayah Bookmarker: Never lose your place in your spiritual journey
  • 🔊 Murattal: Listen to beautiful recitations of verses
  • 🌍 Polyglot Quran: Explore translations in multiple languages
  • 🧭 Qibla Compass: Always know which way to face for prayer
  • 🗓️ Ramadan Companion: Your trusty sidekick for the holy month
  • 👤 Ummah Accounts: Sync your experience across all your devices

🛠️ Built With

  • ⚛️ React
  • ⚡ Vite
  • 🧭 React Router
  • 🔗 Axios

🏁 Quick Start

  1. Clone the repo:
  1. Enter the sacred directory:
  • cd ballagh-app
  1. Summon the dependencies:
  • npm install
  1. Ignite the development server:
  • npm run dev
  1. Open your browser and navigate to http://localhost:5173

🤝 Contribute

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

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📜 License

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

🙏 Acknowledgements

  • AlQuran.cloud for their heavenly API
  • The open-source community for their divine inspiration
  • You, for checking out our project!

📬 Contact

Khaled Ben Yahya - @Twitter - khaledb.yahya@gmail.com

Project Link: Ballagh - بلَّغ


Made with ❤️ and ☕

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published