What problem does it solve?
This Skill consolidates best practices and debugging guidance for implementing local and remote push notifications on iOS and macOS, reducing integration errors, missed deliveries, and permission regressions.
Core Features & Use Cases
- Permission flow and entitlement checks: how to request authorization, use provisional and critical alerts, and handle denied permissions.
- APNs registration and token management: proper use of AppDelegate or UIApplicationDelegateAdaptor, converting device tokens to hex, and reliably uploading tokens to backend services.
- Local and remote payloads: constructing aps payloads, silent/background pushes, mutable-content for service extensions, and localization keys.
- Notification handling and deep linking: UNUserNotificationCenterDelegate usage for foreground presentation and tap routing, plus patterns for a DeepLinkRouter to navigate app UI.
- Rich notifications and extensions: Notification Service and Content extensions, attachments, decryption, App Groups, and memory/time constraints.
- Testing and debugging: simulator limitations, simctl push, Console.app diagnostics, APNs response handling, and common reasons deliveries fail.
- Real-world example: integrate chat message pushes with image attachments, deep-link taps into a conversation view, and fallback to background sync if delivery fails.
Quick Start
Request authorization, register for remote notifications, and upload the hex-formatted device token to your server.
