Skip to content

BumpyClock/agent-templates / skills/ios-macos-development

ios-macos-development

Flagged

Build, debug, or release iOS and macOS apps with Swift and Apple platform tools.

FileKindSize
SKILL.mdskill md2.1 KB
agents/openai.yamlconfig278 B
app-store-connect-cli/asc-app-create-ui/guide.mdmarkdown6.3 KB
app-store-connect-cli/asc-build-lifecycle/guide.mdmarkdown1.8 KB
app-store-connect-cli/asc-cli-usage/guide.mdmarkdown1.3 KB
app-store-connect-cli/asc-id-resolver/guide.mdmarkdown1.3 KB
app-store-connect-cli/asc-metadata-sync/guide.mdmarkdown4.5 KB
app-store-connect-cli/asc-notarization/guide.mdmarkdown7.2 KB
app-store-connect-cli/asc-ppp-pricing/guide.mdmarkdown4.4 KB
app-store-connect-cli/asc-release-flow/guide.mdmarkdown4.7 KB
app-store-connect-cli/asc-shots-pipeline/guide.mdmarkdown10.7 KB
app-store-connect-cli/asc-signing-setup/guide.mdmarkdown2.6 KB
app-store-connect-cli/asc-submission-health/guide.mdmarkdown6.9 KB
app-store-connect-cli/asc-subscription-localization/guide.mdmarkdown10.2 KB
app-store-connect-cli/asc-testflight-orchestration/guide.mdmarkdown1.7 KB
app-store-connect-cli/asc-workflow/guide.mdmarkdown5.3 KB
app-store-connect-cli/asc-xcode-build/guide.mdmarkdown3.7 KB
app-store-connect-cli/guide.mdmarkdown3.6 KB
instruments-profiling/guide.mdmarkdown3.7 KB
ios-app-intents/guide.mdmarkdown4.8 KB
ios-app-intents/references/code-templates.mdmarkdown7.4 KB
ios-app-intents/references/example-patterns.mdmarkdown3.6 KB
ios-app-intents/references/first-pass-checklist.mdmarkdown1.4 KB
ios-app-intents/references/system-surfaces.mdmarkdown1.0 KB
ios-debugger-agent/guide.mdmarkdown2.7 KB
ios-simulator/guide.mdmarkdown21.0 KB
ios-simulator/references/accessibility_checklist.mdmarkdown1.5 KB
ios-simulator/references/idb_quick.mdmarkdown1.1 KB
ios-simulator/references/simctl_quick.mdmarkdown1.3 KB
ios-simulator/references/test_patterns.mdmarkdown1.6 KB
ios-simulator/references/troubleshooting.mdmarkdown1.3 KB
ios-simulator/scripts/accessibility_audit.pyexecutablescript10.3 KB
ios-simulator/scripts/app_launcher.pyexecutablescript9.7 KB
ios-simulator/scripts/app_state_capture.pyexecutablescript13.2 KB
ios-simulator/scripts/appearance.pyscript11.3 KB
ios-simulator/scripts/build_and_test.pyexecutablescript11.3 KB
ios-simulator/scripts/clipboard.pyscript2.6 KB
ios-simulator/scripts/common/__init__.pyscript1.5 KB
ios-simulator/scripts/common/cache_utils.pyscript9.3 KB
ios-simulator/scripts/common/device_utils.pyscript13.5 KB
ios-simulator/scripts/common/env_config.pyscript1.1 KB
ios-simulator/scripts/common/hang_pipeline.pyscript29.6 KB
ios-simulator/scripts/common/hang_sessions.pyscript17.9 KB
ios-simulator/scripts/common/idb_utils.pyscript5.3 KB
ios-simulator/scripts/common/screenshot_utils.pyscript10.0 KB
ios-simulator/scripts/container.pyscript22.7 KB
ios-simulator/scripts/gesture.pyexecutablescript12.3 KB
ios-simulator/scripts/hang_watcher.pyscript56.5 KB
ios-simulator/scripts/keyboard.pyexecutablescript11.5 KB
ios-simulator/scripts/localization_audit.pyscript16.2 KB
ios-simulator/scripts/location.pyscript15.4 KB
ios-simulator/scripts/log_monitor.pyexecutablescript14.8 KB
ios-simulator/scripts/model_inspector.pyscript21.7 KB
ios-simulator/scripts/navigator.pyexecutablescript14.2 KB
ios-simulator/scripts/privacy_manager.pyscript8.7 KB
ios-simulator/scripts/push_notification.pyscript6.5 KB
ios-simulator/scripts/screen_mapper.pyexecutablescript10.7 KB
ios-simulator/scripts/sim_health_check.shscript8.1 KB
ios-simulator/scripts/sim_list.pyscript8.9 KB
ios-simulator/scripts/simctl_boot.pyexecutablescript9.1 KB
ios-simulator/scripts/simctl_create.pyexecutablescript8.9 KB
ios-simulator/scripts/simctl_delete.pyexecutablescript10.3 KB
ios-simulator/scripts/simctl_erase.pyexecutablescript10.2 KB
ios-simulator/scripts/simctl_shutdown.pyexecutablescript8.4 KB
ios-simulator/scripts/simulator_selector.pyexecutablescript10.3 KB
ios-simulator/scripts/status_bar.pyscript6.6 KB
ios-simulator/scripts/test_recorder.pyexecutablescript10.6 KB
ios-simulator/scripts/visual_diff.pyexecutablescript7.6 KB
ios-simulator/scripts/xcode/__init__.pyscript378 B
ios-simulator/scripts/xcode/builder.pyscript13.2 KB
ios-simulator/scripts/xcode/cache.pyscript5.5 KB
ios-simulator/scripts/xcode/config.pyscript5.4 KB
ios-simulator/scripts/xcode/reporter.pyscript10.7 KB
ios-simulator/scripts/xcode/xcresult.pyscript16.5 KB
native-app-performance/attribution.txtmarkdown349 B
native-app-performance/guide.mdmarkdown2.1 KB
native-app-performance/scripts/extract_time_samples.pyscript1.1 KB
native-app-performance/scripts/record_time_profiler.shscript1.3 KB
native-app-performance/scripts/top_hotspots.pyscript4.0 KB
swift-concurrency-expert/attribution.txtmarkdown353 B
swift-concurrency-expert/guide.mdmarkdown1.9 KB
swift-concurrency-expert/references/swift-6-2-concurrency.mdmarkdown4.3 KB
swift-concurrency-expert/references/swiftui-concurrency-tour-wwdc.mdmarkdown1.6 KB
swift-ui/guide.mdmarkdown1.0 KB
swift-ui/references/index.mdmarkdown4.2 KB
swift-ui/references/liquid-glass/appkit.mdmarkdown3.3 KB
swift-ui/references/liquid-glass/overview.mdmarkdown1.6 KB
swift-ui/references/liquid-glass/patterns.mdmarkdown3.9 KB
swift-ui/references/liquid-glass/swiftui.mdmarkdown4.0 KB
swift-ui/references/logging-private-fix.mdmarkdown8.0 KB
swift-ui/references/modern-swift.mdmarkdown2.9 KB
swift-ui/references/swift-concurrency.mdmarkdown39.6 KB
swift-ui/references/swift-testing-playbook.mdmarkdown35.3 KB
swift-ui/references/swiftui.mdmarkdown1.8 MB
swift-ui/references/toolbar/swiftui-features.mdmarkdown4.7 KB
swiftui-liquid-glass/attribution.txtmarkdown345 B
swiftui-liquid-glass/guide.mdmarkdown4.1 KB
swiftui-liquid-glass/references/liquid-glass.mdmarkdown8.0 KB
swiftui-performance-audit/attribution.txtmarkdown355 B
swiftui-performance-audit/guide.mdmarkdown1.7 KB
swiftui-performance-audit/references/code-smells.mdmarkdown4.8 KB
swiftui-performance-audit/references/demystify-swiftui-performance-wwdc23.mdmarkdown1.8 KB
swiftui-performance-audit/references/optimizing-swiftui-performance-instruments.mdmarkdown1.8 KB
swiftui-performance-audit/references/profiling-intake.mdmarkdown2.4 KB
swiftui-performance-audit/references/report-template.mdmarkdown1.2 KB
swiftui-performance-audit/references/understanding-hangs-in-your-app.mdmarkdown1.2 KB
swiftui-performance-audit/references/understanding-improving-swiftui-performance.mdmarkdown2.2 KB
swiftui-ui-patterns/guide.mdmarkdown2.0 KB
swiftui-ui-patterns/references/app-wiring.mdmarkdown6.5 KB
swiftui-ui-patterns/references/async-state.mdmarkdown3.5 KB
swiftui-ui-patterns/references/components-index.mdmarkdown4.2 KB
swiftui-ui-patterns/references/controls.mdmarkdown1.6 KB
swiftui-ui-patterns/references/deeplinks.mdmarkdown1.7 KB
swiftui-ui-patterns/references/focus.mdmarkdown2.3 KB
swiftui-ui-patterns/references/form.mdmarkdown3.0 KB
swiftui-ui-patterns/references/grids.mdmarkdown1.8 KB
swiftui-ui-patterns/references/haptics.mdmarkdown2.0 KB
swiftui-ui-patterns/references/input-toolbar.mdmarkdown1.4 KB
swiftui-ui-patterns/references/lightweight-clients.mdmarkdown2.5 KB
swiftui-ui-patterns/references/list.mdmarkdown2.7 KB
swiftui-ui-patterns/references/loading-placeholders.mdmarkdown1.2 KB
swiftui-ui-patterns/references/macos-settings.mdmarkdown2.0 KB
swiftui-ui-patterns/references/matched-transitions.mdmarkdown1.6 KB
swiftui-ui-patterns/references/media.mdmarkdown2.0 KB
swiftui-ui-patterns/references/menu-bar.mdmarkdown2.2 KB
swiftui-ui-patterns/references/navigationstack.mdmarkdown4.2 KB
swiftui-ui-patterns/references/overlay.mdmarkdown1.2 KB
swiftui-ui-patterns/references/performance.mdmarkdown1.9 KB
swiftui-ui-patterns/references/previews.mdmarkdown1.6 KB
swiftui-ui-patterns/references/scroll-reveal.mdmarkdown5.2 KB
swiftui-ui-patterns/references/scrollview.mdmarkdown2.3 KB
swiftui-ui-patterns/references/searchable.mdmarkdown1.7 KB
swiftui-ui-patterns/references/sheets.mdmarkdown4.3 KB
swiftui-ui-patterns/references/split-views.mdmarkdown2.0 KB
swiftui-ui-patterns/references/tabview.mdmarkdown3.4 KB
swiftui-ui-patterns/references/theming.mdmarkdown1.7 KB
swiftui-ui-patterns/references/title-menus.mdmarkdown2.1 KB
swiftui-ui-patterns/references/top-bar.mdmarkdown1.3 KB
swiftui-view-refactor/guide.mdmarkdown1.6 KB
swiftui-view-refactor/references/mv-patterns.mdmarkdown2.3 KB

