Code Generators

Production-ready code generators for iOS and macOS apps. Unlike advisory skills (review, audit), these skills generate working code tailored to your project.

When This Skill Activates

Use this skill when the user:

Wants to add a common app component (logging, analytics, onboarding, etc.)
Asks to "set up" or "add" infrastructure code
Mentions replacing print() with proper logging
Wants to add App Store review prompts
Needs analytics or crash reporting setup

Key Principles

1. Context-Aware Generation

Before generating code, skills will:

Read existing project structure and patterns
Detect deployment targets and Swift version
Identify architecture patterns (MVVM, TCA, etc.)
Check for existing implementations to avoid conflicts

2. Protocol-Based Architecture

Provider-dependent code uses protocols for easy swapping:

protocol AnalyticsService { ... }
class TelemetryDeckAnalytics: AnalyticsService { ... }
class FirebaseAnalytics: AnalyticsService { ... }
// Change provider by swapping ONE line

3. Platform Detection

Skills detect iOS vs macOS and App Store vs direct distribution to generate appropriate code.

Available Generators

Read relevant module files based on the user's needs:

logging-setup/

Replace print() statements with structured os.log/Logger.

Audit existing print() usage
Generate AppLogger infrastructure
Migrate print → Logger with proper privacy levels

analytics-setup/

Protocol-based analytics with swappable providers.

TelemetryDeck, Firebase, Mixpanel support
NoOp implementation for testing/privacy
Easy provider switching

onboarding-generator/

Multi-step onboarding flow with persistence.

Paged or stepped navigation
@AppStorage persistence
Skip option configuration
Accessibility support

review-prompt/

Smart App Store review prompts.

Platform detection (skips for non-App Store macOS)
Configurable trigger conditions
Smart timing logic
Debug override for testing

networking-layer/

Protocol-based API client with async/await.

Clean APIClient protocol for mocking/swapping
Type-safe endpoint definitions
Comprehensive error handling
Environment-based configuration

auth-flow/

Complete authentication flow.

Sign in with Apple integration
Biometric authentication (Face ID/Touch ID)
Secure Keychain storage
Credential state monitoring

paywall-generator/

StoreKit 2 subscription paywall.

Full StoreKit 2 implementation
Product loading, purchasing, restoring
Subscription status with Environment
Beautiful paywall UI

settings-screen/

Complete settings screen with modular sections.

Centralized AppSettings with @AppStorage
Appearance, Notifications, Account, About, Legal sections
Cross-platform (iOS/macOS)
Reusable row components

persistence-setup/

SwiftData persistence with optional iCloud sync.

SwiftData container configuration
Repository pattern for testability
Optional CloudKit/iCloud sync
Sync status monitoring
Migration support

error-monitoring/

Protocol-based crash/error reporting.

Sentry and Firebase Crashlytics support
NoOp implementation for testing/privacy
Breadcrumbs for debugging context
User context (anonymized)
Easy provider swapping

ci-cd-setup/

CI/CD configuration for automated builds and deployment.

GitHub Actions workflows (build, test, TestFlight, App Store)
Xcode Cloud scripts and setup guide
fastlane lanes for advanced automation
Code signing and secrets management
macOS notarization support

localization-setup/

Internationalization (i18n) infrastructure for multi-language apps.

String Catalogs (iOS 16+, recommended)
Type-safe L10n enum for compile-time safety
Pluralization and interpolation patterns
RTL layout support
SwiftUI preview helpers for testing locales

push-notifications/

Push notification infrastructure with APNs setup.

Registration and authorization flow
UNUserNotificationCenterDelegate implementation
Notification categories with action buttons
Type-safe payload parsing
Rich notifications and silent notifications

deep-linking/

Deep linking with URL schemes, Universal Links, and App Intents.

Custom URL scheme handling
Universal Links with AASA file
App Intents for Siri and Shortcuts
Type-safe route definitions and navigation
Spotlight indexing support

test-generator/

Test templates for unit, integration, and UI tests.

Swift Testing (modern, iOS 16+) and XCTest patterns
Mock object generation
ViewModel and service testing patterns
UI testing with page object pattern

accessibility-generator/

Accessibility infrastructure for inclusive apps.

VoiceOver labels, hints, and traits
Dynamic Type support with scaling
Reduce Motion handling
Accessibility audit checklist

