nself-notify: Push Notifications

Send push notifications to iOS and Android devices from your nself backend. Supports Firebase Cloud Messaging (FCM) for Android and Apple Push Notification service (APNs) for iOS, plus Web Push for browsers.

Install

nself license set nself_pro_...
nself plugin install notify
nself build
nself start

Configuration

Environment Variables

Add these to your .env file after installing the plugin:

PLUGIN_NOTIFY_FCM_SERVER_KEY=AAAAxxxxxxxx...
PLUGIN_NOTIFY_APNS_KEY_ID=ABCD1234EF
PLUGIN_NOTIFY_APNS_TEAM_ID=TEAM123456
PLUGIN_NOTIFY_APNS_KEY_PATH=/etc/nself/keys/AuthKey_ABCD1234EF.p8

Quick Start

Send a Notification

# Send a push notification to a user
curl -X POST http://127.0.0.1:3712/notify/send \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "fcm",
    "user_id": "user-uuid",
    "title": "New message",
    "body": "You have a new message from Alice",
    "data": {
      "conversation_id": "conv-123",
      "type": "chat"
    }
  }'

Subscribe a Device

# Register a device token for a user
curl -X POST http://127.0.0.1:3712/notify/subscribe \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user-uuid",
    "platform": "android",
    "device_token": "fcm-device-token-here"
  }'

Channels

API Reference

Send Payload

{
  "channel": "fcm",          // fcm | apns | webpush
  "user_id": "uuid",         // send to all devices for this user
  "device_token": "token",   // OR send to a specific device token
  "title": "string",         // notification title
  "body": "string",          // notification body text
  "data": {},                // optional key-value payload for the app
  "badge": 1,                // iOS badge count (optional)
  "sound": "default"         // notification sound (optional)
}

Subscribe Payload

{
  "user_id": "uuid",
  "platform": "android",   // android | ios | web
  "device_token": "string" // FCM token, APNs token, or Web Push subscription
}

Uninstall

nself plugin remove notify

Related

• Plugin Overview: Tier table, license setup, lifecycle commands
• nself-cron: Schedule notifications with cron jobs
• nself-mux: Route messages across channels including push

Port: 3712 | Bundle: ɳClaw ($0.99/mo) or ɳSelf+ ($3.99/mo) | Last Updated: April 2026 | Plugin Version 1.0.12