NunQ

Hai Selamat datang!
Proyek NunQ adalah proyek web yang dibangun untuk mengimplementasikan library quran-pack yaitu sebuah library quran serta menyediakan tools lain yang menunjang kegiatan sehari-hari sebagai seorang muslim/muslimah.

URL : quran.syaikhu.com
API Docs : quran.syaikhu.com/docs

Deskripsi

Proyek aplikasi web ini menyediakan akses mudah dan nyaman ke Al-Qur'an serta berbagai alat Islami lainnya untuk mendukung kegiatan ibadah dan pengetahuan agama Islam. Fitur-fitur dalam aplikasi ini dirancang untuk membantu umat Muslim dalam membaca, memahami, dan mengamalkan ajaran Islam dalam kehidupan sehari-hari.

Tangkapan Layar

Berikut adalah beberpa tangkapan layar dari aplikasi ini:

Light Mode

Dark Mode

Fitur

• Mushaf Al-Qur'an : Baca Al-Qur'an dengan teks Arab dan latin disertai terjemah. ( ✔️ OK )
• Pencarian Surah : Cari surah Al-Qur'an berdasarkan nama surah atau kata kunci tertentu. ( ✔️ OK )
• Surah Terkini/Favorit : Mengelompokan hasil pencarian surah berdasarkan pencarian terkini atau favorit. ( ✔️ OK )
• Pencarian Ayat : Cari ayat Al-Qur'an berdasarkan nomor ayat. ( ✔️ OK )
• Tafsir Al-Qur'an : Penjelasan ayat-ayat Al-Qur'an dari berbagai sumber tafsir terpercaya. ( 🚧 Comming Soon )
• Doa Harian : Kumpulan doa sehari-hari yang bisa dibaca dan dihafal. ( 📅 Planned )
• Yasin & Tahlil : Bacaan Yasin dan Tahlil. ( 📅 Planned )
• Maulid : Bacaan sholawat dari kitab maulid pilihan. ( 📅 Planned )
• Lain-lain : Fitur lainya. ( 📅 Planned )

Persyaratan Sistem

Pastikan memiliki perangkat lunak berikut (jika ingin memulai secara lokal):

• Node.js versi 18.0.0 atau lebih baru.
• npm atau yarn.
• Browser yang didukung (Chrome, Firefox, dll.).

Instalasi

Langkah-langkah untuk menginstal dan menjalankan proyek ini secara lokal:

1. Clone repositori ini:

   git clone https://github.com/Sekhudin/NunQ.git

2. Masuk ke direktori proyek:

   cd NunQ

3. Instal dependensi:

   npm install

4. build aplikasi:

   npm run build

5. jalankan aplikasi:

   npm run start

Konfigurasi Lingkungan

Proyek ini menggunakan file .env untuk menyimpan konfigurasi lingkungan. Anda perlu membuat file .env di direktori root proyek ini dan menambahkan variabel-variabel berikut:

# contoh: "GET, PUT, POST, DELETE"
ALLOWED_METHODS=

# contoh: "http://localhost:3000/"
ALLOWED_ORIGIN=

# contoh: "Content-Type, Authorization"
ALLOWED_HEADERS=

# contoh: ""
EXPOSED_HEADERS=

# integer
MAX_AGE="86400"

# true atau false
CREDENTIALS=


NEXT_PUBLIC_APP_NAME=NunQ
NEXT_PUBLIC_AUTHOR_EMAIL="[email protected]"
NEXT_PUBLIC_AUTHOR_WEB_PROFILE="https://syaikhu.com"

Kontak

Untuk pertanyaan atau dukungan, silakan hubungi:

• Email : [email protected]
• Web : syaikhu.com

Temukan saya di:

• Linkedin : sekhudin
  
• Instagram : @sekhudin_y
  
• Twitter : @sekhudin_y
  
• Trakteer : syaikhu