| 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. Use when this capability is needed. |
| metadata | {"author":"fusengine"} |
SwiftUI Core
SwiftUI fundamentals shared across all Apple platforms.
Agent Workflow (MANDATORY)
Before ANY implementation, use TeamCreate to spawn 3 agents:
- fuse-ai-pilot:explore-codebase - Analyze existing SwiftUI patterns
- fuse-ai-pilot:research-expert - Verify latest SwiftUI docs via Context7/Exa
- 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
| Feature | Benefit |
|---|
| Declarative UI | Less code, automatic updates |
| Cross-platform | Same code for iOS/macOS/watchOS/visionOS |
| @Observable | Simple reactive state |
| SwiftData | Modern persistence with minimal code |
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
- Small views - Extract at 30+ lines
- Composition - Use ViewBuilder and modifiers
- Preview-driven - Always include #Preview
- Semantic colors - Use .primary, .secondary
- Accessibility - Add labels to icons
- Platform adaptation - Check sizeClass for responsive layouts
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
