Accessibility on watchOS
Support for the three assistive technologies that ship on Apple Watch — VoiceOver, AssistiveTouch (watchOS 8+), and Double Tap (watchOS 11+) — plus Dynamic Type at the large accessibility sizes introduced in watchOS 8. The rest of the axiom-accessibility suite covers cross-platform fundamentals; this skill adds what's specific to watchOS.
When to Use
Use this skill when:
- You're auditing a watchOS app for VoiceOver, AssistiveTouch, or Double Tap support
- You're implementing Dynamic Type on watch faces, watch UI, complications, or notifications
- You're making a custom watch control (counter, scrubber, picker) VoiceOver-adjustable
- AssistiveTouch cursor frames clip icons or miss tappable elements
- You're supporting watchOS 8's large accessibility text sizes
- You need to debug why an element isn't focusable via AssistiveTouch
- Your complications and dynamic notifications need spoken-form accessibility labels
Example Prompts
Questions you can ask your assistant that will draw from this skill:
- "How do I make a custom stepper VoiceOver-adjustable on watchOS?"
- "AssistiveTouch isn't focusing the text inside my tappable VStack — why?"
- "How should I bind Double Tap to my workout's Start button?"
- "What needs to change in my watch UI to support accessibility5 text size?"
- "My complication reads 'Wed Mar 9' to VoiceOver — how do I get a spoken form?"
- "Why is the AssistiveTouch cursor clipping my ellipsis icon?"
What This Skill Provides
- Three assistive technologies – How VoiceOver, AssistiveTouch, and Double Tap differ in input model and SwiftUI API, and why your design must work with any combination enabled
- Three Dynamic Type rules – Use a text style instead of
Font.system(size:); let text wrap rather than cappinglineLimitat 1; switch to a vertical layout at large sizes by reading@Environment(\.dynamicTypeSize) - Complication and notification coverage – Spoken-form labels for abbreviations, labels on complication images, overrides for SF Symbol default labels, and accessibility on dynamic notifications
- VoiceOver patterns – Let
NavigationLinkcombine row children, put context in the label (not just the value), and add an explicitaccessibilityLabelto symbol-only buttons - Custom adjustable control recipe – Collapse multi-button steppers into one element with
accessibilityElement()+accessibilityLabel+accessibilityValue+accessibilityAdjustableAction - AssistiveTouch support – Focusable-element rules (the "tappable
VStackwith non-interactiveText" trap),accessibilityRespondsToUserInteraction(true), 44×44pt cursor frames viacontentShape, and the action menu thataccessibilityActionpopulates - Double Tap rules – Bind with
handGestureShortcut(.primaryAction), keep exactly one primary action per screen, and treat Double Tap as an accelerator, never the only path - Testing checklist – Eight concrete verification steps covering VoiceOver, Dynamic Type, custom controls, AssistiveTouch cursor, Double Tap, complications, and notifications
- Common mistakes table – Eleven mistakes, each with its symptom and fix
Documentation Scope
This page documents the watchos-a11y skill in the axiom-accessibility suite. The skill file contains comprehensive guidance your assistant uses when answering your questions, including code for each pattern, the testing checklist, and the common-mistakes table.
Related
- accessibility-diag – Cross-platform VoiceOver, Dynamic Type, contrast, and WCAG fundamentals; this skill adds the watchOS layer
- ux-flow-audit – Its Accessibility Dead Ends category finds actions that only gestures or visual cues can reach, invisible to assistive technology
- design-for-watchos – The watchOS 10 navigation model and Always On design
- smart-stack-and-complications – The complication surfaces that need spoken-form accessibility labels
- controls-and-live-activities – Control surfaces and the Double Tap primary-action binding
Resources
WWDC: 2021-10223, 2021-10308, 2024-10205
Docs: /watchos-apps/create-accessible-experiences-for-watchos, /swiftui/environmentvalues/sizecategory, /swiftui/view/accessibilityadjustableaction(😃, /swiftui/view/accessibilityrespondstouserinteraction(😃, /swiftui/view/handgestureshortcut(_:isenabled:)
Skills: axiom-accessibility, axiom-watchos