push
Push Plugin
Section titled “Push Plugin”APNs + FCM push notification relay with Hasura event-trigger fan-out. Free: MIT licensed.
Install
Section titled “Install”nself plugin install pushWhat It Does
Section titled “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
Section titled “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 |
No fixed external port. The push relay runs as an internal service triggered by Hasura events.
Database Tables
Section titled “Database Tables”2 tables added to your Postgres database:
np_push_queue: queued push notifications pending deliverynp_push_log: delivery history and status per notification
Nginx Routes
Section titled “Nginx Routes”None. Internal only.
Hasura Integration
Section titled “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
Section titled “Source”- SPORT:
.claude/docs/sport/F03-PLUGIN-INVENTORY-FREE.md - See also: Notify Plugin · Features: Auth