Muslim Pocket 🕌📖

Muslim Pocket is a modern web-based Qur'an reader built with Next.js 15. It provides easy access to the Qur'an online with a clean UI and simple navigation.

---

⚡ Performance

• Delivered a fast and responsive experience by maintaining performance and SEO scores consistently above 90 🟩, ensuring quick load times, smooth interactions across devices, and high search engine visibility.

PageSpeed Insights: Desktop

PageSpeed Insights: Mobile

---

⚙️ Requirements

• Node.js version v22.15.0 (Make sure your Node version matches for compatibility with Next.js 15)
• npm or yarn as your package manager

---

🚀 Getting Started

Follow the steps below to set up and run the project locally:

1. Clone the repository

git clone https://github.com/balbaal/muslim-pocket.git
cd muslim-pocket

2. Install dependencies

# Using npm
npm install

# Or using yarn
yarn install

3. Run the development server

# Using npm
npm run dev

# Or using yarn
yarn dev

Then open http://localhost:3000 in your browser.

---

📦 Data Source

This project uses open-source Qur'an data from:

• 📚 GitHub Repository: rioastamal/quran-json
• 🧑‍💼 Created by: Rio Astamal

And also use API to fetch daily prayer schedules based on location:

• 🕋 API Provider: Aladhan.com

We appreciate the work and contributions from the open-source community!

---

📁 Project Structure

This is a Next.js 15 project using the App Router.

• app/ — App Router pages and layout
• components/ — Reusable UI components
• lib/ — Utilities and helper functions
• public/ — Static assets (images, icons, etc.)

---

🙏 Contributions

Feel free to fork this repo and submit pull requests. Suggestions, improvements, and contributions are welcome!

---

📜 License

This project is open-source under the MIT License.