tomevault-io 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
| Need | Reference |
|---|---|
| Views, modifiers, layouts | views-modifiers.md |
| NavigationStack, deep linking | navigation.md |
| SwiftData, @Query, CloudKit | data-swiftdata.md |
| @State, @Observable, Environment | state-management.md |
| Liquid Glass all platforms | liquid-glass.md |
| Siri, Shortcuts, App Intents | app-intents.md |
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.