recap-integration

name	recap-integration
description	Integrates the Recap Swift package into SwiftUI apps, authors Recap-compatible releases markdown, and configures RecapDisplayPolicy and RecapScreen customization. Use when adding Recap into an app, updating Releases.md, or customizing the behavior of a Recap screen.

Recap Integration

Use this skill when integrating, configuring, or using the Recap library.

What to read first

Start with these files:

• README.md
• Sources/Recap/Public/RecapScreen.swift
• Sources/Recap/Public/View+Recap.swift
• Sources/Recap/Public/RecapDisplayPolicy.swift
• Sources/Recap/Public/RecapDisplayPolicy.Trigger.swift
• Demo/Demo/Assets/Releases.md
• Demo/Demo/DemoRecapScreen.swift

Read additional public API files in Sources/Recap/Public/ only if the task touches a specific type.

Core workflow

1. Identify whether the task is about integration, release authoring, display policy, or screen customization.
2. Prefer Recap's public APIs over custom implementations.
3. Match existing Recap naming and examples from the README and demo app.
4. Keep examples and release content user-facing and concise.

Integration rules

• Prefer ReleasesParser(fileName:) for bundled release markdown.
• Prefer RecapScreen(releases:) as the entry point for presentation.
• Prefer RecapDisplayPolicy and RecapDisplayPolicy.Trigger over hand-rolled version gating.
• Prefer .recapScreenPaginationStyle(.automatic) unless the user explicitly wants forced .labeled or .compact.
• When customizing behavior, use View+Recap modifiers instead of editing internal implementation unless the task is explicitly a library change.

Release markdown rules

When creating or editing a Recap releases markdown file:

• Keep the newest release first.
• Follow the schema documented in README.md.
• Use one release section per app version.
• Use user-facing feature titles and descriptions, not commit-style summaries.
• Choose the semantic change type (Major, Minor, Patch) based on product impact, not commit count.
• Reuse the style and structure of Demo/Demo/Assets/Releases.md.

Mac Catalyst guidance

If the task touches Mac Catalyst:

• Preserve the distinction between automatic pagination, labeled buttons, and compact buttons.
• Be careful not to regress iPhone or iPad behavior while changing Catalyst presentation.

Avoid

• Do not invent a different release markdown format.
• Do not parse releases manually if ReleasesParser is sufficient.
• Do not replace RecapDisplayPolicy with custom version-comparison logic unless the user explicitly needs behavior outside the public API.