skills.rest
Roy-wonji
Roy-wonjiCOMMUNITY
Explore all skills by this author →
GitHub

push-notifications

Implement iOS/macOS UserNotifications permission and APNs registration flows.

Updated May 6, 2026
Search Tags:#debugging#swiftui#push notifications#apns#silent push#notification actions#unusernotifications
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill push-notifications-roy-wonji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: push-notifications
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/swift-ios-skills/skills/push-notifications
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill push-notifications-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents missed, misrouted, or malfunctioning iOS/macOS notifications by guiding you through the full notification lifecycle from permissions and APNs registration to payload handling and interactive actions.

Core Features & Use Cases

  • Permission & registration troubleshooting: Verify authorization state, request the right permission options, and register for remote notifications in the correct order.
  • Local + remote notification implementation: Build local notification content, schedule with triggers, define APNs payload structures, and handle foreground vs background behavior.
  • Interactive notifications & debugging: Configure notification categories/actions, support rich content via mutable-content/service extensions, and debug common delivery failures (including simulator limitations and silent push constraints) with a review checklist.

Quick Start

Ask the AI to implement a complete push notification setup for an iOS SwiftUI app, including permission flow, APNs token registration, foreground handling, and a notification action category that deep-links into the correct screen.

Frequently Asked Questions about push-notifications

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up APNs push notifications in a SwiftUI app?▼

To set up APNs push notifications in a SwiftUI app, you must configure UserNotifications permissions, register the APNs device token, and implement the UNUserNotificationCenterDelegate to handle foreground and background delivery.

Why are my silent push notifications not being delivered on iOS?▼

Silent push notifications often fail due to incorrect payload structures, missing entitlements, or simulator limitations. Debugging silent push delivery requires verifying your background modes and checking the APNs payload format.

How do I add interactive notification actions and deep-link routing from taps?▼

Adding interactive notification actions requires defining UNNotificationCategory and action objects, registering them with the UserNotifications framework, and implementing deep-link routing within the didReceive delegate method.

Does this handle local notification scheduling and rich notification extensions?▼

Yes, it handles local notification scheduling with triggers and supports rich notification scenarios by utilizing mutable-content and notification service extensions to modify the payload before delivery.

What is the correct way to handle APNs device token refresh and conversion?▼

Handling APNs device token refresh requires safely converting the Data object to a hex string and re-registering the token when the system calls the registration delegate method to ensure continuous push delivery.

Related Skills

Explore More Software Engineering Skills→
team-telnyxteam-telnyx
3

push-notification-tester

Test VoIP push notification delivery for iOS and Android via APNs and FCM.

Official
Intermediate
delta-and-betadelta-and-beta

engineer-push

Implement and troubleshoot push notification delivery across iOS, Android, and web platforms.

Community
Advanced
tanaka-mambingetanaka-mambinge

flutter-implementing-navigation-and-routing

Implement navigation and routing in Flutter apps with Navigator and go_router.

Community
Advanced
SoltusSoltus
1

capacitor-push-notifications

Configure Firebase Cloud Messaging push notifications in Capacitor apps.

Community
Intermediate