# 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). ---