notifkit

Self-hosted notification infrastructure for product notifications. One notify() call handles email, SMS, push, etc, with preferences, quiet hours, retries, fall

What is notifkit?

Self-hosted notification infrastructure for product notifications. One notify() call handles email, SMS, push, etc, with preferences, quiet hours, retries, fallback, scheduling, workflows, and delivery logs built in.

Overview of notifkit

What it is

​​notifkit is a self-hosted notification infrastructure for product notifications. It provides a single notify() API call that handles email, SMS, push notifications, chat messages, and webhooks. It includes built-in features such as user preferences, quiet hours, retries, fallback, scheduling, workflows, an admin dashboard, and delivery logs. It runs on PostgreSQL and Redis. The project is open source under the MIT license.​​

Key features

​​

  • Single API call (notify()) handles multiple channels: push, email, SMS, chat, webhooks.​
  • Built-in user preferences, consent, quiet hours, retries, deduplication, throttling, template rendering, and delivery tracking.​
  • Channel fallback: if one channel fails, it automatically tries the next specified channel.​
  • Workflows defined in TypeScript code, supporting multi-step sequences with delays and event blocking.​
  • Admin dashboard for live activity feed, delivery logs, queue depth, workflow runs, dead-letter replay, scheduled-send cancellation, and API key management.​
  • MCP server for AI agent integration (e.g., Claude Code, Cursor).​
  • Supports multiple projects with separate API keys and data.​​

Use cases

​​

  • Product notifications: order shipped, password reset, OTPs, marketing campaigns.​
  • Multi-channel notification delivery with fallback (e.g., push then email).​
  • Scheduled and workflow-based notifications (e.g., wait days, block on events).​
  • Self-hosted alternative to hosted services like Knock or Courier, avoiding per-message billing.​
  • Integration with existing PostgreSQL and Redis infrastructure.​​

Getting started

​​Requires Node 22+ and Docker. In development, notifkit starts throwaway PostgreSQL and Redis containers.​​bash​npm create notifkit@latest my-app # or: npx notifkit create my-app​cd my-app​npm run dev # leave it running​​​In a second terminal:​​bash​npm run setup # create a project, save its API key to .env​npm run send # send a test notification​​​The default provider prints notifications to the server terminal, so no provider account is needed to try it. Pass --provider resend, twilio or fcm to start with a real one.​​

License and pricing

​​License: MIT. Open source, no paid edition. The project is self-hosted; costs are whatever your PostgreSQL and Redis infrastructure costs.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/devkitshqnotifkit.svg)](https://yunodb.com/tools/devkitshqnotifkit?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/devkitshqnotifkit?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/devkitshqnotifkit.svg" alt="Featured on YunoDB" height="20"></a>