Workflow: Build a New iOS App

<required_reading> Read these reference files NOW before writing any code:

references/project-scaffolding.md
references/cli-workflow.md
references/app-architecture.md
references/swiftui-patterns.md </required_reading>

## Step 1: Clarify Requirements

Ask the user:

What does the app do? (core functionality)
What type? (single-screen, tab-based, navigation-based, data-driven)
Any specific features? (persistence, networking, push notifications, purchases)

Step 2: Choose App Archetype

Type	When to Use	Key Patterns
Single-screen utility	One primary function	Minimal navigation
Tab-based (TabView)	Multiple equal sections	TabView with 3-5 tabs
Navigation-based	Hierarchical content	NavigationStack
Data-driven	User content library	SwiftData + @Query

Step 3: Scaffold Project

Use XcodeGen:

mkdir AppName && cd AppName
# Create project.yml (see references/project-scaffolding.md)
# Create Swift files in Sources/
xcodegen generate

Step 4: Implement with TDD

Write failing test
Run → RED
Implement minimal code
Run → GREEN
Refactor
Repeat

Step 5: Build and Launch

# Build
xcodebuild -project AppName.xcodeproj -scheme AppName \
  -destination 'platform=iOS Simulator,name=iPhone 16' build 2>&1 | xcsift

# Launch in simulator
xcrun simctl boot "iPhone 16" 2>/dev/null || true
xcrun simctl install booted ./build/Build/Products/Debug-iphonesimulator/AppName.app
xcrun simctl launch booted com.company.AppName

Step 6: Polish

Read references/polish-and-ux.md for:

Haptic feedback
Animations
Accessibility
Dynamic Type support

<minimum_viable_app>

import SwiftUI

@main
struct MyApp: App {
    @State private var appState = AppState()

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(appState)
        }
    }
}

@Observable
class AppState {
    var items: [Item] = []
}

struct ContentView: View {
    @Environment(AppState.self) private var appState

    var body: some View {
        NavigationStack {
            List(appState.items) { item in
                Text(item.name)
            }
            .navigationTitle("Items")
        }
    }
}

</minimum_viable_app>

<success_criteria>

Follows iOS Human Interface Guidelines
Builds and runs from CLI
Tests pass
Launches in simulator
User can verify UX manually </success_criteria>

2.5 KiB Raw Blame History