apple-claude-ios

Files (38)

• SKILL.md
• SKILL.md · accessibility-audit/
• automated-audits.md · accessibility-audit/
• nutrition-labels.md · accessibility-audit/
• SKILL.md · app-planner/
• architecture-guide.md · app-planner/
• planning-checklist.md · app-planner/
• tech-stack-options.md · app-planner/
• SKILL.md · assistive-access/
• SKILL.md · coding-best-practices/
• architecture-patterns.md · coding-best-practices/
• coredata-patterns.md · coding-best-practices/
• swiftlint.yml · coding-best-practices/rules/
• swift-patterns.md · coding-best-practices/
• swiftui-patterns.md · coding-best-practices/
• SKILL.md · ipad-patterns/
• drag-drop.md · ipad-patterns/
• input-methods.md · ipad-patterns/
• multitasking.md · ipad-patterns/
• SKILL.md · migration-patterns/
• coredata-to-swiftdata.md · migration-patterns/
• objc-to-swift.md · migration-patterns/
• observable-migration.md · migration-patterns/
• storekit-migration.md · migration-patterns/
• uikit-to-swiftui.md · migration-patterns/
• xctest-to-swift-testing.md · migration-patterns/
• SKILL.md · navigation-patterns/
• navigation-split-view.md · navigation-patterns/
• navigation-stack.md · navigation-patterns/
• navigation-transitions.md · navigation-patterns/
• programmatic-navigation.md · navigation-patterns/
• tab-view.md · navigation-patterns/
• SKILL.md · run-device/
• SKILL.md · run-simulator/
• SKILL.md · ui-review/
• accessibility-quick-ref.md · ui-review/
• font-guidelines.md · ui-review/
• hig-checklist.md · ui-review/

SKILL.md (first lines)

# iOS Development Expert

Comprehensive guidance for iOS app development. This skill aggregates specialized modules for different aspects of iOS development.

## When This Skill Activates

Use this skill when the user:
- Asks about iOS development best practices
- Wants code review for iOS/Swift projects
- Needs UI/UX review against Human Interface Guidelines
- Wants accessibility audit for iOS apps
- Is planning a new iOS app
- Needs help with SwiftUI patterns for iOS
- Asks about navigation architecture (NavigationStack, NavigationSplitView, TabView)
- Wants to run/launch the app in the Simulator or screenshot it to verify a change

## Available Modules

Read relevant module files based on the user's needs:

### coding-best-practices/
Swift code quality and modern idioms for iOS.
- Modern Swift patterns and idioms
- Architecture patterns (MVVM, Clean Architecture)
- Code quality standards
- Performance optimization

### ui-review/
UI/UX review against Apple HIG.
- Human Interface Guidelines compliance
- Font usage and Dynamic Type support
- Accessibility review (VoiceOver, color contrast)
- SwiftUI best practices for iOS/watchOS

### accessibility-audit/
Structured accessibility audit workflow (advisory).
- Automated XCUITest audits (`performAccessibilityAudit`) + CI patterns
- Accessibility Inspector workflow
- Manual VoiceOver / Voice Control / Dynamic Type passes per common task
- App Store Accessibility Nutrition Label evaluation + declaration

### navigation-patterns/
SwiftUI navigation architecture patterns.
- NavigationStack, NavigationLink, navigationDestination
- NavigationSplitView (two/three column, iPad/macOS)
- TabView (iOS 18 customizable tabs, sidebar mode)
- Programmatic navigation (NavigationPath, pop-to-root, state restoration)
- Navigation transitions (zoom, custom animations)

### app-planner/
iOS app planning and analysis.
- New app concept to architecture
- Existing app audits
- Tech stack evaluation
- Product planning guidance

### run-simulator/
Build, install, launch, and screenshot the app in the Simulator to verify a
change visually (operational — uses Bash, not just guidance).
- Discover scheme + an available simulator (no hardcoded device names)
- Build for the simulator and resolve the `.app` + bundle id
- Boot, install, launch, then screenshot and read it back
- Drive navigation / deep links to reach the changed screen

### run-device/
Run an app on a physical iPhone/iPad from the CLI (no Xcode GUI).
- Build + code-sign for a device with `xcodebuild -allowProvisioningUpdates`
- Install and launch via `devicectl`
- Screenshot on hardware via `libimobiledevice`
- Device prerequisites (Developer Mode, pairing) and signing gotchas

## How to Use

1. Identify user's need from their question
2. Read relevant module files from subdirectories
3. Apply the guidance to their specific context
4. Reference Apple HIG documentation when needed

## Example Workflow

**User asks for UI review:**
1. Read `ui-review/SKILL.md` for the full review process
2. Check their SwiftUI code against HIG
3. Verify accessibility compliance
4. Report findings with specific recommendations

From abpaul/phxstack, MIT.

More from abpaul/phxstack