Run any Skill in Manus with one click

xcode-build

Stars0

Forks0

UpdatedJanuary 19, 2026 at 03:25

Xcode project management, building, and code generation for iOS/macOS development. Use when creating new projects, scaffolding SwiftUI views/models, building with xcodebuild, running tests, archiving apps, managing Swift packages, or setting up CI/CD. Covers project structure, build configurations, code signing, asset catalogs, and Info.plist configuration.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

jbcrane13

jbcrane13/swiftui-dev

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

21 files

SKILL.md

readonly

More from this repository

same repository

ui-verify

jbcrane13/swiftui-dev

This skill should be used when the user asks to "smoke test", "visually verify", "check the UI", "test the app", "verify the screen", "walk through the app", "screenshot walkthrough", or wants autonomous visual QA of an iOS simulator or macOS desktop application. Also appropriate when confirming a UI change looks correct after a code modification.

2026-03-140

appium-xcuitest

jbcrane13/swiftui-dev

iOS UI automation testing with Appium and XCUITest. Use when writing UI tests, creating page objects, locating elements by accessibility ID, implementing gestures, or setting up test automation infrastructure. Covers element location strategies, wait patterns, test organization, and CI/CD integration.

2026-01-190

cloudkit

jbcrane13/swiftui-dev

CloudKit integration for iCloud data sync, sharing, and subscriptions. Use when implementing iCloud data persistence, cross-device sync, collaborative data sharing, push notifications via CloudKit, or SwiftData+CloudKit integration. Covers database types, CRUD operations, error handling, and subscription configuration.

2026-01-190

ios-simulator

jbcrane13/swiftui-dev

iOS Simulator automation using xcrun simctl for app testing workflows. Use when booting/managing simulators, installing/launching apps, capturing screenshots/videos, simulating push notifications, setting location, triggering biometrics (Face ID/Touch ID), deep linking, resetting simulator state, or extracting app logs/containers. Designed for integration with Appium and XCUITest automation frameworks.

2026-01-190

modern-apple-dev

jbcrane13/swiftui-dev

Modern iOS 18+/macOS 15+ development standards using Swift 6, SwiftUI, SwiftData, and the Observation framework. Use when building or reviewing Swift applications, generating SwiftUI views, implementing data persistence, or architecting Apple platform apps. Enforces 2025/2026 best practices and rejects legacy patterns (ObservableObject, @Published, CoreData, @StateObject). Covers state management, concurrency, persistence, navigation, and testing.

2026-01-190

name	xcode-build
description	Xcode project management, building, and code generation for iOS/macOS development. Use when creating new projects, scaffolding SwiftUI views/models, building with xcodebuild, running tests, archiving apps, managing Swift packages, or setting up CI/CD. Covers project structure, build configurations, code signing, asset catalogs, and Info.plist configuration.

Xcode Build & Project Management

Project scaffolding, building, testing, and code generation for iOS 18+/macOS 15+ apps.

Scripts location: $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/

Project Scaffolding

Create New SwiftUI + SwiftData Project

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/new_project.py MyApp --bundle-id com.company.myapp
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/new_project.py MyApp --bundle-id com.company.myapp --team TEAMID123
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/new_project.py MyApp --bundle-id com.company.myapp --min-ios 18.0

Project Structure (Generated)

MyApp/
├── MyApp.xcodeproj/
├── MyApp/
│   ├── MyAppApp.swift          # @main entry point
│   ├── ContentView.swift       # Root view with accessibility ID
│   ├── Models/                 # SwiftData models
│   ├── Views/                  # SwiftUI views
│   ├── Services/               # Business logic
│   ├── Resources/
│   │   ├── Assets.xcassets/
│   │   └── Localizable.xcstrings
│   └── Info.plist
├── MyAppTests/
└── MyAppUITests/

Code Generation