widget-generator/

WidgetKit widgets for home screen and lock screen.

Static and interactive widgets (iOS 17+)
Timeline providers
Lock screen complications
Widget intents for configuration

app-icon-generator/

Programmatic app icon generation using CoreGraphics.

Apple HIG compliant icon design
Category-aware design recipes (productivity, media, dev tools, etc.)
3 variant generation for user selection
Automatic resizing to all required sizes (macOS + iOS)
Asset catalog installation with correct Contents.json
No external dependencies — pure CoreGraphics

feature-flags/

Feature flag infrastructure with local and remote support.

Protocol-based service with swappable providers
Local defaults with remote override (composite provider)
@Observable manager for SwiftUI integration
Debug menu for toggling flags

live-activity-generator/

ActivityKit Live Activity with Dynamic Island and Lock Screen.

ActivityAttributes and ContentState definitions
Dynamic Island layouts (compact and expanded)
Lock Screen presentation
Push-to-update support via APNs
Activity lifecycle management (start, update, end)

tipkit-generator/

TipKit inline and popover tips with rules and testing.

Inline and popover tip definitions
Rule-based display logic (parameter and event rules)
Display frequency and invalidation
Testing and preview support

cloudkit-sync/

CKSyncEngine-based CloudKit sync (iOS 17+).

CKSyncEngine setup and delegate
Record zone management
Conflict resolution strategies
Sharing and collaboration support

http-cache/

HTTP caching layer with Cache-Control, ETag, and offline fallback.

Cache-Control header parsing
ETag/Last-Modified conditional requests (304)
Stale-while-revalidate pattern
Decorator pattern wrapping existing APIClient
Network reachability for offline fallback

pagination/

Pagination infrastructure with offset and cursor patterns.

Offset-based and cursor-based response models
State machine (idle, loading, loaded, error, exhausted)
@Observable PaginationManager with prefetch threshold
Searchable pagination with debounced query
Infinite scroll, load-more button, and state views

image-loading/

Image loading pipeline with caching and CachedAsyncImage view.

NSCache memory cache with auto-eviction
LRU disk cache with expiration
Actor-based downloader with request deduplication
ImageIO thumbnail generation
Drop-in CachedAsyncImage SwiftUI replacement
Collection prefetching

share-card/

Shareable image cards for social media sharing.

ShareCardContent protocol with achievement, statistics, and quote types
ImageRenderer-based card generation
Configurable styles (minimal, branded, statistics)
ShareLink integration and QR code overlay

social-export/

Export content to social platforms with correct formats.

Platform-specific formatting (Instagram, TikTok, X)
Aspect ratio and resolution handling per platform
Branding overlay and caption support
URL scheme-based and share sheet export

subscription-lifecycle/

StoreKit 2 subscription lifecycle management.

Grace period and billing retry handling
Win-back and promotional offer management
Subscription status monitoring with Transaction.updates
Upgrade/downgrade path handling
Dashboard UI for subscription management

referral-system/

Referral and invite system with viral growth mechanics.

Unique code generation with fraud prevention
Deep link-based sharing and redemption
Reward tracking for referrer and invitee
Dashboard with referral statistics

watermark-engine/

Watermark overlays for images with paywall integration.

Text, image, and tiled watermark styles
CoreGraphics-based rendering with Retina support
Subscription-gated watermark removal
SwiftUI overlay and ViewModifier

streak-tracker/

Daily/weekly streak tracking with engagement mechanics.

SwiftData-based activity recording
Timezone-aware day boundary calculations
Streak freeze/protection passes
Calendar heat map and badge views
Streak-at-risk notifications

milestone-celebration/

Achievement celebrations with confetti and badges.

CAEmitterLayer confetti with Reduce Motion support
Milestone tracking with threshold detection
Badge collection grid with progress rings
Haptic feedback integration

whats-new/

What's New screen shown after app updates.

Version tracking with UserDefaults persistence
Paged TabView feature highlights
Local and remote content providers
Auto-present as sheet on version change

lapsed-user/

Lapsed user detection and re-engagement.

Configurable inactivity thresholds (7/14/30 days)
Personalized return experience by lapse category
Win-back offer screen for lapsed subscribers
ViewModifier for auto-detection on app launch

usage-insights/

User-facing usage statistics and activity summaries.

