https://github.com/cakgup/ppsa
Aplikasi doa & wirid digital untuk keluarga besar Pondok Pesantren Sunan Ampel Jombang, bisa dibuka dari HP, mendukung mode offline, dan dilengkapi jadwal shalat harian.
https://github.com/cakgup/ppsa
doa dzikir dzikir-app jombang pesantren ppsa
Last synced: about 1 month ago
JSON representation
Aplikasi doa & wirid digital untuk keluarga besar Pondok Pesantren Sunan Ampel Jombang, bisa dibuka dari HP, mendukung mode offline, dan dilengkapi jadwal shalat harian.
- Host: GitHub
- URL: https://github.com/cakgup/ppsa
- Owner: cakgup
- License: gpl-3.0
- Created: 2026-05-30T13:23:31.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-12T06:13:46.000Z (about 1 month ago)
- Last Synced: 2026-06-12T07:20:43.000Z (about 1 month ago)
- Topics: doa, dzikir, dzikir-app, jombang, pesantren, ppsa
- Language: JavaScript
- Homepage: https://ppsajombang.vercel.app
- Size: 3.11 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ο»Ώ# π PPSA β Majmu'ah ad-Du'a Sunan Ampel
Aplikasi doa & wirid digital untuk keluarga besar Pondok Pesantren Sunan Ampel
Jombang, bisa dibuka dari HP, mendukung mode offline, dan dilengkapi jadwal shalat harian.
---
## β¦ Bismillahirrahmanirrahim
Repository ini adalah ikhtiar digital untuk memudahkan keluarga, santri, dan jamaah dalam menjaga rutinitas doa, wirid, serta kedisiplinan ibadah harian.
Semoga aplikasi ini menjadi wasilah kebaikan: mudah dibuka, mudah diamalkan, dan mudah diwariskan.
> _βKhairunnas anfa'uhum linnas.β_
> Sebaik-baik manusia adalah yang paling bermanfaat bagi manusia lainnya.
---
## π Tentang Aplikasi
**PPSA β Majmu'ah ad-Du'a Sunan Ampel** adalah aplikasi web statis berbasis PWA yang berisi kumpulan doa dan wirid dengan pengalaman baca yang ramah mobile.
Aplikasi ini cocok untuk:
- penggunaan pribadi harian setelah shalat;
- pendamping amalan di rumah, pesantren, atau majelis;
- akses cepat doa dalam kondisi sinyal minim;
- dokumentasi digital naskah doa agar lebih mudah dirawat.
---
## β¨ Fitur Utama
| Fitur | Keterangan |
|---|---|
| π Jadwal Shalat Harian | Menampilkan waktu shalat berdasarkan wilayah pilihan pengguna |
| π Pilih Lokasi Manual + GPS | Pilih provinsi/kota atau bantu deteksi lokasi via GPS |
| π Mode Baca Fleksibel | Tersedia mode Arab saja atau Arab + Arti |
| π Pengaturan Font Arab | Ukuran font Arab bisa diatur agar nyaman dibaca |
| πΏ Tasbih Digital | Counter tasbih dengan target dan feedback getar (device support) |
| πΆ Offline-First | Konten doa utama tetap dapat dibaca saat offline |
| π¦ Cache Cerdas | Jadwal shalat bulan berjalan disimpan di localStorage |
| π± Siap Dipasang | Mendukung install ke homescreen (PWA) |
---
## ποΈ Struktur Repository
```text
ppsa/
βββ index.html
βββ css/
β βββ styles.css
βββ js/
β βββ app.js
βββ data/
β βββ doa.json
βββ assets/
β βββ logo.png
β βββ icon-192.png
βββ manifest.webmanifest
βββ sw.js
βββ LICENSE
βββ README.md
```
Keterangan singkat:
| File/Folder | Fungsi |
|---|---|
| `index.html` | Entry point aplikasi |
| `css/styles.css` | Styling utama aplikasi |
| `js/app.js` | Logika view, jadwal shalat, tasbih, dan pengaturan |
| `data/doa.json` | Sumber data doa/wirid |
| `assets/` | Logo dan ikon aplikasi |
| `manifest.webmanifest` | Konfigurasi PWA |
| `sw.js` | Service worker untuk mode offline |
---
## π Menjalankan Secara Lokal
Jangan buka `index.html` langsung via `file://` karena `fetch` ke file data bisa dibatasi browser.
### Opsi 1 β Python
```bash
python -m http.server 8000
```
Lalu buka:
```text
http://localhost:8000
```
### Opsi 2 β Node.js
```bash
npx -y serve .
```
Lalu buka:
```text
http://localhost:3000
```
---
## π Deploy
Aplikasi dapat dipublikasikan ke:
- GitHub Pages
- Vercel
- Cloudflare Pages
Untuk GitHub Pages:
1. Push semua file ke branch `main`.
2. Buka `Settings` repository.
3. Masuk ke menu `Pages`.
4. Pilih source `Deploy from a branch`.
5. Pilih branch `main` dan folder `/root`.
6. Simpan, lalu tunggu URL aktif.
Contoh URL:
```text
https://cakgup.github.io/ppsa/
```
---
## π οΈ Kustomisasi Konten
### 1. Memperbarui data doa
Edit file berikut:
```text
data/doa.json
```
Disarankan tetap menjaga format field agar kompatibel dengan renderer di `js/app.js`.
### 2. Menyesuaikan branding
- Ubah logo di `assets/logo.png`
- Ubah ikon aplikasi di `assets/icon-192.png`
- Sesuaikan judul/meta di `index.html`
### 3. Menyesuaikan tema warna
Ubah variabel/aturan warna di:
```text
css/styles.css
```
---
## π§ͺ Checklist Sebelum Publish
- [ ] Data `data/doa.json` valid (tidak ada JSON error)
- [ ] Navigasi Beranda, Baca, Tasbih, Info berjalan normal
- [ ] Jadwal shalat muncul untuk lokasi default dan lokasi manual
- [ ] Service worker aktif dan konten inti bisa dibuka offline
- [ ] Tampilan mobile tetap rapi di layar kecil
- [ ] Tidak ada error penting di browser console
---
## 𧩠Troubleshooting
### Jadwal shalat tidak muncul
- cek koneksi internet;
- pastikan endpoint API bisa diakses;
- hapus cache browser/localStorage lalu reload.
### Data doa tidak tampil
- validasi format JSON di `data/doa.json`;
- cek path file tidak berubah;
- refresh keras browser (`Ctrl + F5`).
### Tombol install tidak muncul
- pastikan dibuka via `http://` atau `https://` (bukan `file://`);
- pastikan browser mendukung install PWA;
- interaksi user kadang dibutuhkan sebelum prompt install muncul.
---
## π Catatan Penggunaan
- Gunakan aplikasi ini untuk memudahkan ibadah, bukan menggantikan adab belajar dari guru.
- Jika memodifikasi konten doa, lakukan tabayyun sumber terlebih dahulu.
- Hindari memasukkan data pribadi sensitif ke dalam repository publik.
---
## π οΈ Teknologi
| Teknologi | Fungsi |
|---|---|
| HTML | Struktur halaman |
| CSS | Tampilan visual |
| JavaScript | Interaksi aplikasi |
| Service Worker | Dukungan offline |
| Web App Manifest | Instalasi PWA |
---
## π Lisensi
Repository ini menggunakan lisensi **GNU General Public License v3.0 (GPL-3.0)**.
Lihat detail pada file [LICENSE](LICENSE).
---
Dibuat dengan niat ibadah, dirawat dengan amanah, dan dibagikan untuk kemaslahatan.