Axiom Swiftui Architecture

What it does

This skill helps you design and structure SwiftUI applications by providing guidance on architectural patterns and code organization. It assists in refactoring existing views, choosing appropriate architectural approaches (MVVM, TCA, vanilla SwiftUI), making code testable, and deciding which property wrappers to use (@State, @Environment, @Bindable). Ultimately, it aims to improve the modularity, testability, and maintainability of your SwiftUI codebase.

When to use it

• You have logic within your SwiftUI view files that needs extraction.
• You're unsure whether to use MVVM, TCA, or Apple’s native patterns.
• You need to refactor views to separate concerns.
• You want to improve the testability of your SwiftUI code.
• You are struggling with where specific pieces of logic (like formatters and calculations) should reside.
• You're deciding which property wrapper is most suitable for a given scenario.
• You’re organizing a SwiftUI codebase for team development.

Key capabilities

• Architectural Pattern Guidance: Provides decision trees to help choose between MVVM, TCA, Apple's native patterns, and the Coordinator pattern.
• Refactoring Workflow: Offers guidance on extracting logic from view files.
• Property Wrapper Selection: Provides a decision tree for choosing between @State, @Environment, @Bindable, or plain properties.
• Testability Advice: Shows separation patterns that enable testing without SwiftUI imports.
• Navigation Guidance: Explains when and how to use the Coordinator pattern for complex navigation scenarios.
• Apple's Native Patterns Support: Provides guidance on using Apple’s modern SwiftUI patterns, including @Observable models, State-as-Bridge, and property wrapper selection.

Example prompts

• "There's quite a bit of code in my model view files about logic things. How do I extract it?"
• "Should I use MVVM, TCA, or Apple's vanilla patterns?"
• "How do I make my SwiftUI code testable?"
• "Which property wrapper do I use?"

Tips & gotchas

• The skill is particularly useful when starting new projects or refactoring existing ones.
• TCA (The Composable Architecture) offers excellent testability but has a steeper learning curve and more boilerplate code.
• Consider Apple's Native Patterns for smaller to medium-sized applications using iOS 26+.