# HomeSyncHub v8.0 — Cross-Device + iOS App Optimization

This package has been upgraded as a responsive Progressive Web App so it runs across desktop, tablet, Android, iPhone, and iPad while keeping the existing PHP + JSON-storage architecture.

## What was added

- iOS-safe viewport handling with `viewport-fit=cover`, safe-area padding, and dynamic `100dvh` fallback support.
- iPhone/iPad Add to Home Screen install guidance, because iOS Safari does not expose the same `beforeinstallprompt` event used by Chrome/Android.
- Larger touch targets, tap-highlight tuning, reduced iOS input zoom by enforcing 16px+ form control text, and smoother keyboard scrolling.
- Better standalone PWA behavior for iOS home-screen launch, including safe top/bottom spacing and status-bar support.
- Manifest improvements: app id, language/direction, display override, launch handler, narrow screenshot, and icon-purpose metadata.
- Service worker upgraded to cache version `homesynchub-v8.0.0`, with navigation fallback to `offline.html` and cache-first static asset behavior.
- CSS compatibility layer for phones, tablets, desktop, pointer/touch devices, reduced-motion users, and iOS Safari rendering quirks.

## iPhone/iPad installation

1. Host the project over HTTPS.
2. Open the HomeSyncHub URL in Safari on iPhone or iPad.
3. Tap Share.
4. Tap Add to Home Screen.
5. Launch HomeSyncHub from the home-screen icon.

## Important iOS limitation

This project is server-side PHP. A true App Store IPA cannot simply package these PHP files locally because iOS apps cannot run an Apache/PHP server by default. For a native iOS shell, host this PWA on HTTPS first, then wrap the hosted URL using Capacitor or a WKWebView-based iOS app.

Recommended native-wrapper direction:

```text
Hosted PWA URL -> Capacitor iOS shell -> Xcode signing -> TestFlight/App Store
```

## Files changed

- `index.php`
- `manifest.json`
- `service-worker.js`
- `assets/css/app.css`
- `assets/js/app.js`

## Production checklist

- Replace default local admin credentials before public use.
- Serve over HTTPS for PWA install, service worker, and secure cookies.
- Back up `data/store.json` before deployment.
- Keep `data/.htaccess` enabled to block direct data access.
- Test on iPhone Safari, iPad Safari, Android Chrome, desktop Chrome/Edge/Safari, and desktop browser resized to 390px, 768px, 1024px, and 1440px widths.
