Migrating To Tuist Generated Projects

What it does

This skill enables AI agents to migrate existing iOS and macOS projects from CocoaPods or Carthage into Tuist-generated architectures. It automates the conversion of dependency graphs, schemes, and targets while preserving project structure and configuration settings.

When to use it

• You are maintaining a legacy Objective-C or Swift codebase relying on CocoaPods or Carthage for dependency management.
• Your team needs to unify multiple modules into a single, scalable build system with improved performance.
• You require better IDE integration, faster build times, and more reliable dependency resolution than manual Xcode projects provide.
• You want to transition from fragile Podfile configurations to a declarative Project.swift model managed by Tuist.

Key capabilities

• Automatically converts existing CocoaPods or Carthage dependencies into Tuist-compatible targets.
• Generates a complete Project.swift file that defines the entire project structure and build rules.
• Preserves original source code, schemes, and configuration settings during migration.
• Handles complex module hierarchies and framework integrations seamlessly.

Example prompts

• "Migrate my existing iOS project from CocoaPods to Tuist while keeping all current dependencies."
• "Convert this Carthage-based macOS application into a Tuist-generated project with updated schemes."
• "Automate the migration of our multi-module Swift codebase to use Tuist instead of manual Xcode projects."

Tips & gotchas

Ensure your source project has a valid Podfile or Cartfile before initiating the migration, as these files are required for dependency analysis. After migration, verify that all build configurations and signing settings are correctly transferred to avoid runtime issues in production environments.