swiftui-macos-accessibility

Implement VoiceOver, keyboard navigation, and Dynamic Type accessibility in macOS SwiftUI apps.

1|Updated Jun 5, 2026
One-click install
npx skills add https://github.com/LaughingJackalope/macos-skills --skill swiftui-macos-accessibility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swiftui-macos-accessibility
Source: https://github.com/LaughingJackalope/macos-skills/tree/main/swiftui-macos-accessibility
Command: npx skills add https://github.com/LaughingJackalope/macos-skills --skill swiftui-macos-accessibility

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the critical problem of macOS SwiftUI apps excluding users with disabilities due to missing or incorrect accessibility implementation, ensuring your app works for VoiceOver users, keyboard-only navigators, and users with Dynamic Type preferences.

Core Features & Use Cases

  • macOS-Specific VoiceOver Guidance: Covers keyboard-driven VoiceOver navigation, rotor differences from iOS, Quick Nav, and custom rotor implementation for macOS 26+.
  • SwiftUI Accessibility Modifiers: Teaches proper use of accessibility labels, values, actions, AXCustomContent, and child element management for custom controls.
  • Full Keyboard Access & Focus Management: Provides patterns for implementing tab navigation, custom focus order, and focus state binding for keyboard-only users.
  • Audit & Testing Workflows: Includes step-by-step guidance for using Accessibility Inspector, running VoiceOver tests, and validating Dynamic Type scaling.
  • Use Case: A developer building a macOS file browser can use this Skill to add VoiceOver labels for file rows, custom AXCustomContent for file size and creation date, full keyboard tab navigation, and pass Accessibility Inspector audits to meet App Store accessibility requirements.

Quick Start

Use the swiftui-macos-accessibility skill to add VoiceOver support, full keyboard navigation, and Dynamic Type scaling to your macOS SwiftUI app's main interface.

Frequently Asked Questions about swiftui-macos-accessibility

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

FAQPage Schema
How do I add VoiceOver support to a macOS SwiftUI application?

SwiftUI macOS accessibility implementation involves applying accessibility labels, values, and actions to interface elements. It ensures VoiceOver integration, custom accessibility content, and proper accessibility tree construction for custom controls.

What is the best way to implement full keyboard access and focus management in SwiftUI for macOS?

Full keyboard access in macOS SwiftUI requires implementing patterns for tab navigation, custom focus order, and focus state binding. This ensures keyboard-only navigators can interact with all interface elements compliantly.

Does macOS SwiftUI support custom accessibility content like AXCustomContent for VoiceOver?

Yes, macOS SwiftUI supports AXCustomContent for custom accessibility information. You can apply accessibility modifiers to include custom details like file size and creation dates for VoiceOver users navigating custom controls.

How do I audit a SwiftUI macOS app using Accessibility Inspector for Dynamic Type and compliance?

To audit a SwiftUI macOS app, run Accessibility Inspector audits and VoiceOver tests to validate Dynamic Type scaling. This verifies compliance with macOS Human Interface Guidelines accessibility requirements before App Store submission.

Can I use SwiftUI accessibility modifiers for macOS 26+ Human Interface Guidelines compliance?

Yes, SwiftUI accessibility modifiers enable macOS 26+ Human Interface Guidelines compliance. They handle VoiceOver integration, keyboard navigation, and Dynamic Type support to satisfy App Store accessibility requirements for SwiftUI applications.