relevancekit

What problem does it solve?

This Skill helps watchOS widget authors increase the chance their widget appears in the Apple Watch Smart Stack by providing precise, on-device contextual relevance clues so the system surfaces the right widget at the right time.

Core Features & Use Cases

• Relevance provider patterns: Implement AppIntentTimelineProvider.relevance() or RelevanceEntriesProvider to supply time, location, fitness, sleep, and hardware clues.
• Permission & preview guidance: Request location and HealthKit permissions in both the app and widget extension and handle context.isPreview and placeholder entries for reliable previews.
• Grouping, deduplication, and association: Use WidgetRelevanceGroup and .associatedKind(_:) to control grouping behavior and avoid duplicate Smart Stack cards.
• Use case: Surface meeting cards 15 minutes before start, show commute tools during an inferred commute, or surface media controls when headphones connect.

Quick Start

Add relevance clues to your widget by implementing relevance() to return ordered WidgetRelevance attributes and ensure required permissions are granted in both the app and widget extension.