sk-notifications

What problem does it solve?

This Skill solves the complexity of delivering in-app, email, and push notifications reliably while respecting each user’s category preferences and per-device push state.

Core Features & Use Cases

• Server-side notification dispatch (notify): Resolve effective channels from category defaults plus user preferences, insert records, and fan out to in-app, email, and push.
• Visibility-aware polling endpoint (/api/notifications/poll): Fetch the latest notifications and unread count in a Vercel-friendly way using serverless polling with dynamic behavior.
• Client integration (useNotifications) and UI components: Provide a ready-to-use bell/panel/settings experience, including per-device push subscription management via PushDevicesList.
• Central SSOT configuration (src/config/notifications.ts): Manage the categories × channels model in one place so the rest of the system stays consistent.

Quick Start

Use the sk-notifications Skill to dispatch a notification from a server action with notify() and wire the bell and settings UI so users can see, read, delete, and manage delivery preferences including push per device.