widgets

Generate watchOS complications with WidgetKit timeline providers and accessory family views.

32|10|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/moasq/nanowave --skill widgets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: widgets
Source: https://github.com/moasq/nanowave/tree/main/internal/orchestration/skills/watchos/widgets
Command: npx skills add https://github.com/moasq/nanowave --skill widgets

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps implement glanceable information on Apple Watch faces using WidgetKit complications, ensuring users can quickly see key data without opening an app.

Core Features & Use Cases

  • Complication Implementation: Provides code for Timeline Providers and Complication Views across various watchOS complication families (.accessoryCircular, .accessoryRectangular, .accessoryInline, .accessoryCorner).
  • Watch Face Integration: Demonstrates how to define and bundle widgets for seamless integration with watchOS.
  • Use Case: You need to display the current step count or battery level directly on a user's watch face. This Skill provides the necessary structure and code examples to create such a complication.

Quick Start

Implement watchOS complications using WidgetKit by defining a TimelineProvider and Complication Views for different accessory families.

Frequently Asked Questions about widgets

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

FAQPage Schema
How do I create watchOS complications using WidgetKit for Apple Watch faces?

To create watchOS complications using WidgetKit, you define a TimelineProvider and Complication Views for various accessory families like circular, rectangular, and inline. This structure delivers glanceable data directly to the watch face.

What watchOS accessory families are supported when building WidgetKit complications?

WidgetKit complications support multiple accessory families including accessoryCircular, accessoryRectangular, accessoryInline, and accessoryCorner. Each family requires specific views to display glanceable data on watch faces.

How do I display app data like step count directly on an Apple Watch face?

You display app data on an Apple Watch face by implementing a WidgetKit complication. This involves creating a TimelineProvider to supply the data and configuring complication views for the desired accessory families.

What are the critical rules for container background and entry points in WidgetKit complications?

WidgetKit complications require strict adherence to critical rules for container background and @main entry points. Following these rules ensures your widgets bundle correctly and integrate seamlessly with watchOS.

Do I need a TimelineProvider to show glanceable information on watchOS widgets?

Yes, a TimelineProvider is required to show glanceable information on watchOS widgets. It supplies the timely data updates that allow your complication views to display current information on the watch face.

Can I use WidgetKit to build complications for multiple Apple Watch accessory families simultaneously?

Yes, you can build complications for multiple Apple Watch accessory families simultaneously using WidgetKit. You implement distinct views for each family, such as circular and inline, within your widget bundle.