maui-accessibility

Add screen reader accessibility to .NET MAUI applications using semantic and automation properties.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-accessibility-seydakaratekeli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maui-accessibility
Source: https://github.com/seydakaratekeli/KamPay3/tree/main/KamPay/.github/skills/maui-accessibility%20-%20Kopyala
Command: npx skills add https://github.com/seydakaratekeli/KamPay3 --skill maui-accessibility-seydakaratekeli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides clear, platform-aware guidance for making .NET MAUI applications accessible to screen readers and assistive technologies, preventing common mistakes that break TalkBack, VoiceOver, or Narrator behavior and improving usability for people who rely on accessibility tools.

Core Features & Use Cases

  • Semantic guidance: How and when to apply SemanticProperties for names, hints, and heading levels to UI elements.
  • Platform gotchas: Concrete warnings about Description on Labels, Entries, and container layouts that cause platform-specific failures.
  • AutomationProperties & dynamic content: Advice on hiding decorative elements, grouping behavior, and using programmatic focus and announcements for status updates.
  • Use case: Retrofitting a form-heavy MAUI app to be screen-reader compatible across Android, iOS, macOS, and Windows.

Quick Start

Add screen reader support to my .NET MAUI page by applying SemanticProperties to meaningful images and controls, using Placeholder instead of Description on entries, marking headings with heading levels, hiding decorative elements with AutomationProperties, and invoking SemanticScreenReader.Announce and SetSemanticFocus for dynamic updates.

Frequently Asked Questions about maui-accessibility

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

FAQPage Schema
How do I make .NET MAUI apps screen-reader friendly across Android and iOS?

Make .NET MAUI apps screen-reader friendly by applying SemanticProperties for names, hints, and heading levels, and use AutomationProperties to hide decorative elements, ensuring TalkBack and VoiceOver correctly announce controls across platforms.

Why does setting Description on Labels break TalkBack and VoiceOver in MAUI?

Setting Description on Labels and Entries causes platform-specific screen-reader failures in .NET MAUI. Use Placeholder text for Entries and apply SemanticProperties instead to prevent TalkBack and VoiceOver reading issues without breaking assistive technology behavior.

How do I announce dynamic content updates to a screen reader in .NET MAUI?

Announce dynamic content updates in .NET MAUI by invoking SemanticScreenReader.Announce for status updates and SetSemanticFocus for programmatic focus, ensuring screen readers immediately notify users of changing information without requiring manual navigation.

When should I use AutomationProperties to hide decorative images in MAUI?

Use AutomationProperties to hide decorative images and elements in .NET MAUI when they do not convey meaningful information, preventing screen readers from cluttering the navigation experience with unnecessary visual details for assistive technology users.

Does .NET MAUI SemanticProperties support heading levels for screen readers?

.NET MAUI SemanticProperties supports heading levels for screen readers, allowing developers to mark UI elements as headings so that VoiceOver, TalkBack, and Narrator users can navigate complex forms and page structures efficiently by skipping to sections.

What is the best way to group form controls for TalkBack in a MAUI app?

The best way to group form controls for TalkBack in a MAUI app is to apply SemanticProperties correctly to container layouts, ensuring related fields are announced together while avoiding Description on container layouts that cause platform-specific accessibility failures.