ui-test

ui-test

XCUITest UI testing toolkit for Swift/SwiftUI apps. Covers the full lifecycle: auditing accessibility identifiers, generating UI test suites, and enforcing conventions.

Commands

Command	Description
/ui-test:check-ids	Audit accessibility identifiers — find missing, malformed, and non-standard IDs across all views
/ui-test:coverage	Full UI test coverage — audit IDs, map screens to interactions, generate XCUITest files

What's Included

• Scripts — Bash/Python tools for scanning identifiers, generating reports, and stubbing missing IDs
• Skills — XCUITest patterns, anti-patterns, and architecture guidance
• References — ID naming convention spec, test architecture guide
• Hooks — PostToolUse nudge when view files are created/modified without accessibility IDs

ID Naming Convention

{screen}_{type}_{descriptor}

Component	Examples
screen	dashboard, settings, tools, deviceDetail, speedTest
type	button, toggle, picker, textfield, stepper, link, card, row, label, list, nav, tab, section, image, scroll
descriptor	refresh, clearHistory, pingCount, bonjour, darkMode

Full examples: tools_card_speedTest, dashboard_button_refresh, settings_toggle_darkMode, screen_dashboard

Screen-Level Identifiers

Every screen/page root view should have: screen_{screenName} (e.g., screen_dashboard, screen_settings, screen_speedTest).

Installation

Already installed at ~/.claude/plugins/ui-test/. Claude Code picks it up automatically.