iOS Accessibility

Based on Appt Docs and CVS SwiftUI Accessibility.

Core Principles

1. Semantic over custom — Use standard UIKit/SwiftUI controls. They come with accessibility built in.
2. Label everything that matters — Every interactive element and meaningful image needs an accessibilityLabel.
3. Expose the right role and state — Use traits to communicate what an element is and what state it's in.
4. Respect user preferences — Dynamic Type, Reduce Motion, Dark Mode, Bold Text, and increased contrast are signals from the user, not optional polish.
5. Test with VoiceOver — Turn it on and use your app without looking. If you can't complete the main flows, something needs fixing.

VoiceOver: Core Attributes

Label and Hint

The label is what VoiceOver announces when the element is focused. The hint explains what happens when you activate it. Keep labels concise and hints optional — only add a hint when the outcome isn't obvious from the label.