push-notifications

Design, review, and debug iOS/macOS push notifications with APNs.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/harshav167/build-ios-apps --skill push-notifications-harshav167
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: push-notifications
Source: https://github.com/harshav167/build-ios-apps/tree/main/skills/push-notifications
Command: npx skills add https://github.com/harshav167/build-ios-apps --skill push-notifications-harshav167

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Push notifications are essential for engaging iOS/macOS users, but implementing, reviewing, and debugging them across local and remote (APNs) messaging, permissions, payloads, and actions can be complex. This Skill consolidates guidance and patterns to streamline permission flows, token handling, notification payloads, handling in foreground, categories and actions, grouping, rich attachments, background pushes, and deep-link routing.

Core Features & Use Cases

  • Local and remote notification setup and delivery patterns using UserNotifications and APNs.
  • Foreground presentation, tapping, and deep-link routing via a shared router.
  • Notification actions, categories, grouping, and rich/interactive content including service extensions and content extensions.
  • Background pushes and silent pushes handling with best practices, including ensuring lifecycle and testing support.
  • Testing and debugging guidance with simulator, device testing, and logging patterns.

Quick Start

Install the plugin and load the push-notifications skill in Cursor to start designing, testing, and debugging push notifications.

Frequently Asked Questions about push-notifications

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

FAQPage Schema
How do I handle iOS push notifications in the foreground using UserNotifications?

Foreground push notifications require specific presentation options to display alerts when the app is active. This Skill provides patterns for foreground presentation, tapping, and deep-link routing via a shared router to ensure correct in-app behavior.

What is the correct APNs token handling process for remote notifications?

APNs token handling involves registering for remote notifications and securely sending the device token to your server. This Skill automates review of token lifecycle management and remote notification payload structures to prevent delivery failures.

How do I add rich content and interactive actions to iOS push notifications?

Rich content and interactive actions use notification categories and extensions. This Skill covers notification actions, grouping, and rich attachments using service and content extensions to deliver interactive notification experiences.

Can I test and debug silent background pushes on the iOS simulator?

Background and silent pushes require specific lifecycle handling and testing support. This Skill provides testing and debugging guidance including simulator patterns, device testing strategies, and logging to verify background push delivery.

What is the best way to structure APNs payloads for deep-link routing?

APNs payloads for deep-link routing need custom keys that your shared router interprets upon user tap. This Skill enforces correct payload structures and deep-link behavior to streamline navigation from remote notifications.

Do I need a service extension to process rich notifications on iOS?

Service extensions are needed to modify payload content and download rich attachments before display. This Skill guides rich notification workflows across extensions to ensure images, video, and interactive content render correctly.