XcodeBuildMCP macOS Template

A modern macOS application template using a workspace + SPM package architecture for clean separation between app shell and feature code. This template is designed to be used with XcodeBuildMCP.

Features

• ✨ Modern Architecture: Workspace + Swift Package Manager structure
• 📦 Clean Separation: Minimal app shell with features in SPM package
• 🏗️ Buildable Folders: Xcode 16 support for automatic file discovery
• 🧪 Test Ready: Preconfigured with Swift Testing and XCUITest
• ⚙️ XCConfig Based: Build settings managed through configuration files
• 🔒 App Sandbox: Configured with basic entitlements
• 🚀 AI-Friendly: Designed for use with AI coding assistants

Quick Start

Using XcodeBuildMCP

The easiest way to use this template is through XcodeBuildMCP:

# Using the XcodeBuildMCP tool
mcp scaffold_macos_project --projectName "YourApp" --outputPath "./YourApp"

Manual Download

You can also download the template directly from the releases page.

Template Structure

template/
├── Config/                         # XCConfig build settings
│   ├── Debug.xcconfig
│   ├── Release.xcconfig
│   ├── Shared.xcconfig
│   └── Tests.xcconfig
├── MyProject.xcworkspace/          # Workspace file
├── MyProject.xcodeproj/            # App shell project
├── MyProject/                      # App target (minimal)
│   ├── Assets.xcassets/
│   ├── MyProjectApp.swift
│   ├── MyProject.entitlements      # App sandbox settings
│   └── MyProject.xctestplan
├── MyProjectPackage/               # SPM package for features
│   ├── Package.swift
│   ├── Sources/
│   └── Tests/
└── MyProjectUITests/               # UI automation tests

Customization

When using this template, the following placeholders will be replaced:

• MyProject → Your project name
• com.example.MyProject → Your bundle identifier
• MyProjectFeature → Your feature module name
• Build settings can be customized in the Config/ XCConfig files
• App sandbox entitlements can be modified in MyProject.entitlements

Requirements

• Xcode 16.0 or later
• macOS 15.0+ deployment target (configurable)
• Swift 6.0

macOS-Specific Features

This template includes:

• App Sandbox: Configured with basic file and network access
• Window Management: Ready for multiple windows and settings
• Menu Bar: Standard macOS menu structure
• Document Support: Can be extended for document-based apps

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This template is available under the MIT license. See the LICENSE file for more info.

Related Projects

• XcodeBuildMCP - AI-powered Xcode build and development tools
• XcodeBuildMCP iOS Template - iOS app template

---

Generated with ❤️ for the Swift community