Migrating To Tuist Generated Projects

What it does

This skill enables AI agents to migrate existing CocoaPods or Carthage-based iOS projects into Tuist-generated project structures. It automates the conversion of dependency graphs and configuration files, ensuring a seamless transition to Tuist's modern build system without manual restructuring.

When to use it

• You are maintaining a legacy iOS codebase relying on CocoaPods that needs modernization for better performance.
• Your team wants to switch from Carthage to Tuist to leverage automatic dependency graph management and faster builds.
• You need to refactor an existing project to adopt Tuist's generated Xcode project files while preserving current logic.
• You are preparing a codebase for integration into a CI/CD pipeline that requires the consistency of Tuist-generated projects.

Key capabilities

• Converts CocoaPods Podfile configurations into Tuist-compatible dependency definitions.
• Transforms Carthage framework lists into Tuist's native module graph structure.
• Generates complete Xcode project files automatically based on the migrated configuration.
• Preserves existing source code and asset structures during the migration process.

Example prompts

• "Migrate my current iOS project using CocoaPods to a Tuist-generated project structure."
• "Convert my Carthage-based dependency setup into a Tuist module graph for an existing app."
• "Refactor this legacy Xcode project to use Tuist, keeping all source files intact."

Tips & gotchas

Ensure your source project has a valid Podfile or Cartfile before initiating the migration, as the skill relies on these files to map dependencies. After migration, verify that all custom build settings and scripts are correctly transferred to the new Tuist configuration to avoid build failures.