flutter-improving-accessibility

Installation
Summary

Configure Flutter apps for assistive technologies including screen readers and keyboard navigation.

  • Covers UI design fundamentals: font scaling, color contrast (4.5:1 for normal text, 3:1 for large), and 48x48 pixel minimum tap targets
  • Provides semantic annotation patterns using Semantics, MergeSemantics, and ExcludeSemantics widgets to expose widget tree structure to assistive tools
  • Includes web-specific guidance on enabling the semantics layer (disabled by default for performance) and mapping custom components to ARIA roles
  • Offers a compliance checklist and validation feedback loop for testing with screen readers like VoiceOver and TalkBack
SKILL.md

Implementing Flutter Accessibility

Contents

UI Design and Styling

Design layouts to accommodate dynamic scaling and high visibility. Flutter automatically calculates font sizes based on OS-level accessibility settings.

  • Font Scaling: Ensure layouts provide sufficient room to render all contents when font sizes are increased to their maximum OS settings. Avoid hardcoding fixed heights on text containers.
  • Color Contrast: Maintain a contrast ratio of at least 4.5:1 for small text and 3.0:1 for large text (18pt+ regular or 14pt+ bold) to meet W3C standards.
  • Tap Targets: Enforce a minimum tap target size of 48x48 logical pixels to accommodate users with limited dexterity.

Accessibility Widgets

Utilize Flutter's catalog of accessibility widgets to manipulate the semantics tree exposed to assistive technologies (like TalkBack or VoiceOver).

Related skills
Installs
8.4K
Repository
flutter/skills
GitHub Stars
1.9K
First Seen
Mar 13, 2026