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.