swift-project-setup

Swift Project Setup

Instructions

Step 1: Gather Requirements

Ask the user (if not already provided):

• Project name and bundle identifier
• Target platforms (iOS, macOS, watchOS, visionOS)
• Minimum iOS version
• UI framework: SwiftUI, UIKit, or both
• Testing mode: enterprise or indie (see references/ in swift-testing skill)
• Persistence: None / SwiftData (iOS 17+) / CoreData
• Any SPM dependencies to add upfront

Step 2: Define Folder Structure

Ask if not already provided: SwiftUI, UIKit, or Mixed (SwiftUI + UIKit)?

Then load the matching reference:

• SwiftUI → references/structure-swiftui.md
• UIKit → references/structure-uikit.md
• Mixed → references/structure-mixed.md

Apply the template exactly. Then consult references/file-naming.md for group naming rules and the "What Never Goes Where" table before placing any file.

Step 3: Generate Architecture Skeleton

Create core protocol files:

// Core/Protocols/ViewModelProtocol.swift
import Foundation

@MainActor
protocol ViewModelProtocol: AnyObject {
    func onAppear() async
}

// Core/Protocols/RepositoryProtocol.swift
import Foundation

protocol RepositoryProtocol {
    associatedtype Model
    func fetch() async throws -> [Model]
}

Generate a placeholder feature (e.g., Home):

// Features/Home/HomeView.swift
import SwiftUI

struct HomeView: View {
    @State private var viewModel = HomeViewModel()

    var body: some View {
        Text("Hello, \(viewModel.title)")
            .task { await viewModel.onAppear() }
    }
}

#Preview {
    HomeView()
}

// Features/Home/HomeViewModel.swift
import Foundation
import Observation

@MainActor
@Observable
final class HomeViewModel {
    private(set) var title: String = ""

    func onAppear() async {
        title = "World"
    }
}

Step 4: CLAUDE.md Setup

Copy CLAUDE.md from swift-unit-test-instructions into the project root. Fill in the Project Configuration block:

• Project Name
• Testing Mode (enterprise or indie)
• UI Framework
• Min iOS Version