Includes design considerations specific to the platform — small display with large touch targets, glanceable information with minimal text, Digital Crown scrolling/input, swipe/tap gestures, and battery-conscious background work.
Best practices: keep information glanceable, use large tap targets, minimize text input, drive watch-face updates through complications, use efficient background refresh, and always validate on real hardware since the simulator behaves differently.
watchOS PlatformwatchOS-specific development for Apple Watch experiences.
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Analyze existing watchOS patterns
- fuse-ai-pilot:research-expert - Verify latest watchOS 27 docs via Context7/Exa
- mcp__apple-docs__search_apple_docs - Check watchOS patterns
After implementation, run fuse-ai-pilot:sniper for validation.
Overview
When to Use
- Building Apple Watch apps
- Creating watch face complications
- Workout and fitness tracking
- Health data access (HealthKit)
- iPhone-Watch communication
Why watchOS Skill
| Feature | Benefit |
|---|---|
| Complications | Glanceable data on watch face |
| Workouts | Fitness and health tracking |
| HealthKit | Access health metrics |
| Connectivity | Sync with iPhone |
Reference Guide
| Need | Reference |
|---|---|
| Watch face complications | complications.md |
| Workout sessions, HealthKit | workouts.md |
| iPhone ↔ Watch sync | watch-connectivity.md |
Design Considerations
Screen Size
- Small display; controls 44x44 pt default, 28x28 pt minimum
- Text: 16 pt default, 12 pt minimum; support enlargement to at least 140%
- Glanceable information, minimal text, clear icons
Source: https://developer.apple.com/design/human-interface-guidelines/accessibility
Interactions
- Digital Crown for scrolling/input (HIG)
- Gestures: swipe, tap
- Complications and Smart Stack are WidgetKit accessory widgets (see
swiftui-core/references/hig-system-surfaces.md)
Battery
- Minimize background work
- Use complications for updates
- Efficient data transfer
Best Practices
- Glanceable - Quick information access
- Large targets - Easy tapping
- Minimal input - Reduce typing
- Complications - Update watch face data
- Background refresh - Efficient updates
- Test on device - Simulator differs from hardware