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

• SPORT: .claude/docs/sport/F03-PLUGIN-INVENTORY-FREE.md
• See also: Notify Plugin · Features: Auth