ginnoir
b89690a9f2
- pnpm 10 workspace + TypeScript strict + ESLint flat + Prettier - CLAUDE.md as canonical brief - docs/tasks/ — 22 task briefs broken out by phase for sub-sessions - docs/decisions/ — ADR scaffold Implements task 01 (repo-init).
1.2 KiB
1.2 KiB
40 — Web Push (VAPID)
Goal
Subscribe browsers to web push and deliver notifications to them.
Depends on
- 06 (auth), 50 (PWA shell — needed for iOS to allow push). If 50 isn't done, this task can land but iOS won't fire until then.
Scope
pnpm add web-pushfor server, use built-inPushManageron client.- VAPID keys generated once (script:
pnpm vapid:generate), stored in.envasVAPID_PUBLIC_KEY/VAPID_PRIVATE_KEY. Document in README. - Schema:
push_subscriptions(id,user_id,endpointunique,p256dh,auth,user_agent,created_at). - Service worker registers on app load; on user opt-in (button in
/settings), prompts permission and stores subscription via server action. - Server helper
sendPush(userId, { title, body, url })iterates subscriptions, removes any returning 404/410.
Out of scope
- Notification preferences per category (defer).
- ntfy fallback (task 42).
Acceptance criteria
- Opt-in flow works in Chrome desktop and mobile, plus iOS Safari (when PWA installed).
- Stale subscriptions are pruned on send failure.
- Sending a test notification from
/settingsreaches all of the current user's subscribed devices.