i

iOS Simulator Skill

21 production-ready scripts for iOS app testing, building, and automation with semantic UI navigation

Home/Developer Tools/iOS Simulator Skill

What is it?

Production-ready automation for iOS app testing and building with semantic UI navigation that survives design changes. Instead of fragile pixel-based navigation that breaks when UI changes, this skill uses iOS accessibility APIs to interact with elements by their meaning (text, type, or ID), not coordinates. Features 21 scripts optimized for both human developers and AI agents, providing comprehensive capabilities for building, testing, and automation.

How to use it?

The workflow follows a simple pattern:

  1. Environment Check - Run bash scripts/sim_health_check.sh to verify Xcode and simulator setup

  2. Launch Your App - Use python scripts/app_launcher.py --launch com.example.app to start your application in the simulator

  3. Navigate Semantically - Instead of fragile coordinates:

    • python scripts/screen_mapper.py to see what's on screen
    • python scripts/navigator.py --find-text "Login" --tap to interact by meaning
    • python scripts/navigator.py --find-type TextField --enter-text "user@test.com" to fill forms
  4. Test and Verify - Run accessibility audits, visual diffs, or capture app state for debugging

All scripts work immediately with zero configuration and provide token-efficient output (3-5 lines by default, with --verbose and --json options for detailed analysis).

Key Features

  • Semantic navigation - Find elements by text, type, or ID instead of brittle pixel coordinates
  • 21 production scripts - Complete toolkit for building, navigation, testing, and device lifecycle
  • Token-optimized output - 96% reduction vs raw tools, defaults to 3-5 lines per command
  • Accessibility-first design - Built on iOS accessibility APIs for robust, future-proof automation
  • Zero configuration - Works immediately on any macOS with Xcode, no setup files needed
  • WCAG compliance testing - Built-in accessibility audits for inclusive app development
  • Visual regression testing - Screenshot comparison to catch unexpected UI changes
  • CI/CD ready - JSON output, exit codes, and automated device lifecycle for continuous integration
View on GitHub

GitHub Stats

Stars
Forks
Last Update
License
MIT
Version
1.3.0

Features

💻 Code Execution