https://github.com/cameroncooke/xcodebuildmcp-ios-template
A scaffold template for iOS app projects
https://github.com/cameroncooke/xcodebuildmcp-ios-template
Last synced: 17 days ago
JSON representation
A scaffold template for iOS app projects
- Host: GitHub
- URL: https://github.com/cameroncooke/xcodebuildmcp-ios-template
- Owner: cameroncooke
- License: mit
- Created: 2025-06-03T12:12:10.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-13T14:03:36.000Z (4 months ago)
- Last Synced: 2025-09-14T20:58:57.739Z (24 days ago)
- Language: Shell
- Size: 87.9 KB
- Stars: 34
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/cameroncooke/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:
```bash
# 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](https://github.com/cameroncooke/XcodeBuildMCP-iOS-Template/releases).
## 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 name
- `com.example.MyProject` → Your bundle identifier
- `MyProjectFeature` → 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](https://github.com/cameroncooke/XcodeBuildMCP) - AI-powered Xcode build and development tools
- [XcodeBuildMCP macOS Template](https://github.com/cameroncooke/XcodeBuildMCP-macOS-Template) - macOS app template
---
Generated with ❤️ for the Swift community