Skip to content

Latest commit

ย 

History

History
114 lines (90 loc) ยท 4.94 KB

File metadata and controls

114 lines (90 loc) ยท 4.94 KB

โ˜• Kafein Quran

Kafein Quran adalah aplikasi web Al-Quran modern dengan estetika premium yang dirancang untuk memberikan pengalaman membaca yang khusyuk dan intuitif. Aplikasi ini mendukung pemilihan versi Mushaf antara Standar Kemenag RI dan Uthmani (Madinah).


โœจ Fitur Utama

๐Ÿ•Œ Ibadah & Zakat

  • Kalkulator Zakat Komprehensif (Baru!):
    • Hitung berbagai jenis zakat: Zakat Maal, Fitrah, Penghasilan, Emas/Perak, Perdagangan, dan Pertanian.
    • Dilengkapi fitur Harga Pasar Terkini yang dapat dikonfigurasi secara manual untuk akurasi perhitungan.
    • Opsi komoditas lengkap untuk Zakat Fitrah dan Pertanian serta perhitungan nisab otomatis.
  • Jadwal Shalat Global:
    • Waktu sholat akurat mencakup seluruh dunia menggunakan koordinat GPS atau deteksi IP.
    • Pencarian kota internasional terintegrasi dengan data Nominatim (OpenStreetMap).
    • Hitung mundur ke waktu shalat berikutnya dengan penyesuaian zona waktu otomatis.
  • Dzikir & Tasbih Digital:
    • Penghitung dzikir interaktif dengan desain minimalis.

๐Ÿ“– Membaca Al-Quran

  • Opsi Versi Mushaf:
    • ๐Ÿ‡ฎ๐Ÿ‡ฉ Versi Kemenag RI: Menggunakan teks Al-Quran standar Indonesia (Kemenag).
    • ๐Ÿ‡ธ๐Ÿ‡ฆ Versi Uthmani (Madinah): Teks Al-Quran gaya Madinah (Rasm Utsmani).
  • Audio Murattal Interaktif:
    • Pilihan Qari ternama: Mishary Rashid al-Afasy, Ali Hudhaify, Mahmoud al-Husary.
    • Kontrol audio yang lancar dengan fitur Auto-play dan Repeat Mode.
  • Mode Menghafal (Memorization Mode):
    • Sembunyikan/tampilkan teks ayat secara instan untuk melatih hafalan.
    • Dilengkapi dengan floating toggle untuk akses cepat saat membaca.
  • Navigasi Juz & Ayat yang Cepat:
    • Pindah antar Juz atau lompat ke ayat tertentu secara instan tanpa memuat ulang halaman.
  • Pilihan Font Arab Premium:
    • LPMQ Isep Misbah (Kemenag), Amiri, Uthmanic Hafs, & Uthman Taha Naskh.

๐Ÿ” Fitur Cerdas & UX

  • Pencarian Canggih & Super Cepat (Ditingkatkan):
    • Algoritma pencarian lokal yang dioptimalkan dengan in-memory caching.
    • Mendukung pencarian multi-kata (intersection search) dan penghapusan diakritik Arab (diacritic removal).
    • Fitur highlighting pada kata kunci dan infinite scroll pada hasil pencarian.
  • Berbagi Ayat (Share Ayah):
    • Bagikan cuplikan ayat favorit dengan desain premium.
    • Kustomisasi Tampilan: Pilih untuk menampilkan atau menyembunyikan Terjemahan, Tafsir, dan Catatan pada gambar pratinjau.
  • Pengalaman Pengguna (UX) Premium:
    • Animasi Loading modern untuk transisi antar halaman yang halus.
    • Ukuran Font Adaptif dan Tema Dinamis (Dark/Light Mode).
    • Otomatis mengingat lokasi terakhir dibaca (Last Read).
    • Tafsir Kemenag RI terintegrasi dan Bookmark dengan Catatan.

๐Ÿ“ก Sumber Data

Aplikasi ini menggunakan sumber data terbuka yang tepercaya untuk memastikan akurasi:

  1. Al-Quran JSON Indonesia (Kemenag): Sumber utama untuk Teks Al-Quran versi Kemenag RI.
  2. Quran JSON (Risan): Sumber data untuk Teks Al-Quran versi Uthmani, Terjemahan Indonesia, dan Metadata Surah.
  3. Aladhan API: API utama untuk data jadwal shalat dan astronomi Islam di seluruh dunia.
  4. EveryAyah.com: Database audio murattal per ayat berkualitas tinggi.
  5. Nominatim OSM: Layanan pencarian lokasi (geocoding) dunia yang digunakan untuk fitur jadwal shalat.
  6. Quran.com API v4: Referensi untuk struktur data Juz dan Page.
  7. ianoit/data-hadist dari tafsirq.com: Sumber untuk data hadist.

๐Ÿ› ๏ธ Tech Stack

Kafein Quran dikembangkan menggunakan teknologi modern untuk performa maksimal:


๐Ÿš€ Panduan Pengembang

โš™๏ธ Prasyarat

  • Node.js: v18.0.0 atau lebih tinggi
  • npm atau yarn

๐Ÿ“ฆ Instalasi

  1. Clone Repositori:

    git clone https://github.com/muhiqsimui/kafein-quran.git
    cd kafein-quran
  2. Instal Dependensi:

    npm install
  3. Jalankan Lingkungan Pengembangan:

    npm run dev

    Buka http://localhost:3000 di browser Anda.

  4. Build untuk Produksi:

    npm run build
    npm run start

๐Ÿ“„ Lisensi

Proyek ini dilisensikan di bawah GNU Affero General Public License v3.0 (AGPL-3.0).


Dikembangkan dengan โค๏ธ untuk mempermudah umat Islam berinteraksi dengan Al-Quran secara digital.