name: swiftui-core description: SwiftUI fundamentals for all Apple platforms. Use when building views, navigation, data persistence, or state management with SwiftUI across iOS, macOS, iPadOS, watchOS, visionOS. versions: swiftui: 6 ios: 26 user-invocable: false references: references/views-modifiers.md, references/navigation.md, references/data-swiftdata.md, references/state-management.md, references/liquid-glass.md related-skills: swift-core, solid-swift, ios, macos, ipados, watchos, visionos, tvos

SwiftUI Core

SwiftUI fundamentals shared across all Apple platforms.

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

1. fuse-ai-pilot:explore-codebase - Analyze existing SwiftUI patterns
2. fuse-ai-pilot:research-expert - Verify latest SwiftUI docs via Context7/Exa
3. mcp__apple-docs__search_apple_docs - Check SwiftUI view patterns

After implementation, run fuse-ai-pilot:sniper for validation.

Overview

When to Use

• Building SwiftUI views and components
• Implementing navigation (NavigationStack, SplitView)
• Data persistence with SwiftData
• State management (@State, @Observable)
• Custom view modifiers and layouts

Why SwiftUI Core

Key Concepts

Views & Modifiers

Composable UI building blocks. Extract subviews at 30+ lines.

Navigation

NavigationStack for stack-based, NavigationSplitView for multi-column.

SwiftData

Modern persistence with @Model. Replaces Core Data for most use cases.

State Management

@State for local, @Observable for shared, @Environment for injection.

Reference Guide

Best Practices

1. Small views - Extract at 30+ lines
2. Composition - Use ViewBuilder and modifiers
3. Preview-driven - Always include #Preview
4. Semantic colors - Use .primary, .secondary
5. Accessibility - Add labels to icons
6. Platform adaptation - Check sizeClass for responsive layouts