iOS Push Notification Manager

Generate comprehensive push notification infrastructure for iOS apps with local notifications, remote push, rich media, notification actions, and permission management.

Overview

This skill generates production-ready notification infrastructure including:

• Local Notification Manager - Schedule time-based and calendar-based notifications
• Remote Push Manager - Handle APNs registration and remote notifications
• Notification Categories - Define notification actions and categories
• Notification Scheduler - Convenience methods for common notification types
• Notification Views - SwiftUI views for settings, lists, and permissions
• Notification Service Extension - Modify notifications before delivery

When to Use This Skill

Use this skill when:

• Implementing push notifications in iOS apps
• Adding payment reminders, rate alerts, or document notifications
• Creating notification settings UI
• Handling notification actions and responses
• Setting up remote push notification infrastructure
• Building rich notifications with images or videos
• Implementing notification permission flows
• Scheduling recurring notifications

Generated Files

The skill generates comprehensive notification infrastructure:

Core Notification Files (473 lines)

1. LocalNotificationManager.swift (305 lines) - Local notification scheduling and management
2. NotificationCategory.swift (168 lines) - Notification actions and categories

Remote Push Files (533 lines)

3. RemotePushManager.swift (201 lines) - Remote push registration and handling
4. PushNotificationService.swift (143 lines) - Notification service extension
5. NotificationScheduler.swift (189 lines) - Convenience scheduling methods

UI Views (481 lines)

6. NotificationSettingsView.swift (180 lines) - Settings interface
7. NotificationListView.swift (155 lines) - Pending notifications list
8. NotificationPermissionView.swift (146 lines) - Permission request UI

Total: 1,487 lines of production-ready Swift code

Quick Start

Generate All Files

# Generate local notification infrastructure
python3 scripts/generate_local_notification_manager.py

# Generate remote push infrastructure
python3 scripts/generate_remote_push_manager.py

# Generate notification UI views
python3 scripts/generate_notification_views.py

All files are generated in the generated/ directory.

Basic Integration

1. Add generated files to your Xcode project
2. Enable Push Notifications capability
3. Register notification categories on app launch
4. Request notification permissions

// In your App or AppDelegate
Task { @MainActor in
    NotificationCategoryManager.shared.registerCategories()
    await LocalNotificationManager.shared.checkAuthorizationStatus()
}

Common Use Cases

Schedule Payment Reminder

try await NotificationScheduler.shared.schedulePaymentReminder(
    paymentAmount: 2500,
    dueDate: paymentDueDate,
    reminderDaysBefore: 3
)

Schedule Document Reminder

try await NotificationScheduler.shared.scheduleDocumentReminder(
    documentName: "Tax Returns",
    dueDate: documentDueDate
)

Schedule Rate Alert

try await NotificationScheduler.shared.scheduleRateAlert(
    currentRate: 4.5,
    targetRate: 4.0
)

Request Permissions

// Show permission request view
NotificationPermissionView { granted in
    if granted {
        // User enabled notifications
    }
}

Handle Notification Actions

NotificationCenter.default.addObserver(
    forName: .didReceiveNotificationResponse,
    object: nil,
    queue: .main
) { notification in
    guard let actionIdentifier = notification.userInfo?["actionIdentifier"] as? String else {
        return
    }
    
    switch actionIdentifier {
    case "PAY_ACTION":
        // Handle payment action
    case "VIEW_DETAILS_ACTION":
        // Handle view details action
    default:
        break
    }
}

Reference Documentation

For detailed patterns and integration steps:

• Notification Patterns: references/notification_patterns.md

  • Local notification scheduling patterns
  • Remote push payload formats
  • Rich notification examples
  • Notification action patterns
  • Permission handling
  • Best practices

• Integration Guide: references/integration_guide.md

  • Project setup and capabilities
  • AppDelegate integration
  • Remote push configuration
  • UI integration examples
  • Testing procedures
  • Production checklist

Read these reference files when:

• Setting up remote push for the first time
• Creating custom notification categories
• Implementing notification service extension
• Troubleshooting notification issues
• Preparing for production deployment

Features

Local Notifications

• Time-based scheduling (intervals)
• Calendar-based scheduling (specific dates)
• Recurring notifications (daily, monthly)
• Badge management
• Custom sounds
• Rich notifications with images
• Notification cancellation
• Pending notification queries

Remote Push Notifications

• APNs device token registration
• Remote notification handling
• Silent notifications
• Background fetch
• Token management
• Server integration helpers

Notification Actions

• Pre-defined categories (payment, document, rate alert, reminder)
• Custom action creation
• Text input actions
• Destructive actions
• Foreground actions
• Action response handling

User Interface

• Permission request onboarding
• Settings view with preferences
• Pending notifications list
• Authorization status display
• Remote push registration status
• Test notification triggers

Rich Notifications

• Image attachments
• Video attachments
• Notification service extension
• Content modification before delivery
• Encrypted content handling

Notification Categories

Four pre-defined categories included:

1. REMINDER_CATEGORY - Snooze and Complete actions
2. PAYMENT_CATEGORY - Pay Now and View Details actions
3. DOCUMENT_CATEGORY - Upload Now and Remind Later actions
4. RATE_ALERT_CATEGORY - Check Rate and Dismiss actions

All categories support custom creation and registration.

Integration Notes

Required Capabilities

• Push Notifications
• Background Modes (for remote notifications)

AppDelegate Integration

Remote push requires AppDelegate methods for:

• Device token registration
• Token registration failure
• Remote notification receipt

Notification Service Extension

Optional but recommended for:

• Rich notifications with remote media
• Content modification before display
• Encrypted notification content

Testing

• Local notifications work in simulator
• Remote push requires physical device
• Use debug builds with test notification buttons
• Verify notification permissions on fresh installs

Best Practices

1. Timing: Schedule payment reminders 3-7 days before due date
2. Content: Keep titles under 20 chars, bodies 60-90 chars
3. Frequency: Limit to 3-5 notifications per day maximum
4. Permissions: Request permissions at appropriate moments
5. Actions: Provide clear, actionable button labels
6. Badge: Clear badge when user opens app
7. Testing: Test on multiple iOS versions and devices

Mortgage Calculator Integration

Perfect for mortgage apps requiring:

• Monthly payment reminders
• Document upload notifications
• Interest rate change alerts
• Application status updates
• Pre-approval expiration reminders
• Refinance opportunity alerts

Accessibility

All generated UI views include:

• VoiceOver labels
• Dynamic Type support
• High contrast support
• Semantic colors

Production Ready

Generated code includes:

• Error handling
• Thread safety with @MainActor
• Async/await patterns
• Published properties for SwiftUI
• Comprehensive documentation
• Common notification types
• Server integration helpers

Example Workflow

1. Generate files using the three scripts
2. Add files to Xcode project in appropriate groups
3. Enable capabilities in project settings
4. Register categories on app launch
5. Request permissions during onboarding
6. Schedule notifications when creating payments/documents
7. Handle actions in app to respond to user interactions
8. Test thoroughly on physical device
9. Configure server for remote push (if needed)
10. Deploy to production

Summary

This skill provides complete notification infrastructure for iOS apps with:

• ✅ Local notification scheduling (time-based, calendar-based, recurring)
• ✅ Remote push notification handling
• ✅ Rich notifications with images/videos
• ✅ Notification actions and categories
• ✅ Permission management UI
• ✅ Settings and list views
• ✅ Notification service extension
• ✅ Convenience scheduling methods
• ✅ 1,487 lines of production-ready code
• ✅ Complete integration documentation

Use this skill to add professional notification capabilities to iOS apps for user engagement, reminders, and real-time updates.