Skip to main content
skill CX Codex

swiftui-patterns · johnrogers — Claude Code skill: what it does, how to install

swiftui-patterns guides Claude Code through iOS 17+ SwiftUI conventions: the @Observable macro, NavigationStack, and clean UIKit interop.

MIT ★ 233 updated 2026-01-18

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What swiftui-patterns does

This skill guides your coding agent toward Apple's modern iOS 17 APIs instead of third-party reactive frameworks. It replaces heavy ObservableObject and @Published boilerplate with the @Observable macro, configures dependencies via @Environment, and automates async flows with .task.

The tool relies on twelve specialized reference guides covering navigation paths, VoiceOver traits, view models, and UIKit bridges like WKWebView. Claude loads these topics on demand when updating views or handling list performance.

Overusing @Bindable on read-only properties triggers redundant view reloads, so the skill restricts two-way bindings to truly mutable model fields.

What it helps with

  • migrate views from ObservableObject to the @Observable macro
  • structure type-safe routing with NavigationStack and NavigationPath
  • bridge UIKit views through UIViewRepresentable without retain cycles
  • implement VoiceOver hints and Dynamic Type support across views

Example prompts for the agent

  • Refactor this settings screen from ObservableObject to the modern @Observable macro.
  • Set up programmatic deep link navigation using NavigationStack and NavigationPath.
  • Wrap WKWebView inside a UIViewRepresentable container with safe delegate cleanup.

How to install swiftui-patterns

1Plugin marketplace

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

This installs the whole swift-engineering plugin with all its skills

2Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill swiftui-patterns -a claude-code

3Manually: put the files in place

~/.claude/skills/swiftui-patterns/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/swiftui-patterns/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about swiftui-patterns

How to install swiftui-patterns in Claude Code?

Run /plugin marketplace add johnrogers/claude-swift-engineering followed by /plugin install swift-engineering@claude-swift-engineering.

What does swiftui-patterns do?

It applies official iOS 17+ SwiftUI patterns, steering code generation toward @Observable, task-based async handling, and standard navigation APIs.

Why does the skill restrict the use of @Bindable?

Applying @Bindable indiscriminately creates needless view invalidations, so it is reserved strictly for properties requiring two-way mutation.

Source text

SKILL.md · MIT
---
name: swiftui-patterns
description: >-
  Use when implementing iOS 17+ SwiftUI patterns: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver/Dynamic Type), async operations (.task/.refreshable), or migrating from ObservableObject/@StateObject.
---

# SwiftUI Patterns (iOS 17+)

SwiftUI 17+ removes ObservableObject boilerplate with @Observable, simplifies environment injection with @Environment, and introduces task-based async patterns. The core principle: use Apple's modern APIs instead of reactive libraries.

## Overview

## Quick Reference

| Need | Use (iOS 17+) | NOT |
|------|---------------|-----|
| Observable model | `@Observable` | `ObservableObject` |
| Published property | Regular property | `@Published` |
| Own state | `@State` | `@StateObject` |
| Passed model (binding) | `@Bindable` | `@ObservedObject` |
| Environment injection | `environment(_:)` | `environmentObject(_:)` |
| Environment access | `@Environment(Type.self)` | `@EnvironmentObject` |
| Async on appear | `.task { }` | `.onAppear { Task {} }` |
| Value change | `onChange(of:initial:_:)` | `onChange(of:perform:)` |

## Core Workflow

1. Use `@Observable` for model classes (no @Published needed)
2. Use `@State` for view-owned models, `@Bindable` for passed models
3. Use `.task { }` for async work (auto-cancels on disappear)
4. Use `NavigationStack` with `NavigationPath` for programmatic navigation
5. Apply `.accessibilityLabel()` and `.accessibilityHint()` to interactive elements

## Reference Loading Guide

**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.

| Reference | Load When |
|-----------|-----------|
| **[Observable](references/observable.md)** | Creating new `@Observable` model classes |
| **[State Management](references/state-management.md)** | Deciding between `@State`, `@Bindable`, `@Environment` |
| **[Environment](references/environment.md)** | Injecting dependencies into view hierarchy |
| **[View Modifiers](references/view-modifiers.md)** | Using `onChange`, `task`, or iOS 17+ modifiers |
| **[Migration Guide](references/migration-guide.md)** | Updating iOS 16 code to iOS 17+ |
| **[MVVM Observable](references/mvvm-observable.md)** | Setting up view model architecture |
| **[Navigation](references/navigation.md)** | Programmatic or deep-link navigation |
| **[Performance](references/performance.md)** | Lists with 100+ items or excessive re-renders |
| **[UIKit Interop](references/uikit-interop.md)** | Wrapping UIKit components (WKWebView, PHPicker) |
| **[Accessibility](references/accessibility.md)** | VoiceOver, Dynamic Type, accessibility actions |
| **[Async Patterns](references/async-patterns.md)** | Loading states, refresh, background tasks |
| **[Composition](references/composition.md)** | Reusable view modifiers or complex conditional UI |

