maui-accessibility

Audit .NET MAUI apps and implement screen reader support with SemanticProperties and AutomationProperties.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-accessibility-mkazimoto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-accessibility
Source: https://github.com/mkazimoto/AppMAUICopilot/tree/main/.github/skills/maui-accessibility
Command: npx skills add https://github.com/mkazimoto/AppMAUICopilot --skill maui-accessibility-mkazimoto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensure MAUI apps are accessible to all users by guiding developers to implement screen reader support using SemanticProperties, AutomationProperties, and platform-aware patterns across views, labels, images, and dynamic content.

Core Features & Use Cases

  • Apply SemanticProperties and AutomationProperties on VisualElements to improve screen reader narration.
  • Manage focus programmatically and broadcast live announcements to communicate UI changes.
  • Follow platform-specific guidance for TalkBack, VoiceOver, and Narrator, and perform regular accessibility audits of MAUI pages.

Quick Start

Audit a MAUI page for accessibility and implement semantic and automation properties to support screen readers.

Frequently Asked Questions about maui-accessibility

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add screen reader support to .NET MAUI controls?

Add screen reader support to .NET MAUI controls by attaching SemanticProperties and AutomationProperties to VisualElements. This enables TalkBack, VoiceOver, and Narrator to narrate UI elements correctly across platforms.

What is the difference between SemanticProperties and AutomationProperties in MAUI?

SemanticProperties provide cross-platform descriptions for screen readers, while AutomationProperties offer platform-specific automation hooks. Both manage accessibility narration, but SemanticProperties target unified behavior across Android, iOS, Windows, and macOS.

How do I manage focus order for accessible MAUI interfaces?

Manage accessible focus order in MAUI by setting SemanticProperties on VisualElements and using programmatic focus management. This ensures screen readers traverse UI elements in a logical, visible sequence across all platforms.

Can I broadcast live announcements for dynamic content changes in MAUI?

Broadcast live announcements in MAUI to communicate dynamic UI changes to screen readers. This satisfies accessibility requirements by alerting users to content updates without requiring manual focus shifts.

How do I handle decorative vs informative images for MAUI accessibility?

Handle decorative images by excluding them from the screen reader focus order, and label informative images using SemanticProperties. Correctly distinguishing them prevents TalkBack and VoiceOver from narrating unnecessary visual elements.

What are common platform-specific accessibility pitfalls in MAUI?

Common MAUI accessibility pitfalls include inconsistent focus handling and narration differences between TalkBack, VoiceOver, and Narrator. The skill audits pages to identify and resolve these platform-specific semantic property issues.