| name | swiftui-architecture |
| description | WHEN building SwiftUI views, managing state, setting up shared services, or making architectural decisions; NOT for UIKit or legacy patterns; provides pure SwiftUI data flow without ViewModels using @State, @Binding, @Observable, and @Environment. |
Modern SwiftUI Architecture
Concise entry point for pure SwiftUI architecture without ViewModels. Use the references for patterns, examples, and edge cases.
Start Here
- State management:
references/state-management.md
- Observable services:
references/observable-patterns.md
- Async work:
references/async-patterns.md
- Navigation:
references/navigation-patterns.md
- UI components:
references/lists.md, references/scrollview.md, references/forms.md, references/grids.md, references/sheets.md, references/tabs.md
- Anti-patterns:
references/anti-patterns.md
Typical Flow
- Choose state ownership and data flow (
references/state-management.md).
- Model shared logic as @Observable services (
references/observable-patterns.md).
- Wire navigation with AppRouter (
references/navigation-patterns.md).
- Build UI using component guides.
- Audit against anti-patterns (
references/anti-patterns.md).
