tuist
Best practices for Tuist projects. Use when working with Tuist manifests, generating projects, or building with xcodebuild in Tuist projects.
When & Why to Use This Skill
This Claude skill provides expert guidance and automation snippets for Tuist, a tool designed to scale Xcode projects. It streamlines the management of Swift-based project manifests, optimizes build performance with advanced xcodebuild configurations, and simplifies CI/CD integration for iOS and macOS development teams.
Use Cases
- Xcode Project Generation: Automate the creation of .xcodeproj and .xcworkspace files from Swift manifests to prevent git merge conflicts and maintain project consistency.
- Build Performance Tuning: Implement compilation caching and integrated driver settings to significantly accelerate build times for large-scale Swift applications.
- CI/CD Pipeline Optimization: Configure headless builds for CI agents by disabling code signing and utilizing optimized build settings for automated environments.
- Modular Architecture Management: Use buildable folders and efficient target declarations to manage complex, multi-module projects without the overhead of manual Xcode configuration.
| name | tuist |
|---|---|
| description | Best practices for Tuist projects. Use when working with Tuist manifests, generating projects, or building with xcodebuild in Tuist projects. |
Tuist
Project Generation
Generate projects without opening Xcode:
tuist generate --no-open
Target Declaration
Use buildableFolders when declaring targets to avoid regenerating projects on file changes:
let target = Target(
name: "MyApp",
destinations: [.iPhone],
product: .app,
bundleId: "com.example.app",
buildableFolders: ["Sources/", "Resources/"]
)
Building with xcodebuild
Pass these build settings to enable caching and improve build performance:
xcodebuild build \
-scheme MyScheme \
COMPILATION_CACHE_ENABLE_CACHING=YES \
CLANG_ENABLE_COMPILE_CACHE=YES \
SWIFT_ENABLE_EXPLICIT_MODULES=YES \
SWIFT_USE_INTEGRATED_DRIVER=YES
Disable Signing for CI/Agent Builds
When building through an agent or CI, disable code signing:
xcodebuild build \
-scheme MyScheme \
CODE_SIGN_IDENTITY=""