push-notifications

SKILL.md

Local and remote push notifications for iOS/macOS with APNs, actions, and rich content.

Covers permission flow, APNs token registration, local scheduling, and remote payload structure with support for silent pushes, critical alerts, and provisional notifications

Includes foreground handling, user tap routing, interactive actions with text input, and notification grouping by thread identifier

Provides AppDelegate setup patterns, deep-linking from notifications, and Notification Service/Content Extension integration for mutable content

Targets iOS 16+ with Swift 6.2; includes common mistakes, review checklist, and debugging patterns

Push Notifications

Implement, review, and debug local and remote notifications on iOS/macOS using UserNotifications and APNs. Covers permission flow, token registration, payload structure, foreground handling, notification actions, grouping, and rich notifications. Targets iOS 26+ with Swift 6.3, backward-compatible to iOS 16 unless noted.

Contents

Permission Flow

APNs Registration

Local Notifications

Remote Notification Payload

Notification Handling

Notification Actions and Categories

Notification Grouping

Common Mistakes

Review Checklist

References

Permission Flow