| name | swiftui |
| description | SwiftUI development and design engineering: views, state management, @Observable, navigation, sheets, lists, animations, charts, macOS scenes, typography, accessibility (WCAG, Dynamic Type, VoiceOver), design tokens, responsive layout, previews, and performance auditing (hitches, invalidation storms, Instruments). Use when building or reviewing SwiftUI interfaces, designing components, or diagnosing UI performance. Not for UIKit migration (use uikit-app-modernization) or SDK 27 API changes (use swiftui-whats-new-27).
|
| allowed-tools | ["Read","Glob","Grep"] |
SwiftUI
SwiftUI framework patterns plus design engineering and performance auditing.
Each domain has a _guide.md — load it first for rules and checklists, then
load detailed references on demand.
Read first: references/swiftui/latest-apis.md — deprecated-to-modern API
lookup. Always consult before writing SwiftUI code to avoid deprecated APIs.
SwiftUI Framework
Load: references/swiftui/_guide.md
| Topic | Reference |
|---|
| Type system & design patterns | references/swiftui/type-system-patterns.md |
| Deprecated→modern API lookup | references/swiftui/latest-apis.md |
| Property wrappers, data flow | references/swiftui/state-management.md |
| View composition, extraction | references/swiftui/view-structure.md |
| Performance patterns | references/swiftui/performance-patterns.md |
| ForEach, list identity | references/swiftui/list-patterns.md |
| Modern API replacements | references/swiftui/modern-apis.md |
| Core animation concepts | references/swiftui/animation-basics.md |
| Transitions, Animatable | references/swiftui/animation-transitions.md |
| Phase/keyframe animations | references/swiftui/animation-advanced.md |
| Sheets, navigation | references/swiftui/sheet-navigation-patterns.md |
| ScrollView patterns | references/swiftui/scroll-patterns.md |
| Text formatting | references/swiftui/text-formatting.md |
| Image optimization | references/swiftui/image-optimization.md |
| Layout patterns | references/swiftui/layout-best-practices.md |
| Liquid Glass (iOS 26+) | references/swiftui/liquid-glass.md |
| Accessibility patterns | references/swiftui/accessibility-patterns.md |
| Swift Charts (iOS 16+) | references/swiftui/charts.md |
| macOS scenes | references/swiftui/macos-scenes.md |
| macOS window/toolbar styling | references/swiftui/macos-window-styling.md |
Architecture deep dive: references/swiftui/type-system-patterns.md —
SwiftUI's type system, protocol hierarchy, style system, result builders,
property wrappers, environment/preference data flow, modifier pattern, type
erasure, and Observation framework. Load when reasoning about architecture or
choosing between patterns (some vs any, AnyView vs @ViewBuilder,
environment vs preferences, @Observable vs ObservableObject).
Design & Performance Auditing
Typography, accessibility, WCAG, Dynamic Type, design tokens, responsive layout, previews, Instruments profiling, hitches
Load: references/design/_guide.md
| Topic | Reference |
|---|
| Type scale, Dynamic Type | references/design/typography.md |
| WCAG, VoiceOver, contrast | references/design/accessibility.md |
| Colors, spacing, radius tokens | references/design/design-tokens.md |
| Size class adaptation | references/design/layout-responsive.md |
| Preview-driven development | references/design/previews.md |
| Four-phase performance audit | references/design/performance-audit.md |
Review Checklist (Quick)
Related Skills
| Need | Skill |
|---|
| Primary-source Apple docs/HIG lookup (MCP/CLI) | apple-docs |
| Language, concurrency, SPM | swift |
| iOS 26-era platform APIs (Liquid Glass adoption, Foundation Models) | apple-platforms |
| SDK 27 SwiftUI changes (@State macro, reorderable, AsyncImage caching) | swiftui-whats-new-27 |
| Apple-authored SwiftUI idiom review | swiftui-specialist |
| On-device/simulator UI verification | device-interaction |
| Building/testing via Xcode CLI and agents | xcode-agentic |
Project Conventions (Dynamic)
Before applying generic guidance, check ./.claude/skills/*/references/**/conventions.md
(project-level) and ~/.claude/skills/project-conventions/ (user-level).
Project design tokens and component patterns take precedence over generic examples.
Sources
This skill incorporates knowledge from Apple documentation, WWDC sessions, and
established SwiftUI community engineering practices.