ios-simulator/scripts/appearance.py

View on GitHub
#!/usr/bin/env python3
"""
iOS Simulator Appearance Manager

Control dark mode, dynamic type size, locale, and region.
Wraps xcrun simctl ui and defaults write for appearance testing.

Usage:
  python scripts/appearance.py --theme dark
  python scripts/appearance.py --text-size AX3
  python scripts/appearance.py --locale ar --region SA --bundle-id com.myapp
  python scripts/appearance.py --reset

RTL locales: ar, he, fa, ur, yi (app must restart to reflow layout).
"""

import argparse
import json
import subprocess
import sys

from common import resolve_udid

# === CONSTANTS ===

# Map friendly size aliases to xcrun simctl content_size tokens
TEXT_SIZE_MAP: dict[str, str] = {
    "XS": "extra-small",
    "S": "small",
    "M": "medium",
    "L": "large",
    "XL": "extra-large",
    "XXL": "extra-extra-large",
    "XXXL": "extra-extra-extra-large",
    "AX1": "accessibility-medium",
    "AX2": "accessibility-large",
    "AX3": "accessibility-extra-large",
    "AX4": "accessibility-extra-extra-large",
    "AX5": "accessibility-extra-extra-extra-large",
}

# Locales that require RTL layout direction
RTL_LOCALES: frozenset[str] = frozenset({"ar", "he", "fa", "ur", "yi"})

