# Accessibility Analysis

AutoMobile's accessibility analysis capabilties can be turned on via [feature flags](../design-docs/mcp/feature-flags.md). This instantly adds inspection and reporting to all functions, and therefore all AutoMobile tests when run with this enabled. It does add some extra compute overhead that scales with UI complexity, but our benchmarks show this is negligible (<1ms). AutoMobile makes a best effort to correctly inspect mobile user experiences according to these standards.

Reuse prompts from [exploring an app](ux-exploration.md) with an addition to pay attention to accessibility results.

## Standards

AutoMobile follows the guidelines from WCAG 2.1 Level AA/AAA and Material Design to provide its recommendations and checks. For now it has checks for contrast and tap targets and we have plans to implement more.

Note: I'm happy to add Apple design guidelines if someone can point me to the right documentation.

### Contrast

- **Normal Text**: Minimum 4.5:1 contrast ratio (AA), 7:1 (AAA)
- **Large Text**: Minimum 3:1 contrast ratio (AA), 4.5:1 (AAA)
- **UI Components**: Minimum 3:1 contrast ratio

Large text is defined as:

- 18pt (24px) or larger
- 14pt (18.5px) bold or larger

### Tap Targets

Ensure interactive elements meet minimum size requirements for accessibility.

- WCAG 2.1 compliance
  - 44x44 dp minimum
- Material Design compliance:
  - 48x48 dp minimum size
  - 8dp spacing between tap targets

## Resources

- [WCAG 2.1 Contrast Guidelines](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html)
- [WCAG 2.1 Target Size](https://www.w3.org/WAI/WCAG21/Understanding/target-size.html)
- [Material Design Principles](https://m3.material.io/foundations/overview/principles)
- [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/)
