Skip to content

Repository files navigation

📖 Quranic – A Modern & Premium Islamic Companion

Quranic Banner

Quranic is a feature-rich, high-performance open-source application designed for Muslims worldwide. It offers a beautiful and seamless experience for reading the Quran, tracking prayer times, and much more—all built with a modern tech stack focused on speed and simplicity.


✨ Features

  • 📖 Digital Mushaf: Highly readable, swipable Quran pages using modern rendering.
  • 🕋 Prayer Times (Solah): Accurate calculation for your location including Adhan notifications.
  • 🕌 Hijri Calendar: Seamlessly transitions between Gregorian and Hijri dates.
  • 🧭 Qiblah Finder: Precise direction finding using your device's compass.
  • 🤲 Daily Adhkaar: Curated morning, evening, and various other supplications.
  • 🎧 Audio Recitation: Stream and listen to beautiful Quran recitations.
  • 🔍 Advanced Search: Quickly find any Ayah or Surah.

🛠️ Tech Stack

Quranic is split into two main components: a feature-packed mobile application and a sleek web frontend.

  • Framework: Expo (React Native)
  • Language: TypeScript
  • Styling: Native components and custom design system
  • Icons: Lucide React Native
  • Libraries: Adhan (Prayer Times), Moment Hijri, Expo Audio, Reanimated.
  • Framework: Next.js 15+
  • Styling: Tailwind CSS 4
  • Animations: Framer Motion
  • Icons: Lucide React

🚀 Getting Started

To get the project running locally, follow these steps:

Prerequisites

  • Node.js (v18 or higher)
  • npm or pnpm

Clone the Repository

git clone https://github.com/musamusakannike/quranic.git
cd Quranic

Run the Mobile App

cd mobile
npm install
npx expo start

Run the Frontend

cd frontend
npm install
npm run dev

🤝 Contributing

We welcome contributions! If you're interested in improving Quranic, feel free to fork the repo and submit a PR.

  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.


Made with ❤️ for the Ummah.

About

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages