axiom-swiftui-architecture

Guide SwiftUI architecture choices and refactor logic out of views.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-swiftui-architecture-tuliopc23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-swiftui-architecture
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-swiftui-architecture
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-swiftui-architecture-tuliopc23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers organize their SwiftUI code, choose appropriate architecture patterns, and refactor view files to improve maintainability and testability.

Core Features & Use Cases

  • Architecture Guidance: Provides decision trees for choosing between Apple's native patterns, MVVM, TCA, or Coordinator patterns.
  • Code Refactoring: Offers workflows for extracting logic from SwiftUI views into models or ViewModels.
  • Testability Improvement: Demonstrates patterns that make SwiftUI code easier to test.
  • Use Case: You have a complex SwiftUI view with too much logic. This Skill guides you on where to move that logic (e.g., to a ViewModel or a dedicated model) and how to structure your app for better scalability.

Quick Start

Use the axiom-swiftui-architecture skill to understand how to separate logic from SwiftUI views.

Frequently Asked Questions about axiom-swiftui-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I separate business logic from SwiftUI views?

To separate business logic from SwiftUI views, you can extract state and logic into ViewModels or dedicated models. This Skill provides refactoring workflows that guide you on exactly where to move that logic to improve testability and maintainability.

What's the best way to choose an architecture pattern for SwiftUI?

Choosing an SwiftUI architecture pattern depends on your app's complexity. This Skill provides decision trees comparing Apple's native patterns, MVVM, TCA, and the Coordinator pattern to help you select the right structure for your codebase.

How do I refactor a massive SwiftUI view file for better testability?

Refactoring a massive SwiftUI view involves moving state management and event handling out of the view body. This Skill offers workflows for extracting logic into models or ViewModels, directly improving code testability and scalability.

Does this SwiftUI architecture guidance cover The Composable Architecture (TCA)?

Yes, this SwiftUI architecture guidance covers The Composable Architecture (TCA). It includes TCA in its architectural decision trees alongside MVVM and Apple's native patterns to help you evaluate it for your iOS development projects.

When should I use the Coordinator pattern in SwiftUI?

You should use the Coordinator pattern in SwiftUI when managing complex navigation flows. This Skill addresses when to apply the Coordinator pattern compared to native alternatives, helping you organize navigation and avoid common architectural anti-patterns.

Are there architectural guidelines for iOS 26 and later?

Yes, there are architectural guidelines for iOS 26 and later. This Skill provides up-to-date patterns and refactoring workflows tailored for organizing SwiftUI codebases specifically targeting iOS 26+ development environments.