From b8bf1aa347233cc3134f506ed71eb3fe9b1e66e7 Mon Sep 17 00:00:00 2001
From: maaz519 <maaz@insigniaconsultancy.com>
Date: Thu, 23 Jul 2026 15:37:57 +0530
Subject: [PATCH] chore(env): document VAPID_* for Web Push offline
 notifications

Web Push (VAPID) env for the already-built notification stack: unset
VAPID_PUBLIC_KEY disables sends (WebPushDelivery returns 'failed'). Generate
with 'npx web-push generate-vapid-keys'.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .env.example | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.env.example b/.env.example
index b99a182..fa35fec 100644
--- a/.env.example
+++ b/.env.example
@@ -21,3 +21,10 @@ IIOS_CRED_KEY=""
 # Orphaned-media garbage collection (uploaded-but-never-sent attachments).
 # Interval 0 = off; set e.g. 3600000 (hourly) in prod. Grace defaults to 24h.
 IIOS_MEDIA_GC_INTERVAL_MS=0
+
+# Web Push (VAPID) for offline notifications. Unset VAPID_PUBLIC_KEY → push is disabled
+# (subscribe endpoint still stores subs, but WebPushDelivery returns 'failed' — no sends).
+# Generate a keypair with: npx web-push generate-vapid-keys
+VAPID_PUBLIC_KEY=""
+VAPID_PRIVATE_KEY=""
+VAPID_SUBJECT="mailto:dev@insignia"