whats-new

Generate version-tracked What's New screens for Swift iOS and macOS apps.

27|5|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/bocan/bocan-music --skill whats-new-bocan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whats-new
Source: https://github.com/bocan/bocan-music/tree/main/.claude/skills/generators/whats-new
Command: npx skills add https://github.com/bocan/bocan-music --skill whats-new-bocan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual work of building version-tracked post-update notification screens for apps, ensuring users are informed of new features and changes after updates without showing the screen to first-time installs or repeating it for the same version.

Core Features & Use Cases

  • Version-aware display: Only shows the screen to existing users after an app update, using CFBundleShortVersionString for accurate version comparison and UserDefaults for persistence.
  • Customizable paged UI: Displays new features as full-page cards with SF Symbol icons, titles, and descriptions, with support for dot indicators or page count labels.
  • Flexible content sources: Supports hardcoded Swift data, local bundled JSON, or remote JSON endpoints for release notes, with offline fallback for remote content.
  • Use Case: A Swift developer building a macOS music player can use this Skill to automatically show a What's New screen after users update, highlighting new features like gapless playback or EQ improvements, without writing version tracking logic or UI from scratch.

Quick Start

Use the whats-new skill to generate a complete, version-tracked post-update What's New screen for your Swift iOS or macOS app.

Frequently Asked Questions about whats-new

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

FAQPage Schema
How do I show a What's New screen in my Swift iOS app only after a user updates?

You can display a What's New screen only after an update by comparing the app's CFBundleShortVersionString against a version stored in UserDefaults. If the stored version is older, present the release notes UI and update UserDefaults to prevent repeat displays.

Can I load iOS app release notes from a remote JSON endpoint for my What's New screen?

Yes, you can load release notes from a remote JSON endpoint. This approach typically includes a local bundled JSON fallback to ensure the What's New screen still displays feature announcements if the device is offline or the remote fetch fails.

What's the best way to skip the What's New screen for first-time app installs in Swift?

The best way to skip the What's New screen for first-time installs is to check UserDefaults for an existing version key. If no previous version is stored, the user is new, so you bypass the release notes screen and silently record the current app version.

How do I build an accessible paged UI for macOS app updates with feature announcements?

You can build an accessible paged UI for app updates by using full-page cards with SF Symbol icons, titles, and descriptions. Include dot indicators or page count labels and apply accessibility traits to ensure the feature announcements are navigable with VoiceOver.

Does version tracking for a What's New screen require CFBundleShortVersionString comparison in Swift?

Yes, accurate version tracking for a What's New screen requires CFBundleShortVersionString comparison. Parsing this string allows you to determine if the user has transitioned from an older version, triggering the post-update release notes screen exactly once per update.