Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/srj101/quran-wise


https://github.com/srj101/quran-wise

Last synced: 11 days ago
JSON representation

Awesome Lists containing this project

README

        

# ๐Ÿ“– Quran-Wise

**Quran-Wise** is a beautifully designed application created to bring the timeless wisdom and teachings of the Quran to everyone. Whether you're a dedicated scholar, a curious reader, or someone seeking inspiration, Quran-Wise empowers you with tools to explore, understand, and connect with the Quran in meaningful ways.

---

## ๐ŸŒŸ Vision

The Quran serves as a beacon of guidance, wisdom, and inspiration for millions worldwide. **Quran-Wise** was crafted with a deep appreciation for this profound text, aiming to provide an accessible and intuitive platform for individuals of all backgrounds to engage with the Quranโ€™s teachings in a modern and enriching manner.

---

## ๐Ÿ“‹ Key Features

### ๐Ÿ•‹ **Explore the Quran**

- Full Quran text available in Arabic with multiple translations and transliterations.
- **Advanced Search**: Find verses by keywords, themes, or context effortlessly.

### ๐Ÿ“š **Learn & Reflect**

- **Tafsir (Exegesis)**: Access detailed interpretations to understand the verses in depth.
- **Audio Recitations**: Listen to recitations by renowned Qaris (reciters).
- **Bookmark & Notes**: Save and annotate your favorite verses for later reflection.

### ๐Ÿ” **User-Friendly Interface**

- Clean, intuitive UI designed for a seamless reading and learning experience.
- Dark mode for comfortable reading at night.

### ๐ŸŒ **Multilingual Support**

- Access translations in multiple languages to cater to a global audience.

### โœจ **Daily Inspirations**

- Receive a verse and its reflection every day to keep you inspired.

---

## ๐Ÿ› ๏ธ Technology Stack

### **Frontend**

- React.js with Next.js 15+ for a modern, responsive, and optimized user interface.

### **Backend**

- Node.js and Express.js for robust API handling.
- MongoDB for storing user data, bookmarks, and notes.

### **Additional Tools**

- **Tailwind CSS** for sleek, consistent styling.
- **Audio APIs** to deliver high-quality Quran recitations.
- **Internationalization (i18n)** for multilingual support.

---

## ๐Ÿšง Challenges Overcome

1. **Ensuring Accessibility**: Developed a design that caters to users with varying levels of technical proficiency.
2. **Efficient Search Algorithm**: Created a lightning-fast search feature for finding verses, even in large datasets.
3. **Audio Synchronization**: Integrated audio with accurate verse highlighting for an immersive experience.

---

## ๐Ÿ† Accomplishments

- Successfully launched a platform for Quranic study with advanced search and interpretation tools.
- Integrated multilingual support, making the app accessible to a diverse global audience.
- Delivered a visually stunning, user-centric application.

---

## ๐Ÿ”ฎ Future Plans

- **AI-Powered Insights**: Provide context and thematic suggestions based on user preferences.
- **Community Features**: Enable discussions and shared reflections on verses.
- **Offline Mode**: Access Quran and bookmarked verses without an internet connection.
- **Customizable Recitation Speed**: Allow users to adjust audio playback speed.

---

## ๐Ÿค Meet the Team

- **SR Joy**: Visionary, developer, and designer of Quran-Wise.
- **Contributors**: A heartfelt thanks to all poublic API's who supported and guided this project.

---

## ๐Ÿš€ Get Started

### **Clone the Repository**

```bash
git clone https://github.com/your-username/quran-wise
```

### **Navigate to the Project Directory**

```bash
cd quran-wise
```

### **Install Dependencies**

```bash
npm install
```

### **Run the Development Server**

```bash
npm run dev
```

### **Access the App Locally**

Visit `http://localhost:3000` in your browser.

---

## ๐ŸŽจ Live Demo

๐ŸŒ **[Try Quran-Wise Now](https://quran-wise.vercel.app)**

---

## โค๏ธ A Message from the Creator

Quran-Wise is more than just an appโ€”itโ€™s a bridge to understanding, reflection, and personal growth. I hope this platform serves as a helpful resource on your journey of exploring the Quran. Your feedback and support mean the world to me.

> _โ€œThis is the Book about which there is no doubt, a guidance for those conscious of Allah.โ€_ โ€” **Quran 2:2**