opencode/packages/apn-relay/README.md

APN Relay

Minimal APNs relay for OpenCode mobile background notifications.

What it does

• Registers iOS device tokens for a shared secret.
• Receives OpenCode event posts (complete, permission, error).
• Sends APNs notifications to mapped devices.
• Stores delivery rows in PlanetScale.

Routes

• GET /health
• GET / (simple dashboard)
• POST /v1/device/register
• POST /v1/device/unregister
• POST /v1/event

Environment

Use .env.example as a starting point.

• DATABASE_HOST
• DATABASE_USERNAME
• DATABASE_PASSWORD
• APNS_TEAM_ID
• APNS_KEY_ID
• APNS_PRIVATE_KEY
• APNS_DEFAULT_BUNDLE_ID

Run locally

bun install
bun run src/index.ts

Docker

Build from this directory:

docker build -t apn-relay .
docker run --rm -p 8787:8787 --env-file .env apn-relay