SwiftData event recording with batch writes
Insight calculation (streaks, top categories, trends)
Dashboard with Swift Charts integration
Shareable recap cards (Spotify Wrapped-style)

variable-rewards/

Variable reward system with gamification mechanics.

Weighted probability reward pools with rarity tiers
Daily spin wheel and mystery box animations
Daily/weekly caps for ethical engagement
Reward history and notification views

consent-flow/

GDPR/CCPA/DPDP privacy consent management.

Granular per-category consent (analytics, marketing, etc.)
ATT (App Tracking Transparency) integration
Consent audit logging for compliance
Banner and preferences UI with equal prominence

account-deletion/

Apple-compliant account deletion flow.

Multi-step confirmation with re-authentication
Data export before deletion
Grace period with cancellation option
Keychain cleanup and Sign in with Apple revocation

permission-priming/

Pre-permission priming screens for higher grant rates.

Unified permission manager (notifications, camera, location, etc.)
Benefit-focused priming UI before system prompt
Permission status tracking with Settings redirect
Gated content ViewModifier

force-update/

Minimum version enforcement with update prompts.

Remote JSON and App Store lookup version checking
Hard block (required) and soft prompt (recommended)
Configurable check frequency
Skip tracking for soft updates

state-restoration/

State preservation and restoration across app launches.

NavigationPath, tab selection, scroll position persistence
Codable AppState with debounced auto-save
Form draft manager with auto-save
@SceneStorage and file-based storage options

debug-menu/

Developer debug menu (DEBUG builds only).

Feature flag toggles and environment switcher
Network request logger with circular buffer
Cache clearing and diagnostic info export
Shake gesture and hidden tap triggers

offline-queue/

Offline operation queue with automatic retry.

Actor-based queue manager with FIFO + priority
File-based persistence for queued operations
Exponential backoff with jitter retry policy
NWPathMonitor connectivity detection
Offline status banner ViewModifier

feedback-form/

In-app feedback collection with smart routing.

Category-based feedback (bug, feature, praise)
Screenshot capture and annotation
Sentiment routing (happy → App Store, unhappy → support)
Email and webhook submission

announcement-banner/

In-app announcement banners with remote configuration.

Priority-based banner display (info, warning, promotion)
Local and remote announcement providers
Deep link and URL action handling
Scheduled display with date ranges

quick-win-session/

Guided first-action flows for fast time-to-value.

Step-by-step task guidance
Spotlight hint overlays with cutout circles
Completion celebration with timing stats
ViewModifier for new user detection

spotlight-indexing/

Core Spotlight indexing for system search integration.

SpotlightIndexable protocol for any model
Actor-based batch index manager
Fluent attribute builder API
Search continuation and Siri suggestions

app-clip/

App Clip target with invocation and upgrade flow.

Invocation URL parsing and routing
Experience protocol with concrete implementations
Location confirmation for physical invocations
SKOverlay full app upgrade prompt
App Group data sharing

screenshot-automation/

Automated App Store screenshot generation.

XCUITest-based screen capture with navigation
Localized caption overlays with CoreText
Device frame compositing
Multi-locale, multi-device batch export

background-processing/

Background task infrastructure with BGTaskScheduler.

BGAppRefreshTask and BGProcessingTask setup
Background URLSession for downloads/uploads
Silent push notification handling
Energy-efficient scheduling strategies

app-extensions/

App extension targets for Share, Action, Keyboard, and Safari.

Share Extension with content handling
Action Extension for in-place content manipulation
Keyboard Extension with UIInputViewController
Safari Web Extension with message handler
App Group data sharing between app and extension

data-export/

Data export/import infrastructure with JSON, CSV, and PDF support.

Protocol-based multi-format export (DataExportable)
CSV generation with RFC 4180 compliance
PDF report generation with UIGraphicsPDFRenderer
File import with UTType-based parsing
GDPR Article 20 data portability compliance

How to Use

User requests a component (e.g., "add logging to my app")
Read the relevant skill's SKILL.md
Run pre-generation checks (conflicts, deployment target, etc.)
Ask configuration questions via AskUserQuestion
Generate code from templates, adapting to project context
Provide integration instructions

Output Format

After generation, always provide:

Files created (with full paths)
Integration steps (how to wire into existing code)
Required capabilities (entitlements, dependencies)
Testing instructions (how to verify it works)