{"id":50809979,"url":"https://github.com/cakgup/ppsa","last_synced_at":"2026-06-13T04:01:08.552Z","repository":{"id":361421445,"uuid":"1254363451","full_name":"cakgup/ppsa","owner":"cakgup","description":"Aplikasi doa \u0026 wirid digital untuk keluarga besar Pondok Pesantren Sunan Ampel Jombang, bisa dibuka dari HP, mendukung mode offline, dan dilengkapi jadwal shalat harian.","archived":false,"fork":false,"pushed_at":"2026-06-12T06:13:46.000Z","size":3261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T07:20:43.000Z","etag":null,"topics":["doa","dzikir","dzikir-app","jombang","pesantren","ppsa"],"latest_commit_sha":null,"homepage":"https://ppsajombang.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cakgup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-30T13:23:31.000Z","updated_at":"2026-06-12T06:13:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cakgup/ppsa","commit_stats":null,"previous_names":["cakgup/ppsa"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cakgup/ppsa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cakgup%2Fppsa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cakgup%2Fppsa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cakgup%2Fppsa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cakgup%2Fppsa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cakgup","download_url":"https://codeload.github.com/cakgup/ppsa/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cakgup%2Fppsa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34271500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["doa","dzikir","dzikir-app","jombang","pesantren","ppsa"],"created_at":"2026-06-13T04:00:43.403Z","updated_at":"2026-06-13T04:01:08.540Z","avatar_url":"https://github.com/cakgup.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📖 PPSA — Majmu'ah ad-Du'a Sunan Ampel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.png\" alt=\"Logo PPSA\" width=\"140\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eAplikasi doa \u0026 wirid digital untuk keluarga besar Pondok Pesantren Sunan Ampel\u003c/strong\u003e\u003cbr\u003e\n  Jombang, bisa dibuka dari HP, mendukung mode offline, dan dilengkapi jadwal shalat harian.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://cakgup.github.io/ppsa/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/GitHub%20Pages-Live-brightgreen?logo=github\" alt=\"GitHub Pages\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-GPL--3.0-blue.svg\" alt=\"License GPL-3.0\"\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/PWA-Offline--First-2E7D32\" alt=\"PWA Offline First\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Mobile-Responsive-1E88E5\" alt=\"Mobile Responsive\"\u003e\n\u003c/p\u003e\n\n---\n\n## ✦ Bismillahirrahmanirrahim\n\nRepository ini adalah ikhtiar digital untuk memudahkan keluarga, santri, dan jamaah dalam menjaga rutinitas doa, wirid, serta kedisiplinan ibadah harian.  \nSemoga aplikasi ini menjadi wasilah kebaikan: mudah dibuka, mudah diamalkan, dan mudah diwariskan.\n\n\u003e _“Khairunnas anfa'uhum linnas.”_  \n\u003e Sebaik-baik manusia adalah yang paling bermanfaat bagi manusia lainnya.\n\n---\n\n## 📌 Tentang Aplikasi\n\n**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.\n\nAplikasi ini cocok untuk:\n\n- penggunaan pribadi harian setelah shalat;\n- pendamping amalan di rumah, pesantren, atau majelis;\n- akses cepat doa dalam kondisi sinyal minim;\n- dokumentasi digital naskah doa agar lebih mudah dirawat.\n\n---\n\n## ✨ Fitur Utama\n\n| Fitur | Keterangan |\n|---|---|\n| 🕌 Jadwal Shalat Harian | Menampilkan waktu shalat berdasarkan wilayah pilihan pengguna |\n| 📍 Pilih Lokasi Manual + GPS | Pilih provinsi/kota atau bantu deteksi lokasi via GPS |\n| 📚 Mode Baca Fleksibel | Tersedia mode Arab saja atau Arab + Arti |\n| 🔠 Pengaturan Font Arab | Ukuran font Arab bisa diatur agar nyaman dibaca |\n| 📿 Tasbih Digital | Counter tasbih dengan target dan feedback getar (device support) |\n| 📶 Offline-First | Konten doa utama tetap dapat dibaca saat offline |\n| 📦 Cache Cerdas | Jadwal shalat bulan berjalan disimpan di localStorage |\n| 📱 Siap Dipasang | Mendukung install ke homescreen (PWA) |\n\n---\n\n## 🗂️ Struktur Repository\n\n```text\nppsa/\n├── index.html\n├── css/\n│   └── styles.css\n├── js/\n│   └── app.js\n├── data/\n│   └── doa.json\n├── assets/\n│   ├── logo.png\n│   └── icon-192.png\n├── manifest.webmanifest\n├── sw.js\n├── LICENSE\n└── README.md\n```\n\nKeterangan singkat:\n\n| File/Folder | Fungsi |\n|---|---|\n| `index.html` | Entry point aplikasi |\n| `css/styles.css` | Styling utama aplikasi |\n| `js/app.js` | Logika view, jadwal shalat, tasbih, dan pengaturan |\n| `data/doa.json` | Sumber data doa/wirid |\n| `assets/` | Logo dan ikon aplikasi |\n| `manifest.webmanifest` | Konfigurasi PWA |\n| `sw.js` | Service worker untuk mode offline |\n\n---\n\n## 🚀 Menjalankan Secara Lokal\n\nJangan buka `index.html` langsung via `file://` karena `fetch` ke file data bisa dibatasi browser.\n\n### Opsi 1 — Python\n\n```bash\npython -m http.server 8000\n```\n\nLalu buka:\n\n```text\nhttp://localhost:8000\n```\n\n### Opsi 2 — Node.js\n\n```bash\nnpx -y serve .\n```\n\nLalu buka:\n\n```text\nhttp://localhost:3000\n```\n\n---\n\n## 🌐 Deploy\n\nAplikasi dapat dipublikasikan ke:\n\n- GitHub Pages\n- Vercel\n- Cloudflare Pages\n\nUntuk GitHub Pages:\n\n1. Push semua file ke branch `main`.\n2. Buka `Settings` repository.\n3. Masuk ke menu `Pages`.\n4. Pilih source `Deploy from a branch`.\n5. Pilih branch `main` dan folder `/root`.\n6. Simpan, lalu tunggu URL aktif.\n\nContoh URL:\n\n```text\nhttps://cakgup.github.io/ppsa/\n```\n\n---\n\n## 🛠️ Kustomisasi Konten\n\n### 1. Memperbarui data doa\n\nEdit file berikut:\n\n```text\ndata/doa.json\n```\n\nDisarankan tetap menjaga format field agar kompatibel dengan renderer di `js/app.js`.\n\n### 2. Menyesuaikan branding\n\n- Ubah logo di `assets/logo.png`\n- Ubah ikon aplikasi di `assets/icon-192.png`\n- Sesuaikan judul/meta di `index.html`\n\n### 3. Menyesuaikan tema warna\n\nUbah variabel/aturan warna di:\n\n```text\ncss/styles.css\n```\n\n---\n\n## 🧪 Checklist Sebelum Publish\n\n- [ ] Data `data/doa.json` valid (tidak ada JSON error)\n- [ ] Navigasi Beranda, Baca, Tasbih, Info berjalan normal\n- [ ] Jadwal shalat muncul untuk lokasi default dan lokasi manual\n- [ ] Service worker aktif dan konten inti bisa dibuka offline\n- [ ] Tampilan mobile tetap rapi di layar kecil\n- [ ] Tidak ada error penting di browser console\n\n---\n\n## 🧩 Troubleshooting\n\n### Jadwal shalat tidak muncul\n\n- cek koneksi internet;\n- pastikan endpoint API bisa diakses;\n- hapus cache browser/localStorage lalu reload.\n\n### Data doa tidak tampil\n\n- validasi format JSON di `data/doa.json`;\n- cek path file tidak berubah;\n- refresh keras browser (`Ctrl + F5`).\n\n### Tombol install tidak muncul\n\n- pastikan dibuka via `http://` atau `https://` (bukan `file://`);\n- pastikan browser mendukung install PWA;\n- interaksi user kadang dibutuhkan sebelum prompt install muncul.\n\n---\n\n## 🔐 Catatan Penggunaan\n\n- Gunakan aplikasi ini untuk memudahkan ibadah, bukan menggantikan adab belajar dari guru.\n- Jika memodifikasi konten doa, lakukan tabayyun sumber terlebih dahulu.\n- Hindari memasukkan data pribadi sensitif ke dalam repository publik.\n\n---\n\n## 🛠️ Teknologi\n\n| Teknologi | Fungsi |\n|---|---|\n| HTML | Struktur halaman |\n| CSS | Tampilan visual |\n| JavaScript | Interaksi aplikasi |\n| Service Worker | Dukungan offline |\n| Web App Manifest | Instalasi PWA |\n\n---\n\n## 📜 Lisensi\n\nRepository ini menggunakan lisensi **GNU General Public License v3.0 (GPL-3.0)**.  \nLihat detail pada file [LICENSE](LICENSE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eDibuat dengan niat ibadah, dirawat dengan amanah, dan dibagikan untuk kemaslahatan.\u003c/strong\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcakgup%2Fppsa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcakgup%2Fppsa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcakgup%2Fppsa/lists"}