Sumber daya
Pengembang
Sumber daya bagi pengembang yang membangun dengan data Al-Qur’an.
Korpus Al-Qur’an kami
Teks Al-Qur’an, data kata per kata, terjemahan, tafsir, catatan kaki, pencarian, dan metadata audio disajikan dari basis data kami sendiri melalui qurangallery.com/quran/api/quran. Tidak ada bagian halaman baca yang bergantung pada tersedianya API pihak ketiga.
Korpus ini mencakup Al-Qur’an lengkap dalam enam varian tulisan, 150 terjemahan, 23 tafsir, serta posisi halaman dan baris per mushaf untuk setiap kata — ditambah metadata surah, ayat, juz, dan pembagian lainnya. Respons mengikuti bentuk respons v4 yang sudah diharapkan sebagian besar perangkat Al-Qur’an, sehingga klien yang ada dapat membacanya tanpa perubahan. Audio tilawah sendiri masih dialirkan dari QuranCDN.
Referensi API
Setiap endpoint di bawah ini disajikan dari korpus kami sendiri dan menerima parameter kueri v4 yang biasa (language, translations, words, page).
Endpoint utama meliputi:
/chapters— Daftar ke-114 surah beserta metadatanya/verses/by_chapter/:id— Ambil ayat-ayat untuk surah tertentu/search— Pencarian teks lengkap di seluruh terjemahan/resources/recitations— Qari dan berkas audio yang tersedia/resources/translations— Terjemahan yang tersedia dalam semua bahasa
Teknologi
Quran Gallery dibangun dengan teknologi web modern yang berfokus pada kinerja dan aksesibilitas:
- Frontend
- SvelteKit 2 dengan Svelte 5, Tailwind CSS v4
- Runtime
- Node.js di VPS yang dikelola sendiri (adapter-node)
- Basis data
- PostgreSQL melalui Drizzle ORM
- Internasionalisasi
- Paraglide JS — 7 bahasa termasuk RTL
Sumber Terbuka
Kami meyakini kolaborasi terbuka untuk proyek-proyek yang melayani umat Muslim. Kontribusi sangat kami sambut — baik memperbaiki galat, menyempurnakan terjemahan, menambah fitur, maupun meningkatkan aksesibilitas.
Arsitektur
Quran Gallery berjalan sebagai monorepo layanan Node.js, masing-masing melayani bagian platform yang berbeda. Caddy merutekan permintaan berdasarkan awalan jalur ke layanan yang sesuai di VPS.
qurangallery.com (Gateway) /quran → Pembaca Al-Qur’an dan alat belajar /chat → Obrolan Al-Qur’an berbasis AI /studio → Studio seni Islami /hifz → Pelacak hafalan /adhkar → Doa harian /blog → Artikel dan panduanKontak
Untuk pertanyaan teknis, masalah API, atau tawaran kolaborasi, hubungi [email protected] atau buka issue di GitHub.

