engineer-ios-setup

Install and configure the Braze iOS SDK for analytics, session tracking, and push notifications.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-ios-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineer-ios-setup
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/engineer-ios-setup
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-ios-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps engineers integrate and validate the Braze iOS SDK so analytics, device properties, and push notifications work reliably in an iOS app and upgrades do not introduce silent failures.

Core Features & Use Cases

  • Initial SDK installation: Guidance for adding the SDK via SPM, CocoaPods, Carthage, or manual frameworks and ensuring initialization timing is correct.
  • Device storage & properties: How to inspect and allowlist collected device fields, manage privacy-sensitive identifiers, and troubleshoot missing personalization attributes.
  • Push & rich notifications: Checklist for adding a Notification Service Extension, linking frameworks, and resolving common rich push rendering issues.
  • Changelog and migration advice: Notes on Swift vs Objective-C SDK lineages, reading changelogs before upgrades, and choosing the appropriate SDK for new projects.
  • Sample app usage: When and how to run the provided sample apps to reproduce and isolate integration problems.

Quick Start

Initialize and configure the Braze iOS SDK in your Xcode project, add a Notification Service Extension for rich push, configure device property allowlists if needed, and verify initialization in application launch.

Frequently Asked Questions about engineer-ios-setup

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

FAQPage Schema
How do I install and configure the Braze iOS SDK for push notifications in Swift?

To install the Braze iOS SDK, add it via SPM, CocoaPods, Carthage, or manual frameworks, then initialize it during application launch with the correct API key. Validate behavior using provided sample apps and changelogs.

How do I set up a Notification Service Extension for Braze rich push on iOS?

Setting up a Notification Service Extension for Braze rich push requires adding the extension target, linking the necessary frameworks, and following a checklist to resolve common rendering issues and ensure correct integration.

How do I allowlist device properties in the Braze iOS SDK?

To allowlist device properties in the Braze iOS SDK, inspect collected device fields and configure the allowlist to manage privacy-sensitive identifiers and troubleshoot missing personalization attributes.

Can I migrate my Braze iOS SDK integration from Objective-C to Swift?

You can migrate your Braze iOS SDK integration from Objective-C to Swift using specific migration guidance, which notes the differences between Swift and Objective-C SDK lineages and helps choose the appropriate SDK for new projects.

Why are my Braze iOS push notifications not working after an SDK upgrade?

Braze iOS push notifications may fail after an SDK upgrade due to initialization timing errors or missed changelog updates. Validate behavior against changelogs and sample apps to isolate and resolve integration problems.