# Default appearance values used by --reset
DEFAULT_THEME = "light"
DEFAULT_TEXT_SIZE = "M"
DEFAULT_LOCALE = "en"
DEFAULT_REGION = "US"


# === APPEARANCE MANAGER ===


class AppearanceManager:
    """Manages iOS simulator appearance: theme, dynamic type, and locale."""

    def __init__(self, udid: str | None = None):
        """Initialize appearance manager.

        Args:
            udid: Optional device UDID (auto-detects booted simulator if None)
        """
        self.udid = udid

    # === PUBLIC API ===

    def set_theme(self, theme: str) -> tuple[bool, str]:
        """Switch simulator between light and dark appearance.

        Args:
            theme: 'light' or 'dark'

        Returns:
            (success, message)
        """
        cmd = ["xcrun", "simctl", "ui", self.udid, "appearance", theme]
        return self._run(cmd, f"Theme set: {theme}")

    def set_text_size(self, alias: str) -> tuple[bool, str]:
        """Set dynamic type content size.

        Args:
            alias: Friendly alias (XS, S, M, L, XL, XXL, XXXL, AX1-AX5)

        Returns:
            (success, message)
        """
        token = TEXT_SIZE_MAP.get(alias.upper())
        if not token:
            valid = ", ".join(TEXT_SIZE_MAP.keys())
            return False, f"Unknown text size '{alias}'. Valid: {valid}"

        cmd = ["xcrun", "simctl", "ui", self.udid, "content_size", token]
        return self._run(cmd, f"Text size set: {alias} ({token})")

    def set_locale(
        self,
        locale: str,
        region: str | None = None,
        bundle_id: str | None = None,
    ) -> tuple[bool, str]:
        """Write AppleLanguages and AppleLocale to simulator global defaults.

        Optionally restarts a specific app via bundle ID so the locale takes
        effect immediately. Without --bundle-id the change applies on next
        cold app launch.

        Args:
            locale: BCP-47 language code (e.g. 'en', 'ar', 'de')
            region: ISO 3166-1 alpha-2 region code (e.g. 'US', 'SA', 'IE')
            bundle_id: Optional app bundle ID — triggers terminate + launch

        Returns:
            (success, message)
        """
        apple_locale = f"{locale}_{region}" if region else locale

        # Write AppleLanguages array
        lang_cmd = [
            "xcrun",
            "simctl",
            "spawn",
            self.udid,
            "defaults",
            "write",
            "-g",
            "AppleLanguages",
            "-array",
            locale,
        ]
        ok, msg = self._run(lang_cmd, "")
        if not ok:
            return False, f"Failed to write AppleLanguages: {msg}"

        # Write AppleLocale string
        locale_cmd = [
            "xcrun",
            "simctl",
            "spawn",
            self.udid,
            "defaults",
            "write",
            "-g",
            "AppleLocale",
            "-string",
            apple_locale,
        ]
        ok, msg = self._run(locale_cmd, "")
        if not ok:
            return False, f"Failed to write AppleLocale: {msg}"

        is_rtl = locale in RTL_LOCALES
        rtl_note = " [RTL layout]" if is_rtl else ""
        summary = f"Locale set: {apple_locale}{rtl_note}"

        if bundle_id:
            restart_ok, restart_msg = self._restart_app(bundle_id)
            if restart_ok:
                summary += f" — app restarted: {bundle_id}"
            else:
                summary += f" — locale written but app restart failed: {restart_msg}"
        else:
            summary += " — restart app to apply"

        return True, summary

    def reset(self) -> tuple[bool, str]:
        """Reset theme, text size, and locale to system defaults.

        Returns:
            (success, message)
        """
        results: list[str] = []
        errors: list[str] = []

        ok, msg = self.set_theme(DEFAULT_THEME)
        (results if ok else errors).append(msg)

        ok, msg = self.set_text_size(DEFAULT_TEXT_SIZE)
        (results if ok else errors).append(msg)

        ok, msg = self.set_locale(DEFAULT_LOCALE, DEFAULT_REGION)
        (results if ok else errors).append(msg)

        if errors:
            return False, f"Reset partial — errors: {'; '.join(errors)}"

        return True, "Appearance reset to defaults (light / M / en_US)"

    # === PRIVATE HELPERS ===

    def _run(self, cmd: list[str], success_message: str) -> tuple[bool, str]:
        """Run subprocess command and return (success, message).

        Args:
            cmd: Command list (never shell=True)
            success_message: Human-readable success summary

        Returns:
            (success, message)
        """
        try:
            subprocess.run(
                cmd,
                capture_output=True,
                text=True,
                check=True,
            )
            return True, success_message
        except subprocess.CalledProcessError as error:
            stderr = error.stderr.strip() if error.stderr else "unknown error"
            return False, stderr

    def _restart_app(self, bundle_id: str) -> tuple[bool, str]:
        """Terminate then launch an app by bundle ID.

        Args:
            bundle_id: App bundle ID

        Returns:
            (success, message)
        """
        terminate_cmd = ["xcrun", "simctl", "terminate", self.udid, bundle_id]
        # Terminate may fail if app is not running — that is acceptable
        subprocess.run(terminate_cmd, capture_output=True, check=False)

        launch_cmd = ["xcrun", "simctl", "launch", self.udid, bundle_id]
        try:
            subprocess.run(launch_cmd, capture_output=True, text=True, check=True)
            return True, f"Launched {bundle_id}"
        except subprocess.CalledProcessError as error:
            stderr = error.stderr.strip() if error.stderr else "launch failed"
            return False, stderr


