Initial skills documentation — 25 categories, all SKILL.md + references + scripts

2026-07-15 17:42:20 -04:00
commit 1b4fcd4427
976 changed files with 188344 additions and 0 deletions
@@ -0,0 +1,42 @@
+# iOS PWA Push Notification Testing
+
+## The Problem
+Web Push API does NOT work in Safari's browser tab on iOS. The `PushManager` object is unavailable in the browser context. Attempting to subscribe in Safari produces:
+
+```
+FAIL: No PushManager
+```
+
+This is NOT a bug in the code. It is an Apple-imposed limitation: `PushManager` is only exposed when the page runs inside an installed Home Screen PWA.
+
+**The error message is misleading** — it looks like the browser doesn't support push at all. But iOS PWA mode has full push support via Apple Push Service (APNs).
+
+## The Fix
+
+### Step 1: Install the PWA
+1. Open shark.iamgmb.com in Safari
+2. Tap Share icon (square with arrow at bottom of Safari)
+3. Scroll down → "Add to Home Screen"
+4. Name it "Shark Game" → Add
+5. Open from Home Screen (launches fullscreen, no URL bar)
+
+### Step 2: Enable Notifications
+1. Navigate to Settings tab or the push test page
+2. Tap "Enable Push Notifications"
+3. iOS shows a native permission dialog → Allow
+4. Subscription is created with Apple Push Service at `web.push.apple.com/...`
+
+### Verification
+After subscribing, the endpoint URL starts with `https://web.push.apple.com/` — this confirms APNs is handling delivery.
+
+## Confirmed Working (Jul 9, 2026)
+Tested on iPhone with PWA installed from Home Screen:
+- Service worker registration: ✅
+- Permission granted: ✅
+- Push subscribed: ✅ (endpoint: web.push.apple.com)
+- Subscription saved to server: ✅
+- Push sent (--sent: 1): ✅
+- Notification received on device: ✅
+
+## Desktop
+No special handling needed. Chrome, Firefox, Edge all support Web Push natively in the browser. No PWA install required.