## Common Mistakes

1. **Over-using `@Bindable` for passed models** — Creating `@Bindable` for every property causes unnecessary view reloads. Use `@Bindable` only for mutable model properties that need two-way binding. Read-only computed properties should use regular properties.

2. **State placement errors** — Putting model state in the view instead of a dedicated `@Observable` model causes view logic to become tangled. Always separate model and view concerns.

3. **NavigationPath state corruption** — Mutating `NavigationPath` incorrectly can leave it in inconsistent state. Use `navigationDestination(for:destination:)` with proper state management to avoid path corruption.

4. **Missing `.task` cancellation** — `.task` handles cancellation on disappear automatically, but nested Tasks don't. Complex async flows need explicit cancellation tracking to avoid zombie tasks.

5. **Ignoring environment invalidation** — Changing environment values at parent doesn't invalidate child views automatically. Use `@Environment` consistently and understand when re-renders happen based on observation.

6. **UIKit interop memory leaks** — `UIViewRepresentable` and `UIViewControllerRepresentable` can leak if delegate cycles aren't broken. Weak references and explicit cleanup are required.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Similar skills

All skills for Mobile →

swiftui-patterns by other authors comes first.

swiftui-patterns affaan-m swiftui-patterns guides AI agents on modern SwiftUI architecture: @Observable state, type-safe navigation, and view performance. Useful when building or reviewing iOS and macOS UI. CX Codex +1 6,300installs swiftui-patterns dpearson2699 swiftui-patterns guides SwiftUI view work around state, composition, environment wiring, and isolated previews. Use it when refactoring a screen or sorting out @Observable ownership. CX Codex +1 4,900installs swiftui-patterns official OpenAI swiftui-patterns sets desktop-first macOS SwiftUI architecture, scene models, toolbars, split views, and clean multi-file project layouts. CX Codex GP ChatGPT +1 57installs swiftui-patterns podo swiftui-patterns is a Claude Code skill with idiomatic SwiftUI patterns for tab navigation, screen layouts, custom modifiers, and state handling. CX Codex +1 205installs swiftui-uikit-interop dpearson2699 swiftui-uikit-interop bridges UIKit and SwiftUI views, controllers, and shared state without lifecycle conflicts or duplicated data. CX Codex +1 4,400installs swiftui-animation dpearson2699 swiftui-animation guides your agent through SwiftUI motion APIs. It helps choose spring curves, keyframes, transitions, and accessibility settings. CX Codex +1 5,900installs iphone-duo-dual-pane-patterns mirzaaghazadeh iphone-duo-dual-pane-patterns — a skill for Claude Code, Codex, Cursor and other agents: exact pixel and point dimensions for every iPhone Duo display surface, hinge callback signatures, and pose-to-pattern mapping. CX Codex +1 772installs axiom-swiftui CharlesWiltgen axiom-swiftui — a skill for Claude Code, Codex, Cursor, Copilot and other agents that activates on any SwiftUI task: views, navigation, layout, animations, gestures, debugging. Covers iOS 26 features and iPhone Duo. CX Codex +1 1,700installs iphone-duo-readiness mirzaaghazadeh iphone-duo-readiness audits iOS apps and prepares them for the foldable iPhone Duo. It hunts hardcoded screen sizes, deprecated UIScreen calls, and layout bugs when targeting the iOS 27.1 SDK. CX Codex +1 1,100installs swiftui-motion AThevon swiftui-motion is a Claude Code skill that structures SwiftUI animation code. Directs spring tuning, view transitions, phase animators, and zoom navigation for Apple platforms. CX Codex +1 957installs

From the same set33

The whole set →
tca-engineer tca-engineer writes the code for a TCA feature from a finished design: reducers, state, actions, dependency clients with test doubles. Views are out of scope. CX Codex ★ 233repo stars sqlite-data Guides database modeling in Swift with the SQLiteData library, macro queries, migrations, and private CloudKit database sync. CX Codex +1 ★ 233repo stars composable-architecture This skill guides feature work with The Composable Architecture (TCA), from reducer structure and effects to navigation and tests. Use it while building or checking TCA features. CX Codex +1 ★ 233repo stars modern-swift modern-swift — a Claude skill that steers the agent through Swift 6.2 concurrency: async/await, actors, Sendable and task cancellation. CX Codex +1 ★ 233repo stars swift-testing Get guidance for writing Swift Testing tests, migrating from XCTest, and handling async or parameterized cases in Claude Code. CX Codex +1 ★ 233repo stars tca-architect tca-architect designs feature architectures for The Composable Architecture: State structure, Action taxonomy, dependencies, navigation. Operates in read-only mode. CX Codex ★ 233repo stars swift-architect swift-architect designs Swift feature architecture, file layout, and persistence plans before implementation begins. CX Codex ★ 233repo stars swift-search The swift-search subagent locates Swift definitions and implementations, then checks the matching files. Use it when you know what to find but not where it lives. CX Codex ★ 233repo stars

Project sponsors

Companies that keep this analytics open