XcodeBuildMCP iOS Template
A modern iOS 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
- ๐ 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_ios_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.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 namecom.example.MyProjectโ Your bundle identifierMyProjectFeatureโ Your feature module name- Build settings can be customized in the
Config/XCConfig files
Requirements
- Xcode 16.0 or later
- iOS 18.0+ deployment target (configurable)
- Swift 6.0
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 macOS Template - macOS app template
Generated with โค๏ธ for the Swift community