# IOS Swift UI

> Build iOS apps with SwiftUI — declarative views, async/await, SwiftData, and Apple platform integration

- Skill: `uitbreidenos/ios-swift-ui` (Agent Skill)
- Install (CLI): `npx skillmds@latest add uitbreidenos/ios-swift-ui`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uitbreidenos/ios-swift-ui/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: UitbreidenOS (https://skillmd.com/u/uitbreidenos)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/uitbreidenos/ios-swift-ui

---


## When to activate

- Building iOS apps with SwiftUI
- Implementing async data loading with Swift Concurrency
- Persisting data with SwiftData or Core Data
- Integrating Apple frameworks (HealthKit, MapKit, WidgetKit)
- Preparing apps for App Store submission

## When NOT to use

- For cross-platform apps (use react-native-expo or flutter-widgets)
- For Android-only development
- For macOS-only apps (different framework)

## Instructions

1. **Project structure.** MVVM: Views (SwiftUI) → ViewModels (@Observable) → Services (async/await) → Models (SwiftData).
2. **SwiftUI views.** Keep views small and composable. Use `@State` for local, `@Bindable` for shared, `@Environment` for injected.
3. **Async data.** `async let` for parallel, `Task` for background work, `.task` modifier for view lifecycle. Handle loading/error states explicitly.
4. **SwiftData.** `@Model` for entities, `@Query` for fetching, `ModelContainer` for setup. Migrate from Core Data only if benefits outweigh effort.
5. **Navigation.** `NavigationStack` with type-safe `NavigationPath`. Define routes as enums. Support deep linking via `onOpenURL`.
6. **Accessibility.** `.accessibilityLabel`, `.accessibilityHint`, Dynamic Type support with `@ScaledMetric`, VoiceOver testing.
7. **Testing.** XCTest for unit, XCUITest for UI, Snapshot tests for visual regression.

## Example

```swift
@Observable
class ProductListViewModel {
    var products: [Product] = []
    var isLoading = false
    var error: Error?

    func loadProducts() async {
        isLoading = true
        defer { isLoading = false }
        do {
            products = try await api.fetchProducts()
        } catch {
            self.error = error
        }
    }
}

struct ProductListView: View {
    @State private var viewModel = ProductListViewModel()

    var body: some View {
        NavigationStack {
            List(viewModel.products) { product in
                NavigationLink(value: product) {
                    ProductRow(product: product)
                }
            }
            .task { await viewModel.loadProducts() }
        }
    }
}
```