Skip to main content

push

push — ɳSelf documentation.

Push Plugin

APNs + FCM push notification relay with Hasura event-trigger fan-out. Free: MIT licensed.

Install

nself plugin install push

What It Does

Provides a push notification relay for Apple Push Notification service (APNs) and Firebase Cloud Messaging (FCM). Integrates with Hasura event triggers so database events fan out directly to device push notifications without custom server code. Tracks delivery state for each notification.

Configuration

Env Var Default Description
PUSH_APNS_KEY_ID none APNs key ID from Apple Developer portal
PUSH_APNS_TEAM_ID none Apple Developer team ID
PUSH_APNS_PRIVATE_KEY none APNs .p8 private key (base64 encoded)
PUSH_APNS_BUNDLE_ID none iOS app bundle identifier
PUSH_FCM_PROJECT_ID none Firebase project ID
PUSH_FCM_CREDENTIALS none Firebase service account JSON (base64 encoded)
PUSH_APNS_ENV production production or sandbox

Ports

No fixed external port. The push relay runs as an internal service triggered by Hasura events.

Database Tables

2 tables added to your Postgres database:

  • np_push_queue: queued push notifications pending delivery
  • np_push_log: delivery history and status per notification

Nginx Routes

None. Internal only.

Hasura Integration

The push plugin registers a Hasura event trigger. When a row is inserted into np_push_queue, Hasura calls the push relay to deliver it. No custom webhook code required.

Source