engineer-push

What problem does it solve?

End-to-end implementation and diagnosis of push notification delivery problems across iOS, Android, and web, including registration failures, token lifecycle issues, credential misconfiguration, payload limits, and delivery errors that prevent users from receiving notifications.

Core Features & Use Cases

• Registration & Subscription: Guidance for SDK registration flows, foreground vs background tokens, token reassignment, and subscription state management.
• Platform-Specific Implementation: APNs (.p8/.p12) and FCM/service account configuration, iOS badge count, Android notification channels, and web VAPID/service worker setup.
• Message Creation & Advanced Options: Payload construction, TTL, collapse keys, rich media, action buttons, and cross-platform composition constraints.
• Quality, Testing & Troubleshooting: Error-code interpretation (APNs/FCM), delivery diagnostics, test-send workflows, frequency capping, and reporting metrics analysis.
• Use Case Example: Diagnose why a cohort of iOS users stopped receiving pushes after an app update and produce steps to validate APNs credentials, token validity, and payload size.

Quick Start

Use the engineer-push skill to diagnose why iOS users are not receiving push notifications and provide step-by-step remediation for credentials, token registration, and payload validation.