kmshdev/claude-swift-toolkit/swift-project-scaffold

1. Template Variables

2. XcodeGen Path (Primary)

Steps when xcodegen is available:

1. Create directory structure: Sources/<AppName>/, Tests/<AppName>Tests/
2. Write project.yml from template (select macos.project.yml or ios.project.yml)
3. Replace all __TEMPLATE_VAR__ placeholders with actual values
4. Write AppEntry.swift and ContentView.swift from templates
5. Write .gitignore from template
6. Run xcodegen generate
7. Open the generated project in Xcode and verify with BuildProject when the bridge is available, otherwise use xcodebuild

3. Manual Xcode Fallback

Steps when xcodegen is NOT available:

1. Stop the automated scaffold path and tell the user there is no official Xcode

MCP project-scaffolding tool in this toolkit.

1. Ask the user to either install XcodeGen or create a new App project in Xcode

manually.

1. Once the project exists, write the template-based AppEntry.swift,

ContentView.swift, and .gitignore files into that project structure.

1. Verify with BuildProject if the project is open in Xcode, otherwise use

xcodebuild.

4. App Archetypes

Standard (WindowGroup)

@main
struct __APP_NAME__App: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Document-Based

@main
struct __APP_NAME__App: App {
    var body: some Scene {
        DocumentGroup(newDocument: __APP_NAME__Document()) { file in
            ContentView(document: file.$document)
        }
    }
}

Menu Bar Extra

@main
struct __APP_NAME__App: App {
    var body: some Scene {
        MenuBarExtra("__APP_NAME__", systemImage: "star.fill") {
            ContentView()
        }
        .menuBarExtraStyle(.window)
    }
}

Utility (Single Window)

@main
struct __APP_NAME__App: App {
    var body: some Scene {
        Window("__APP_NAME__", id: "main") {
            ContentView()
        }
        .defaultSize(width: 600, height: 400)
    }
}

5. Post-Scaffold Checklist

Cross-References

• apple-app-architect:swift-app-lifecycle — scene structure details
• apple-app-builder:xcode-mcp — BuildProject, diagnostics, previews, and targeted tests