Question 1

How do I add WhatsNewKit to my SwiftUI app?

Accepted Answer

Use Swift Package Manager in Xcode to add the package URL, then apply the .whatsNewSheet() modifier to your view and configure the WhatsNewEnvironment with your feature collections. The README provides code examples for automatic and manual presentation modes.

Question 2

Can WhatsNewKit be used with UIKit or AppKit?

Accepted Answer

Yes, it supports UIKit and AppKit via WhatsNewViewController, which can be presented modally and includes version store integration. The README shows how to initialize and present it with guard statements for version checking.

Question 3

How do I customize the design of the WhatsNew view?

Accepted Answer

Adjust the layout by modifying WhatsNew.Layout properties like spacing, padding, and colors, or pass a custom layout when presenting. Features support images, titles with colors, and Markdown subtitles for rich text.

Question 4

WhatsNewKit vs building a custom onboarding screen - which is better?

Accepted Answer

WhatsNewKit saves time with built-in version tracking and cross-platform consistency, but if you need highly unique animations or server-driven content, a custom solution might be preferable. It's ideal for standard feature showcases but less so for complex tutorials.

Question 5

Does WhatsNewKit support dynamic content from a backend?

Accepted Answer

No, it focuses on static feature definitions per app version. For dynamic content, you'd need to extend WhatsNewEnvironment or handle manual presentation, as there's no built-in API for fetching remote data.

Question 6

How to test WhatsNewKit presentations in development?

Accepted Answer

Use InMemoryWhatsNewVersionStore for testing to avoid persisting versions, or manually reset stores. The example app in the repository demonstrates various configurations for debugging.

WhatsNewKit

What is WhatsNewKit?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions