# Kubiy PWA — Sakinisha kama App bila Play Store

PWA inaruhusu Kubiy "isakinishwe" kwenye simu (icon kwenye home screen, full-screen,
inafanya kazi offline kidogo) — kwa **code ile ile ya web**, bila Play Store.

## Faili (folda `pwa/`)

```
pwa/
├── manifest.json        jina, icon, rangi, jinsi ifunguke (standalone)
├── service-worker.js    offline cache + inaruhusu "Install"
├── offline.html         ukurasa wa "hakuna mtandao"
├── register-pwa.html    code ya kuweka kwenye index.php yako (maelezo ndani)
└── icons/               icon-192, icon-512, maskable, apple-touch
```

## Hatua 3 za ku-install PWA

1. **Nakili folda `pwa/`** kwenye mzizi (root) wa tovuti yako, ili ipatikane kama
   `https://tovuti-yako/pwa/manifest.json`.

2. **Weka code kwenye app yako.** Fungua `pwa/register-pwa.html` — ina vipande vitatu:
   - Weka `<link rel="manifest">` na meta tags kwenye `<head>` ya `index.php`.
   - Weka `<script>` (service worker + kitufe cha Sakinisha) kabla ya `</body>`.
   - Weka kitufe cha `#installKubiy` popote unapopataka kionekane.

3. **HTTPS.** PWA inahitaji HTTPS (tayari unayo). Kwenye localhost inafanya kazi pia.

## Jinsi mtumiaji anavyosakinisha

- **Android (Chrome):** atapata kiotomatiki "Add to Home screen," au bonyeza kitufe
  **"⬇ Sakinisha Kubiy."** Icon inaonekana kama app kamili.
- **iPhone (Safari):** Share → **"Add to Home Screen"** (iOS haitoi kitufe cha auto,
  lakini manifest + apple meta tags zinahakikisha inaonekana vizuri).

## Nini PWA inatoa

- Icon kwenye home screen, inafunguka **full-screen** (bila browser bar).
- **Offline shell** — app inafunguka hata mtandao ukiwa hafifu; data mpya inasubiri mtandao.
- **Shortcuts** (bonyeza-shikilia icon): Piga picha, Gumzo, Ripoti.
- Ni **haraka** na **haichukui nafasi nyingi** kuliko app ya store.

## PWA vs Native (Capacitor)

| Kipengele | PWA | Native (Capacitor) |
|---|---|---|
| Kusakinisha | Bila store, papo hapo | Play Store / APK |
| Kamera | Ndiyo (web) | Ndiyo (bora zaidi) |
| Auto-save gallery | Kikomo | Kamili (kama WhatsApp) |
| Push notifications | Ndiyo (Android) | Kamili |
| Kujenga | Rahisi zaidi | Zaidi kidogo |

**Ushauri:** anza na **PWA** (rahisi, bila store). Ukihitaji auto-save kamili ya
faili/gallery na notifications imara kama WhatsApp, funga PWA hiyo hiyo kwa **Capacitor**
kuwa app ya Android — code ile ile.

## Kupima kama PWA inafanya kazi

Chrome → DevTools → **Application** tab → **Manifest** (angalia hakuna makosa) na
**Service Workers** (angalia imesajiliwa). Au **Lighthouse** → "Installable."
