Files
skills/public/swiftui-architecture.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

706 lines
26 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>swiftui-architecture</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/swiftui-architecture.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/swiftui-architecture">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/swiftui-architecture.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>swiftui-architecture</h1><p class="lede">Building iOS/macOS apps with SwiftUI</p><h1>SwiftUI Architecture Patterns</h1>
<p><strong>Use this skill when:</strong></p>
<ul><li>Building iOS/macOS apps with SwiftUI</li><li>Implementing MVVM architecture patterns</li><li>Managing state with @Observable, @State, @Binding</li><li>Organizing SwiftUI views and view models</li><li>Designing clean separation of concerns in SwiftUI apps</li></ul>
<h2>Core Architecture: MVVM with Observation Framework</h2>
<p>SwiftUI apps use Model-View-ViewModel (MVVM) architecture with Swift&#x27;s Observation framework for reactive state management.</p>
<h3>The Three Layers</h3>
<pre><code class="lang-swift">// MODEL: Pure data and business logic
struct User: Codable, Identifiable {
let id: UUID
var name: String
var email: String
}
// VIEW MODEL: Observable state container
@Observable
final class UserProfileViewModel {
var user: User?
var isLoading = false
var errorMessage: String?
private let userService: UserService
init(userService: UserService = .shared) {
self.userService = userService
}
func loadUser(id: UUID) async {
isLoading = true
errorMessage = nil
do {
user = try await userService.fetchUser(id: id)
} catch {
errorMessage = error.localizedDescription
}
isLoading = false
}
func updateName(_ newName: String) async throws {
guard var user else { return }
user.name = newName
let updatedUser = try await userService.updateUser(user)
self.user = updatedUser
}
}
// VIEW: UI presentation
struct UserProfileView: View {
@State private var viewModel = UserProfileViewModel()
let userId: UUID
var body: some View {
Group {
if viewModel.isLoading {
ProgressView()
} else if let user = viewModel.user {
UserDetailView(user: user, viewModel: viewModel)
} else if let error = viewModel.errorMessage {
ErrorView(message: error)
}
}
.task {
await viewModel.loadUser(id: userId)
}
}
}</code></pre>
<h2>State Management Patterns</h2>
<h3>@Observable: Primary State Container</h3>
<p>Use <code>@Observable</code> macro for view models (Swift 5.9+):</p>
<pre><code class="lang-swift">@Observable
final class DashboardViewModel {
var items: [Item] = []
var searchQuery = &quot;&quot;
var selectedFilter: FilterType = .all
// Computed properties automatically trigger view updates
var filteredItems: [Item] {
items.filter { item in
(searchQuery.isEmpty || item.title.contains(searchQuery)) &amp;&amp;
(selectedFilter == .all || item.category == selectedFilter)
}
}
func loadItems() async throws {
items = try await ItemService.shared.fetchItems()
}
}
struct DashboardView: View {
@State private var viewModel = DashboardViewModel()
var body: some View {
List(viewModel.filteredItems) { item in
ItemRow(item: item)
}
.searchable(text: $viewModel.searchQuery)
.task {
try? await viewModel.loadItems()
}
}
}</code></pre>
<h3>@State: View-Local State</h3>
<p>Use <code>@State</code> for simple view-local state:</p>
<pre><code class="lang-swift">struct ToggleView: View {
@State private var isExpanded = false
@State private var selectedTab = 0
var body: some View {
VStack {
Picker(&quot;Tab&quot;, selection: $selectedTab) {
Text(&quot;First&quot;).tag(0)
Text(&quot;Second&quot;).tag(1)
}
if isExpanded {
DetailContentView()
}
Button(isExpanded ? &quot;Collapse&quot; : &quot;Expand&quot;) {
withAnimation {
isExpanded.toggle()
}
}
}
}
}</code></pre>
<h3>@Binding: Two-Way Data Flow</h3>
<p>Use <code>@Binding</code> to pass mutable state to child views:</p>
<pre><code class="lang-swift">struct SettingsForm: View {
@Binding var settings: AppSettings
var body: some View {
Form {
Toggle(&quot;Enable Notifications&quot;, isOn: $settings.notificationsEnabled)
Picker(&quot;Theme&quot;, selection: $settings.theme) {
Text(&quot;Light&quot;).tag(Theme.light)
Text(&quot;Dark&quot;).tag(Theme.dark)
Text(&quot;Auto&quot;).tag(Theme.auto)
}
}
}
}
struct SettingsView: View {
@State private var settings = AppSettings()
var body: some View {
SettingsForm(settings: $settings)
.onChange(of: settings) { oldValue, newValue in
saveSettings(newValue)
}
}
}</code></pre>
<h3>@Environment: Dependency Injection</h3>
<p>Use <code>@Environment</code> for cross-cutting concerns:</p>
<pre><code class="lang-swift">// Define environment key
private struct UserServiceKey: EnvironmentKey {
static let defaultValue: UserService = .shared
}
extension EnvironmentValues {
var userService: UserService {
get { self[UserServiceKey.self] }
set { self[UserServiceKey.self] = newValue }
}
}
// Inject in view
struct ContentView: View {
@Environment(\.userService) private var userService
var body: some View {
Text(&quot;Using userService&quot;)
}
}
// Provide at app level
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
.environment(\.userService, UserService.shared)
}
}
}</code></pre>
<h2>View Composition Patterns</h2>
<h3>Extract Subviews for Reusability</h3>
<p>Break complex views into focused components:</p>
<pre><code class="lang-swift">struct ProductListView: View {
@State private var viewModel = ProductListViewModel()
var body: some View {
List {
SearchBarSection(query: $viewModel.searchQuery)
FilterSection(
selectedFilter: $viewModel.selectedFilter,
availableFilters: viewModel.availableFilters
)
ProductsSection(
products: viewModel.filteredProducts,
onSelect: viewModel.selectProduct
)
}
}
}
private struct SearchBarSection: View {
@Binding var query: String
var body: some View {
Section {
TextField(&quot;Search products&quot;, text: $query)
.textFieldStyle(.roundedBorder)
}
}
}
private struct ProductsSection: View {
let products: [Product]
let onSelect: (Product) -&gt; Void
var body: some View {
Section {
ForEach(products) { product in
ProductRow(product: product)
.onTapGesture {
onSelect(product)
}
}
}
}
}</code></pre>
<h3>ViewBuilder for Conditional Content</h3>
<p>Use <code>@ViewBuilder</code> for flexible content composition:</p>
<pre><code class="lang-swift">struct Card&lt;Content: View&gt;: View {
let title: String
@ViewBuilder let content: () -&gt; Content
var body: some View {
VStack(alignment: .leading, spacing: 12) {
Text(title)
.font(.headline)
content()
}
.padding()
.background(Color(.systemBackground))
.cornerRadius(12)
.shadow(radius: 2)
}
}
// Usage
Card(title: &quot;User Info&quot;) {
Text(&quot;Name: \(user.name)&quot;)
Text(&quot;Email: \(user.email)&quot;)
}
Card(title: &quot;Stats&quot;) {
HStack {
StatView(label: &quot;Posts&quot;, value: stats.posts)
StatView(label: &quot;Followers&quot;, value: stats.followers)
}
}</code></pre>
<h2>Dependency Management</h2>
<h3>Constructor Injection</h3>
<p>Pass dependencies through initializers:</p>
<pre><code class="lang-swift">@Observable
final class OrderViewModel {
var orders: [Order] = []
private let orderService: OrderService
private let analyticsService: AnalyticsService
init(
orderService: OrderService,
analyticsService: AnalyticsService = .shared
) {
self.orderService = orderService
self.analyticsService = analyticsService
}
func loadOrders() async throws {
orders = try await orderService.fetchOrders()
analyticsService.track(&quot;orders_loaded&quot;, count: orders.count)
}
}
struct OrderListView: View {
@State private var viewModel: OrderViewModel
init(orderService: OrderService = .shared) {
_viewModel = State(initialValue: OrderViewModel(orderService: orderService))
}
var body: some View {
List(viewModel.orders) { order in
OrderRow(order: order)
}
.task {
try? await viewModel.loadOrders()
}
}
}</code></pre>
<h3>Protocol-Based Dependencies</h3>
<p>Use protocols for testability:</p>
<pre><code class="lang-swift">protocol AuthServiceProtocol {
func login(email: String, password: String) async throws -&gt; User
func logout() async throws
var currentUser: User? { get }
}
@Observable
final class AuthViewModel {
var currentUser: User?
var isLoading = false
var errorMessage: String?
private let authService: AuthServiceProtocol
init(authService: AuthServiceProtocol) {
self.authService = authService
self.currentUser = authService.currentUser
}
func login(email: String, password: String) async {
isLoading = true
errorMessage = nil
do {
currentUser = try await authService.login(email: email, password: password)
} catch {
errorMessage = error.localizedDescription
}
isLoading = false
}
}</code></pre>
<h2>Loading, Error, and Empty States</h2>
<p>Always handle all UI states explicitly:</p>
<pre><code class="lang-swift">@Observable
final class ContentViewModel {
enum LoadingState {
case idle
case loading
case loaded([Item])
case error(Error)
}
var state: LoadingState = .idle
func load() async {
state = .loading
do {
let items = try await fetchItems()
state = items.isEmpty ? .loaded([]) : .loaded(items)
} catch {
state = .error(error)
}
}
}
struct ContentView: View {
@State private var viewModel = ContentViewModel()
var body: some View {
Group {
switch viewModel.state {
case .idle:
Color.clear
.onAppear {
Task { await viewModel.load() }
}
case .loading:
ProgressView(&quot;Loading...&quot;)
case .loaded(let items) where items.isEmpty:
EmptyStateView(
title: &quot;No Items&quot;,
message: &quot;Add your first item to get started&quot;,
action: { viewModel.showAddItem() }
)
case .loaded(let items):
ItemListView(items: items)
case .error(let error):
ErrorView(
error: error,
retry: { Task { await viewModel.load() } }
)
}
}
.animation(.default, value: viewModel.state)
}
}</code></pre>
<h2>Testing View Models</h2>
<p>Structure view models for testability:</p>
<pre><code class="lang-swift">// Production service
actor ProductService: ProductServiceProtocol {
func fetchProducts() async throws -&gt; [Product] {
// Network call
}
}
// Test mock
final class MockProductService: ProductServiceProtocol {
var productsToReturn: [Product] = []
var shouldThrowError = false
func fetchProducts() async throws -&gt; [Product] {
if shouldThrowError {
throw NSError(domain: &quot;test&quot;, code: -1)
}
return productsToReturn
}
}
// Test
@Test
func testProductLoadingSuccess() async throws {
let mockService = MockProductService()
mockService.productsToReturn = [
Product(id: 1, name: &quot;Test Product&quot;)
]
let viewModel = ProductViewModel(service: mockService)
await viewModel.loadProducts()
#expect(viewModel.products.count == 1)
#expect(viewModel.errorMessage == nil)
}</code></pre>
<h2>Anti-Patterns to Avoid</h2>
<p><strong>DON&#x27;T put business logic in views:</strong></p>
<pre><code class="lang-swift">// ❌ BAD
struct UserView: View {
@State private var user: User?
var body: some View {
Text(user?.name ?? &quot;&quot;)
.task {
// Business logic in view!
let url = URL(string: &quot;https://api.example.com/user&quot;)!
let (data, _) = try await URLSession.shared.data(from: url)
user = try JSONDecoder().decode(User.self, from: data)
}
}
}
// ✅ GOOD
struct UserView: View {
@State private var viewModel = UserViewModel()
var body: some View {
Text(viewModel.user?.name ?? &quot;&quot;)
.task {
await viewModel.loadUser()
}
}
}</code></pre>
<p><strong>DON&#x27;T use @StateObject or @ObservedObject with @Observable:</strong></p>
<pre><code class="lang-swift">// ❌ BAD - @Observable doesn&#x27;t need @StateObject
@StateObject private var viewModel = MyViewModel()
// ✅ GOOD
@State private var viewModel = MyViewModel()</code></pre>
<p><strong>DON&#x27;T make view models reference views:</strong></p>
<pre><code class="lang-swift">// ❌ BAD - Creates retain cycles
@Observable
final class BadViewModel {
weak var view: SomeView?
}
// ✅ GOOD - Use callbacks or published state
@Observable
final class GoodViewModel {
var onComplete: (() -&gt; Void)?
var shouldDismiss = false
}</code></pre>
<h2>Related Skills</h2>
<ul><li><strong>swift-concurrency.md</strong> - async/await patterns, actors, Swift 6 concurrency</li><li><strong>swiftdata-persistence.md</strong> - Persisting view model state</li><li><strong>swiftui-navigation.md</strong> - Passing view models through navigation</li><li><strong>ios-networking.md</strong> - Network layer for view models</li><li><strong>ios-testing.md</strong> - Testing SwiftUI views and view models</li></ul>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/swiftui-architecture.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>