One-click install
npx skills add https://github.com/redfast/redfast-sdk-apple --skill engage-redfast
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engage
Source: https://github.com/redfast/redfast-sdk-apple/tree/main
Command: npx skills add https://github.com/redfast/redfast-sdk-apple --skill engage-redfast

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This guide helps you integrate Recurly Engage so prompts display correctly in a SwiftUI iOS or tvOS app, including initialization, triggering, and handling user outcomes.

Core Features & Use Cases

  • Initialize Engage once: Configure PromptManager.initPrompt early in app startup so prompt handling is ready before navigation and prompt triggers occur.
  • Single shared overlay pattern: Use one root-level .promptOverlay with a shared PromptOverlayTrigger observable to avoid stacking multiple overlays and ensure only one prompt shows at a time.
  • Trigger prompts from screens, buttons, and zones: Use .screen(...), .button(...), and PromptInline(zone:) to match configured trigger strings and zone IDs in Recurly Engage.
  • Optional manual prompt resolution & push/IAP wiring: Fetch triggerable prompts with getTriggerablePrompts, handle results in onEvent, and integrate push notifications and StoreKit 2 in-app purchases where applicable.

Quick Start

Follow the Redflix end-to-end pattern by initializing PromptManager at startup, creating a shared PromptOverlayTrigger, attaching a single .promptOverlay at the root view, and then setting the trigger from .task, button actions, or PromptInline zones.

Frequently Asked Questions about engage

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

FAQPage Schema
How do I integrate in-app purchase prompts in a SwiftUI iOS app?

To integrate in-app purchase prompts in SwiftUI, initialize the PromptManager at startup, attach a single root-level `.promptOverlay` using a shared observable trigger, and handle StoreKit 2 purchases within the prompt result callbacks.

What is the best way to trigger SwiftUI prompt overlays from different screens?

The best way to trigger SwiftUI prompt overlays is using a single shared `PromptOverlayTrigger` observable object attached at the root view, allowing you to set trigger events from `.screen`, button actions, or `PromptInline` zones without stacking multiple overlays.

How do I set up Recurly Engage push notifications in an iOS app?

Setting up Recurly Engage push notifications involves initializing the `PromptManager` early in app startup, configuring `RedfastPushManager` for APNS or FCM, and handling the incoming push payload through the prompt resolution flow.

Can I manually fetch triggerable prompts before displaying them in SwiftUI?

Yes, you can manually fetch triggerable prompts by calling `getTriggerablePrompts` and then handling the results within an `onEvent` callback to manage dismissal, tracking, deep links, and optional in-app purchase flows.

Does Recurly Engage support prompt triggering for tvOS apps?

Yes, Recurly Engage supports prompt triggering for tvOS apps by using the same SwiftUI patterns, including `PromptManager` initialization and the single root `.promptOverlay` shared observable trigger binding for consistent prompt display.