swiftui

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)

• references/swiftui/latest-apis.md consulted — no deprecated APIs
• @Observable over ObservableObject
• View body is simple and pure — no side effects, no heavy computation
• Stable ForEach identity
• Accessibility labels on interactive elements
• Button over onTapGesture
• WCAG AA met (4.5:1 body text, 3:1 large text)
• Dynamic Type supported (@ScaledMetric for custom values)
• Design tokens used (no magic numbers)

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.