SimpleNS Logo

Scalable.Reliable.Extensible.

Open-source plugin-based notification orchestration engine for developers who value control.

SimpleNS Logo

Everything You Need for Reliable Notifications

Built-in resilience, scalability, crash-recovery and observability out of the box

Plugin-Based Delivery

Swap notification providers without touching your code. Install community plugins or build custom ones with our SDK.

Never Lose a Message

Recovery service detects orphaned notifications from crashes and automatically reschedules them.

1s
2s
4s
8s

Exponential Backoff Retries

Automatic retry with increasing delays ensures your notifications get delivered.

Scheduled

Send at the Right Time

Queue notifications for future delivery with Redis-backed scheduling.

Email
SMS
Push

Scale Independently

Scale email, SMS, and push processors separately based on your traffic patterns.

Monitor & Manage

Modern dashboard with real-time analytics, event filtering, one-click retries, and interactive Payload Studio.

Self-Hosted & Open Source

Deploy SimpleNS Your Way

Flexible infrastructure options—single machine, distributed, or cloud-native. Full control over your notification infrastructure with zero vendor lock-in.

Self-Hosting Guide
Terminal
$docker-compose -f docker-compose.infra.yaml up -d
Container mongo started
Container kafka started
Container redis started
$docker-compose up -d
SimpleNS is running at http://localhost:3000
MongoDB
Kafka
Redis
Single Machine
All-in-one setup
Distributed
Scale across hosts
Cloud Ready
Use managed services

Simple Architecture, Powerful Results

Separation of concerns: Core handles orchestration, plugins handle delivery

1

Your App or Web Service sends a Notification

Send a unified JSON payload to SimpleNS REST API. One request format works across all channels—email, SMS, WhatsApp, and more.

POST /api/notification
{
  "channel": ["email"],
  "recipient": {
    "email": "user@example.com"
  },
  "content": {
    "subject": "Hello!"
  }
}
2

Background Workers Process It

Your notification is persisted to MongoDB and published to Kafka queues. Scheduled messages go to Redis ZSET for time-based delivery.

MongoDBKafka StreamingRedis SchedulingGuaranteed Delivery
3

Core Routes to the Right Plugin

SimpleNS automatically selects the appropriate plugin based on the channel and your configuration. Rate limiting and retry policies are applied.

Gmail
Twilio
WhatsApp
FCM
4

Plugin Delivers the Message

The selected plugin handles the actual delivery using your provider's API. If delivery fails, exponential backoff retries kick in automatically.

1st2s
2nd4s
3rd8s
4th16s
→ max
5

Track Everything in Real-Time

Delivery status is saved to MongoDB and sent via webhooks. Monitor all events in the Admin Dashboard with filtering, search, and analytics. Retry failed and alerted events also.

DeliveredPendingProcessingFailed

One API. Every Channel.

Send notifications across email, SMS, WhatsApp, push, and more—all with the same unified interface

Email

Gmail (Nodemailer)

Mock

Built-in testing

Custom

Build with SDK

Extend with Custom Plugins

Support any provider in minutes using our powerful SDK

Quick Start
# Scaffold a new plugin
npx @simplens/create-simplens-plugin

# Generate config file
npx @simplens/config-gen gen @simplens/nodemailer-gmail
Simple Code
import { SimpleNSProvider } from '@simplens/sdk';

class MyProvider implements SimpleNSProvider {
  async send(notification) {
    // Your delivery logic
    return { success: true };
  }
}

No Vendor Lock-in

Switch providers instantly without code changes

Quick Integration

CLI scaffolding gets you started in seconds

Type-Safe

Full TypeScript support with schema validation

Community-Driven

Share and use plugins from the ecosystem

Plugin SDK with full TypeScript support • @simplens/sdk + @simplens/create-simplens-plugin

Powerful Admin Dashboard Included

Built-in monitoring and management tools—no extra setup required

12.4K
89%
23

Real-Time Dashboard

Status cards, delivery metrics, and recent activity feed

Events Explorer

Search and filter notifications with advanced sorting

Retry All

Failed Events

Dedicated page with bulk retry capabilities

Orphaned
3
Stuck
1

System Alerts

Track orphaned, stuck, and ghost notifications

Plugin Management

View installed plugins and configurations

Payload Studio

Payload Studio

Interactive schema builder for API requests

Monitor & Search

  • Paginated event tables with filtering
  • Search by request ID
  • Filter by status, channel, provider
  • Sort by created/updated timestamps

Manage Failures

  • Bulk retry for failed notifications
  • One-click resolution for alerts
  • Detailed error messages and logs
  • Retry count tracking

Analytics & Insights

  • Status distribution charts
  • Channel-wise breakdown
  • Delivery and failure rates
  • Real-time statistics
Zero ConfigurationDark Mode UIBulk ActionsType-Safe Schemas

Built for Developers Who Value Control

Stop fighting notification complexity. Get reliability, flexibility, and observability out of the box.

Vendor Lock-in

Stuck with one provider's API and pricing

Plugin Architecture

Swap providers in minutes without changing code

Silent Failures

Messages disappear without a trace

Exponential Backoff

Automatic retries with configurable limits

Crash = Lost Messages

Server crashes leave notifications orphaned

Crash Recovery Service

Detects and rescues stuck notifications

Single Point of Failure

One queue handles everything

Horizontal Scaling

Scale email, SMS, push workers independently

Complex Scheduling

Build your own delayed job system

Built-in Scheduling

Redis-backed queue for future delivery

Different APIs per Channel

Learn every provider's unique interface

Unified API

One endpoint for all notification types

Core Value Props

Reliability First

No message is ever lost

Developer Freedom

Self-hosted & open-source

Production Ready

Built-in observability

100% Open Source
MIT License
Zero Vendor Lock-in
Plugin-based providers
Full Observability
Grafana + Loki included

Built for Real-World Scenarios

Technical use cases where SimpleNS shines

Auth
Users
Orders
API
Notify

Microservices Architecture

Decouple notification logic from business services with a unified API

Primary
Gmail
↓ failover
Backup
SendGrid

Provider Redundancy

Automatic failover to backup providers when primary is down

12.4K processed

Batch Processing

Send thousands of notifications efficiently with batch API endpoints

9:00 AM
2:00 PM
6:00 PM

Scheduled Campaigns

Queue time-zone-aware campaigns with built-in delayed delivery

Frequently Asked Questions

Everything you need to know about SimpleNS

Yes! SimpleNS is 100% open-source under the MIT License. Self-host it for free with no hidden costs or usage limits.

Still have questions?