pushwoosh/pushwoosh-xcframework

Push notifications, In-App Messaging, and more for iOS, tvOS, and watchOS applications.

Documentation
Features
Installation

AI-Assisted Integration
Quick Start
Modules
Support
License

Documentation

[[Pushwoosh Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshiOS/documentation/pushwooshframework/) [[PushwooshCore Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshCore/documentation/pushwooshcore/) [[PushwooshVoIP Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshVoIP/documentation/pushwooshvoip/) [[PushwooshLiveActivities Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshLiveActivities/documentation/pushwooshliveactivities/) [[PushwooshTVOS Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshTVOS/documentation/pushwooshtvos/) [[PushwooshForegroundPush Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshForegroundPush/documentation/pushwooshforegroundpush/) [[PushwooshKeychain Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshKeychain/documentation/pushwooshkeychain/) [[PushwooshGRPC Documentation]](https://pushwoosh.github.io/pushwoosh-ios-sdk/PushwooshGRPC/documentation/pushwooshgrpc/)

Features

Core SDK

Push Notifications - Standard push notifications with rich media support
In-App Messages - Customizable in-app messaging
Tags & Segmentation - User targeting and segmentation
Inbox - Built-in message inbox functionality
Analytics - Delivery and conversion tracking

Advanced Modules

VoIP Push Notifications - CallKit integration for VoIP apps
Live Activities - iOS 16.1+ Live Activities with push updates
tvOS Support - Push notifications and Rich Media for Apple TV
Foreground Push - Custom foreground notifications with animations and effects

Installation

Swift Package Manager (Recommended)

In Xcode, go to File → Add Package Dependencies and enter:

https://github.com/Pushwoosh/Pushwoosh-XCFramework

Select the modules you need in your target's Frameworks, Libraries, and Embedded Content section.

Available modules:

PushwooshFramework - Core SDK (required)
PushwooshCore - Core functionality (required)
PushwooshBridge - Bridge module (required)
PushwooshLiveActivities - Live Activities support (optional)
PushwooshVoIP - VoIP push notifications (optional)
PushwooshTVOS - tvOS support (optional)
PushwooshForegroundPush - Custom foreground notifications (optional)
PushwooshKeychain - Persistent device ID across app reinstalls (optional)
PushwooshGRPC - gRPC transport for improved performance (optional)

CocoaPods

Add to your Podfile:


pod 'PushwooshXCFramework'

# Optional modules
pod 'PushwooshXCFramework/PushwooshLiveActivities'
pod 'PushwooshXCFramework/PushwooshVoIP'
pod 'PushwooshXCFramework/PushwooshTVOS'
pod 'PushwooshXCFramework/PushwooshForegroundPush'
pod 'PushwooshXCFramework/PushwooshKeychain'
pod 'PushwooshXCFramework/PushwooshGRPC'
pod 'PushwooshInboxUIXCFramework'

Then run:

pod install

AI-Assisted Integration

Integrate Pushwoosh iOS SDK using AI coding assistants (Claude Code, Cursor, GitHub Copilot, etc.).

Requirement: Your AI assistant must have access to Context7 MCP server or web search capabilities.

Quick Start Prompts

Choose the prompt that matches your task:

1. Basic SDK Integration

Integrate Pushwoosh iOS SDK into my iOS project using Swift Package Manager.

Requirements:
- Add SPM dependency from https://github.com/Pushwoosh/Pushwoosh-XCFramework
- Configure Info.plist with Pushwoosh App ID: YOUR_APP_ID
- Register for push notifications in AppDelegate

Use Context7 MCP to fetch Pushwoosh iOS SDK documentation.

2. Custom Push Notification Handling

Show me how to handle push notification callbacks (receive, open) with Pushwoosh SDK in iOS. I want to implement PWMessagingDelegate and add analytics tracking for these events.

Use Context7 MCP to fetch Pushwoosh iOS SDK documentation for PWMessagingDelegate.

3. User Segmentation with Tags

Show me how to use Pushwoosh tags for user segmentation in iOS. Create example helper class with methods for setting and getting tags.

Use Context7 MCP to fetch Pushwoosh iOS SDK documentation for setTags and getTags.

4. Live Activities Integration

Integrate Pushwoosh Live Activities into my iOS app. Show me how to:
- Create an ActivityAttributes model
- Start a Live Activity
- Update it via push notifications

Use Context7 MCP to fetch PushwooshLiveActivities documentation.

Quick Start

1. Initialize SDK

import PushwooshFramework

func application(_ application: UIApplication,
                didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    Pushwoosh.sharedInstance().registerForPushNotifications()

    return true
}

2. Handle Device Token

func application(_ application: UIApplication,
                didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    Pushwoosh.sharedInstance().handlePushRegistration(deviceToken)
}

3. Process Notifications

func application(_ application: UIApplication,
                didReceiveRemoteNotification userInfo: [AnyHashable: Any],
                fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {

    Pushwoosh.sharedInstance().handlePushReceived(userInfo)
    completionHandler(.newData)
}

PushwooshGRPC

Optional gRPC transport layer for improved network performance. Automatically falls back to REST if unavailable.

Requirements: iOS 13.0+

Support

License

Pushwoosh iOS SDK is available under the MIT license. See LICENSE for details.

Made with ❤️ by Pushwoosh

Package Metadata

Repository: pushwoosh/pushwoosh-xcframework

Default branch: master

README: README.md