# === CLI ===


def main() -> None:
    """Main entry point."""
    parser = argparse.ArgumentParser(
        description=(
            "iOS Simulator Appearance Manager — control dark mode, "
            "dynamic type, locale, and region."
        ),
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
Examples:
  python scripts/appearance.py --theme dark
  python scripts/appearance.py --text-size AX3
  python scripts/appearance.py --locale ar --region SA
  python scripts/appearance.py --locale de --region DE --bundle-id com.myapp
  python scripts/appearance.py --reset

RTL locales (ar, he, fa, ur, yi): app must restart to reflow layout.
Text sizes: XS S M L XL XXL XXXL AX1 AX2 AX3 AX4 AX5
        """,
    )

    parser.add_argument(
        "--theme",
        choices=["light", "dark"],
        help="Set light or dark appearance",
    )
    parser.add_argument(
        "--text-size",
        choices=list(TEXT_SIZE_MAP.keys()),
        metavar="{" + ",".join(TEXT_SIZE_MAP.keys()) + "}",
        help="Set dynamic type size (XS smallest, AX5 largest)",
    )
    parser.add_argument(
        "--locale",
        metavar="CODE",
        help="Set locale language code (e.g. en, de, ar, ja)",
    )
    parser.add_argument(
        "--region",
        metavar="CODE",
        help="Set region code (e.g. US, IE, SA). Used with --locale.",
    )
    parser.add_argument(
        "--bundle-id",
        metavar="BUNDLE_ID",
        help="App bundle ID to terminate+relaunch after locale change",
    )
    parser.add_argument(
        "--reset",
        action="store_true",
        help="Reset theme, text size, and locale to system defaults",
    )
    parser.add_argument(
        "--udid",
        help="Device UDID (auto-detects booted simulator if not provided)",
    )
    parser.add_argument(
        "--json",
        action="store_true",
        help="Output results as JSON",
    )
    parser.add_argument(
        "--verbose",
        action="store_true",
        help="Show detailed output",
    )

    args = parser.parse_args()

    # Guard: require at least one action
    if not any([args.theme, args.text_size, args.locale, args.reset]):
        parser.print_help()
        sys.exit(1)

    # Guard: --reset is incompatible with explicit appearance flags
    if args.reset and any([args.theme, args.text_size, args.locale]):
        print(
            "Error: --reset cannot be combined with --theme, --text-size, or --locale",
            file=sys.stderr,
        )
        sys.exit(1)

    # Guard: --region without --locale is a no-op
    if args.region and not args.locale:
        print("Error: --region requires --locale", file=sys.stderr)
        sys.exit(1)

    # Guard: --bundle-id without --locale is ambiguous
    if args.bundle_id and not args.locale:
        print("Error: --bundle-id requires --locale", file=sys.stderr)
        sys.exit(1)

    try:
        udid = resolve_udid(args.udid)
    except RuntimeError as error:
        print(f"Error: {error}", file=sys.stderr)
        sys.exit(1)

    manager = AppearanceManager(udid=udid)
    device_label = udid if udid else "booted"

    # Collect all requested operations
    operations: list[tuple[str, tuple[bool, str]]] = []

    if args.reset:
        operations.append(("reset", manager.reset()))
    else:
        if args.theme:
            operations.append(("theme", manager.set_theme(args.theme)))

        if args.text_size:
            operations.append(("text_size", manager.set_text_size(args.text_size)))

        if args.locale:
            operations.append(
                (
                    "locale",
                    manager.set_locale(args.locale, args.region, args.bundle_id),
                )
            )

    overall_success = all(ok for _, (ok, _) in operations)

    if args.json:
        results = {action: {"success": ok, "message": msg} for action, (ok, msg) in operations}
        payload = {
            "success": overall_success,
            "udid": device_label,
            "results": results,
        }
        print(json.dumps(payload))
    elif args.verbose:
        print(f"Device: {device_label}")
        for action, (ok, msg) in operations:
            status = "OK" if ok else "FAIL"
            print(f"  [{status}] {action}: {msg}")
    else:
        for _, (_ok, msg) in operations:
            if msg:
                print(msg)

    sys.exit(0 if overall_success else 1)


if __name__ == "__main__":
    main()
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 318kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 318kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 318kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall