claude-code-ios-dev-guide

🥈Silver

Claude Code CLI for iOS development. Automates Swift/SwiftUI workflows using PRD-driven processes, ultrathink, and planning modes. Connects to Xcode, GitHub, and CI/CD pipelines.

574310Updated Today

Intermediate30min to implementautomation

Saves ~60 min per use

Quick InstallView Source

git clone https://github.com/keskinonur/claude-code-ios-dev-guide.git

Works with:

Claude

Overview

About This Skill

Claude Code CLI for iOS development. Automates Swift/SwiftUI workflows using PRD-driven processes, ultrathink, and planning modes. Connects to Xcode, GitHub, and CI/CD pipelines.

How to Use

1. **Initialize Project Structure**: Run `claude-code init-ios-project --name [PROJECT_NAME] --target iOS17` to generate a standardized Xcode project with SwiftUI lifecycle and modern project structure. 2. **Generate PRD**: Use the prompt template to create a comprehensive feature specification before coding begins. Save as `PRD/[FEATURE_NAME].md` in your repo. 3. **Implement with Ultrathink**: Run `claude-code ultrathink --prd PRD/[FEATURE_NAME].md --output ./plans` to generate detailed implementation plans with modular breakdowns. 4. **Set Up CI/CD**: Use the generated GitHub Actions workflow by saving it to `.github/workflows/ios-ci-cd.yml` and configuring secrets in GitHub Settings > Secrets. 5. **Iterate with Planning Mode**: After each sprint, run `claude-code plan-next-iteration --last-prd PRD/[FEATURE_NAME].md --output ./plans/next-sprint.md` to plan upcoming work based on completed features. Tips: Always run `claude-code validate-xcode-project` before committing to catch common misconfigurations. Use `claude-code generate-swiftui-preview` to create interactive previews during development.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/keskinonur/claude-code-ios-dev-guide

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use claude-code to automate the iOS development workflow for [PROJECT_NAME]. Generate a PRD (Product Requirements Document) for [FEATURE_NAME] including user stories, technical constraints, and acceptance criteria. Then create a SwiftUI implementation plan with ultrathink mode, breaking down the feature into modular components with clear dependencies. Finally, generate GitHub Actions workflows for CI/CD that include unit testing, UI testing, and App Store Connect deployment steps. Reference [XCODE_VERSION] and [DEPLOYMENT_TARGET] in your planning.

Example Output

## PRD for Dark Mode Toggle Feature

**User Stories:**
- As a user, I want to toggle between light/dark mode so I can reduce eye strain in low light
- As a user, I want the setting to persist across app launches

**Technical Constraints:**
- Must support iOS 15+ (95% device coverage)
- Uses SwiftUI's native color scheme API
- Must pass accessibility contrast checks

**Acceptance Criteria:**
1. Toggle appears in Settings screen
2. System respects user preference
3. Changes apply immediately without restart
4. Unit tests cover all color scheme variations

## Implementation Plan (Ultrathink Mode)

**Phase 1: Core Infrastructure (Week 1)**
- Create `ColorSchemeManager.swift` singleton
- Implement `AppStorage` for persistence
- Build `ThemeView` protocol for view theming

**Phase 2: UI Components (Week 2)**
- Design `ToggleView` with SF Symbols
- Create `ThemePreview` for SwiftUI previews
- Implement `ColorSchemeViewModifier`

**Phase 3: Integration (Week 3)**
- Wire up to SettingsView
- Add haptic feedback
- Implement snapshot tests for all themes

## CI/CD Workflow (GitHub Actions)

```yaml
name: iOS CI/CD
on: [push, pull_request]
jobs:
  test:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Unit Tests
        run: xcodebuild test -scheme [SCHEME_NAME] -destination 'platform=iOS Simulator,name=iPhone 15'
      - name: Run UI Tests
        run: xcodebuild test -scheme [SCHEME_NAME] -destination 'platform=iOS Simulator,name=iPhone 15' -only-testing:UITests
  deploy:
    needs: test
    if: github.ref == 'refs/heads/main'
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - name: Archive
        run: xcodebuild archive -scheme [SCHEME_NAME] -archivePath ./build/[PROJECT_NAME].xcarchive
      - name: Export IPA
        run: xcodebuild -exportArchive -archivePath ./build/[PROJECT_NAME].xcarchive -exportOptionsPlist ExportOptions.plist -exportPath ./build
      - name: Upload to App Store Connect
        uses: apple-actions/upload-testflight-build@v1
        with:
          app-path: ./build/[PROJECT_NAME].ipa
          issuer-id: ${{ secrets.APPSTORE_ISSUER_ID }}
          api-key-id: ${{ secrets.APPSTORE_API_KEY_ID }}
          api-private-key: ${{ secrets.APPSTORE_API_PRIVATE_KEY }}
```

The implementation follows Apple's recommended SwiftUI architecture patterns with clear separation of concerns. All components are designed for testability with 100% mockable protocols. The CI/CD pipeline ensures every PR triggers comprehensive testing before deployment to TestFlight.