push-notifications

Implement iOS/macOS local and remote notifications with UserNotifications and APNs.

Updated May 10, 2026
One-click install
npx skills add https://github.com/FelixRauch/medat-figuren --skill push-notifications-felixrauch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: push-notifications
Source: https://github.com/FelixRauch/medat-figuren/tree/main/.agents/skills/push-notifications
Command: npx skills add https://github.com/FelixRauch/medat-figuren --skill push-notifications-felixrauch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of building, debugging, and maintaining iOS/macOS push and local notification flows that correctly handle permissions, payloads, foreground behavior, and user interactions.

Core Features & Use Cases

  • Notification authorization and status handling: Request, verify, and upgrade notification permissions (including provisional authorization) without prompting repeatedly.
  • APNs and remote notification lifecycle: Register for remote notifications, capture and re-upload device tokens, and handle common delivery failures.
  • Local notification scheduling and management: Create content, choose triggers (time, calendar, location), schedule requests, and remove pending/delivered notifications.
  • Interactive notifications: Define categories and actions, handle action responses (including text input), and support notification grouping with thread identifiers.
  • Advanced delivery scenarios: Support silent/background pushes, mutable-content for service extensions, deep-link routing on taps, rich/extended notification patterns, and badge management.

Quick Start

Use the push-notifications skill to implement local and APNs push notifications end-to-end in a SwiftUI iOS app, including permission requests, delegate handling, scheduling, and debugging delivery issues in simulator and on-device.

Frequently Asked Questions about push-notifications

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

FAQPage Schema
How do I request APNs push notification authorization and register for remote notifications in SwiftUI?

Request UserNotifications authorization first, then register for remote notifications to capture the APNs device token. Correct ordering prevents permission failures and ensures valid token delivery for proper hex formatting and backend processing.

Why are my silent push notifications not delivered on iOS simulator?

Silent push notifications face simulator limitations and common APNs delivery failures. Validate payload structure, ensure proper APNs token hex formatting, and apply graceful fallbacks when testing background pushes, as simulator environments restrict reliable silent push delivery.

How do I add interactive actions and text input to iOS push notifications?

Define actionable categories and actions within UserNotifications to handle interactive push notification responses, including text input. Wire the delegate properly to capture action responses and support notification grouping using thread identifiers for organized delivery.

What is the correct APNs device token format for backend push delivery?

The correct APNs device token format is hex. Properly format the captured token as a hex string before uploading to your backend to prevent common APNs delivery failures and ensure reliable remote notification routing to target devices.

How do I handle mutable-content and rich push notifications with a service extension?

Handle mutable-content for service extensions to support rich and extended notification patterns. Validate payload structure carefully to trigger the service extension, enabling dynamic content modification and rich media attachment before final push notification presentation.

Can I schedule local notifications with calendar and location triggers in SwiftUI?

Schedule local notifications by creating content and choosing time, calendar, or location triggers. Manage scheduling requests and remove pending or delivered notifications using UserNotifications, supporting reliable local delivery alongside APNs remote notification flows.