# Quran Cloud

[![Latest Version](https://badgen.net/npm/v/quran-cloud)](https://www.npmjs.com/package/quran-cloud)

A comprehensive collection of Quran text, transliteration, and translations in JSON format.

## CDN

Explore the [`/dist`](https://github.com/saikothasan/quran-cloud/tree/master/dist) directory to access all available JSON files. You can also retrieve these files via the [JSDELIVR](https://www.jsdelivr.com/package/npm/quran-cloud?path=dist) CDN.

### Complete Quran Text & Translations

This project utilizes the Uthmani Quran text from [The Noble Qur'an Encyclopedia](https://quranenc.com/en/home). English transliteration is sourced from [Tanzil.net](https://tanzil.net/trans/en.transliteration), with translations provided in multiple languages:

- **Quran text only**: [`cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran.json)  
- **English transliteration**: [`cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_transliteration.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_transliteration.json)  
- **Translations in different languages**:  
  - `bn` (Bengali): [`quran_bn.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_bn.json)  
  - `zh` (Chinese): [`quran_zh.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_zh.json)  
  - `en` (English): [`quran_en.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_en.json)  
  - `es` (Spanish): [`quran_es.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_es.json)  
  - `fr` (French): [`quran_fr.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_fr.json)  
  - `id` (Indonesian): [`quran_id.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_id.json)  
  - `ru` (Russian): [`quran_ru.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_ru.json)  
  - `sv` (Swedish): [`quran_sv.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_sv.json)  
  - `tr` (Turkish): [`quran_tr.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_tr.json)  
  - `ur` (Urdu): [`quran_ur.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/quran_ur.json)  

---

### Chapter List

- Arabic only: [`index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/index.json)  
- Translations by language:  
  - Bengali: [`bn/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/bn/index.json)  
  - Chinese: [`zh/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/zh/index.json)  
  - English: [`en/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/en/index.json)  
  - Spanish: [`es/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/es/index.json)  
  - French: [`fr/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/fr/index.json)  
  - Indonesian: [`id/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/id/index.json)  
  - Russian: [`ru/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/ru/index.json)  
  - Swedish: [`sv/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/sv/index.json)  
  - Turkish: [`tr/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/tr/index.json)  
  - Urdu: [`ur/index.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/ur/index.json)  

---

### Access Individual Chapters

- Quran text and transliteration:  
  ```
  https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/{chapterNumber}.json
  ```
- Quran text, transliteration, and translation:  
  ```
  https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/{langCode}/{chapterNumber}.json
  ```

Examples:  
- *Al-Fatihah* Quran text only: [`1.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/1.json)  
- *Al-Rahman* with English translation: [`en/55.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/en/55.json)  
- *Al-Ikhlas* with Indonesian translation: [`id/112.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/chapters/id/112.json)  

---

### Access Individual Verses

Retrieve single verses using their `verseNumber` (1-6236):  
```
https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/verses/{verseNumber}.json
```

Examples:  
- *Al-Fatihah* verse #1: [`1.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/verses/1.json)  
- *An-Nas* verse #6: [`6236.json`](https://cdn.jsdelivr.net/npm/quran-cloud@1.0.0/dist/verses/6236.json)  

---

## Generate JSON Files Locally

### 1. Clone the Repository
```bash
git clone git@github.com:saikothasan/quran-cloud.git
```

### 2. Install Dependencies
```bash
cd quran-cloud
npm install
```

### 3. Build JSON Files
```bash
npm run build
```

---

## Data Sources

- Uthmani Quran text: [The Noble Qur'an Encyclopedia](https://quranenc.com/en/home)  
- English transliteration: [Tanzil.net](https://tanzil.net/trans/en.transliteration)  
- Translations:  
  - Bengali: Muhiuddin Khan ([tanzil.net](https://tanzil.net/trans/bn.bengali))  
  - English: Umm Muhammad (Saheeh International, [tanzil.net](https://tanzil.net/trans/en.sahih))  
  - Spanish: Muhammad Isa García ([tanzil.net](https://tanzil.net/trans/es.garcia))  
  - French: Muhammad Hamidullah ([tanzil.net](https://tanzil.net/trans/fr.hamidullah))  
  - Indonesian: Indonesian Islamic Affairs Ministry ([quranenc.com](https://quranenc.com/en/browse/indonesian_affairs))  
  - Russian: Elmir Kuliev ([tanzil.net](https://tanzil.net/trans/ru.kuliev))  
  - Swedish: Knut Bernström ([tanzil.net](https://tanzil.net/trans/sv.bernstrom))  
  - Turkish: Turkish Directorate of Religious Affairs ([tanzil.net](https://tanzil.net/trans/tr.diyanet))  
  - Urdu: Abul A'la Maududi ([tanzil.net](https://tanzil.net/trans/ur.maududi))  
  - Chinese: Muhammad Makin ([quranenc.com](https://quranenc.com/en/browse/chinese_makin))  

---

## License

This project is licensed under [CC-BY-SA 4.0](https://github.com/saikothasan/quran-cloud/blob/master/LICENSE.txt).  
Developed by [saikothasan](https://saikothasan.github.io).  

--- 