Generate SwiftUI View

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_view.py LoginView --path ./MyApp/Views
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_view.py LoginView --path ./MyApp/Views --with-state  # Adds @Observable state
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_view.py ItemRow --path ./MyApp/Views --model Item    # View for model

Generated views include:

Screen-level accessibility identifier: .accessibilityIdentifier("screen_[name]")
@Observable view model if --with-state
Proper MARK comments for organization

Generate SwiftData Model

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_model.py Task --properties "title:String,isDone:Bool,dueDate:Date?"
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_model.py Task --properties "title:String" --path ./MyApp/Models

Generate Test Files

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_tests.py TaskTests --for Task --path ./MyAppTests
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_tests.py LoginViewUITests --ui --path ./MyAppUITests

Generate Observable State Class

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_state.py TaskListState --path ./MyApp/Views
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_state.py TaskListState --with-loading --with-error

Generated state classes include:

@Observable and @MainActor annotations
Proper async/await patterns
Error handling state

Building

Build for Simulator

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --simulator "iPhone 16 Pro"
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --simulator "iPhone 16 Pro" --config Debug

Build for Device

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --device
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --device --config Release

Clean Build

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --clean
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/clean.py                          # Clean all derived data
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/clean.py --project ./MyApp.xcodeproj

Testing

Run Unit Tests

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --simulator "iPhone 16 Pro"
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --filter "TaskTests"

Run UI Tests

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --ui-tests
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --ui-tests --simulator "iPhone 16 Pro"

Test with Coverage

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --coverage
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --coverage --output ./coverage.html

Archiving & Export

Create Archive

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/archive.py --scheme MyApp
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/archive.py --scheme MyApp --output ./build/MyApp.xcarchive

Export IPA

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/export.py --archive ./build/MyApp.xcarchive --method app-store
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/export.py --archive ./build/MyApp.xcarchive --method ad-hoc
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/export.py --archive ./build/MyApp.xcarchive --method development

Swift Package Manager

Add Dependency

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/spm.py add https://github.com/author/Package --version 1.0.0
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/spm.py add https://github.com/author/Package --branch main
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/spm.py add https://github.com/author/Package --from 2.0.0

List Dependencies

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/spm.py list
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/spm.py resolve   # Resolve and update Package.resolved

Create Swift Package

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/new_package.py MyLibrary --type library
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/new_package.py MyLibrary --type executable

Asset Management

Generate App Icon Set

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_appicon.py ./icon-1024.png --output ./MyApp/Resources/Assets.xcassets

Add Color Set

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/gen_color.py AccentColor --light "#007AFF" --dark "#0A84FF" \
    --output ./MyApp/Resources/Assets.xcassets

Common Workflows

Fresh Build & Test

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/clean.py
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --simulator "iPhone 16 Pro"
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/test.py --scheme MyApp --coverage

Release Build

python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/build.py --scheme MyApp --config Release --device
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/archive.py --scheme MyApp
python $CLAUDE_PLUGIN_ROOT/skills/xcode-build/scripts/export.py --archive ./build/MyApp.xcarchive --method app-store

Detailed References

xcodebuild Commands: See references/xcodebuild.md
Info.plist Keys: See references/info-plist.md
Code Signing: See references/code-signing.md
CI/CD Patterns: See references/ci-cd.md

Script Index

Script	Purpose
`new_project.py`	Create new SwiftUI+SwiftData project
`new_package.py`	Create Swift Package
`gen_view.py`	Generate SwiftUI view with identifiers
`gen_model.py`	Generate SwiftData @Model
`gen_state.py`	Generate @Observable state class
`gen_tests.py`	Generate unit/UI test file
`gen_appicon.py`	Generate app icon asset catalog
`gen_color.py`	Generate color set
`build.py`	Build project
`clean.py`	Clean derived data
`test.py`	Run tests
`archive.py`	Create xcarchive
`export.py`	Export IPA
`spm.py`	Manage Swift packages