SwiftUI Dev Plugin for Claude Code
Comprehensive iOS 18+/macOS 15+ development toolkit enforcing modern Swift 6 patterns, SwiftUI best practices, and professional development workflows.
Overview
This plugin provides:
- Modern Swift 6 enforcement - Rejects legacy patterns (ObservableObject, @Published, CoreData)
- SwiftUI best practices - @Observable, SwiftData, NavigationStack patterns
- Liquid Glass support - iOS 26+ glass design system guidance
- Xcode automation - Project scaffolding, builds, tests, archives
- Simulator control - Screenshots, video, push notifications, biometrics
- Test automation - Appium/XCUITest integration with Page Object pattern
- CloudKit integration - iCloud sync, sharing, subscriptions
- Accessibility compliance - Enforced identifier patterns for UI testing
Installation
From Local Directory
claude plugins:install /Users/blake/Projects/swiftui-dev
Enable the Plugin
claude plugins:enable swiftui-dev
Components
Commands (8)
| Command | Description |
|---|
/new-app | Create new SwiftUI + SwiftData project with modern architecture |
/design | Generate UI/UX designs from requirements |
/plan | Create phased implementation plan from requirements and design |
/audit | Comprehensive code quality audit (patterns, accessibility, architecture) |
/build | Build project with xcodebuild |
/test | Run unit and UI tests with coverage |
/screenshot | Capture simulator screenshots with status bar overrides |
/simulator | Manage iOS Simulators (boot, reset, install, launch) |
Agents (7)
| Agent | Purpose |
|---|
liquid-glass-expert | iOS 26+ Liquid Glass design system specialist |
project-architect | Application architecture and module organization |
architect-review | SOLID principles and layer separation validation |
swiftdata-expert | SwiftData modeling, relationships, and @Query optimization |
cloudkit-expert | iCloud sync, CKShare, subscriptions, conflict resolution |
swiftui-ux-designer | Requirements-to-design transformation |
mobile-code-implementer | Design-to-code implementation |
Skills (5)
| Skill | Auto-Activates When |
|---|
modern-apple-dev | Working with Swift files, SwiftUI views, state management |
xcode-build | Creating projects, scaffolding, building, testing |
ios-simulator | Managing simulators, screenshots, push notifications |
appium-xcuitest | Writing UI tests, creating page objects |
cloudkit | Implementing iCloud sync, sharing, subscriptions |
Hooks
- PreToolUse - Checks Swift files for legacy patterns before writing
- PostToolUse - Validates accessibility identifiers after writing SwiftUI views
Quick Start
Create a New Project
/new-app MyApp --bundle-id com.company.myapp
Design from Requirements
/design requirements.md
Create Implementation Plan
/plan requirements.md design.md
Build and Test
/build --scheme MyApp --simulator "iPhone 16 Pro"
/test --scheme MyApp --coverage
Capture Screenshots
/screenshot "iPhone 16 Pro" --time "9:41" --battery 100
Enforced Standards
Legacy Pattern Rejection
The plugin enforces modern iOS 18+/Swift 6 patterns:
| Legacy Pattern | Modern Replacement |
|---|
ObservableObject | @Observable |
@Published | Properties auto-observed |
@StateObject | @State |
CoreData | SwiftData |
DispatchQueue.main.async | async/await |
NavigationView | NavigationStack |
Accessibility Identifiers
All interactive UI elements must have identifiers:
// Pattern: {screen}_{element}_{descriptor}
Button("Submit") { }
.accessibilityIdentifier("login_button_submit")
TextField("Email", text: $email)
.accessibilityIdentifier("login_textfield_email")
// List items with unique ID
ForEach(items) { item in
ItemRow(item: item)
.accessibilityIdentifier("home_cell_item_\(item.id)")
}
// Screen containers
var body: some View {
VStack { /* content */ }
.accessibilityIdentifier("screen_login")
}
Architecture Patterns
View Model Pattern
@Observable
@MainActor
final class FeatureViewModel {
var items: [Item] = []
var isLoading = false
var error: Error?
private let service: ItemServiceProtocol
init(service: ItemServiceProtocol = ItemService()) {
self.service = service
}
func load() async {
isLoading = true
defer { isLoading = false }
do {
items = try await service.fetchItems()
} catch {
self.error = error
}
}
}
struct FeatureView: View {
@State private var viewModel = FeatureViewModel()
jbcrane13
