tuist

tuist's avatarfrom tuist

Best practices for Tuist projects. Use when working with Tuist manifests, generating projects, or building with xcodebuild in Tuist projects.

⭐33stars🔀2forks📁View on GitHub🕐Updated Dec 13, 2025

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.
nametuist
descriptionBest 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=""