cocoapods-to-spm

Automate Capacitor iOS app migration from CocoaPods to Swift Package Manager.

1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Bigdrops/bigdrops-app --skill cocoapods-to-spm-bigdrops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cocoapods-to-spm
Source: https://github.com/Bigdrops/bigdrops-app/tree/main/.agents/skills/cocoapods-to-spm
Command: npx skills add https://github.com/Bigdrops/bigdrops-app --skill cocoapods-to-spm-bigdrops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies the process of migrating existing Capacitor iOS apps from using CocoaPods to Swift Package Manager (SPM), ensuring a seamless transition without losing native project customizations.

Core Features & Use Cases

  • Migration Assistant: Provides a command-line tool to automate the migration process, including removing CocoaPods artifacts and setting up the new SPM project structure.
  • Preservation of Customizations: Guides the user on preserving and restoring any native customizations, such as Info.plist files and custom source code.
  • Plugin Compatibility: Offers advice on how to handle plugin dependencies that may not support SPM, ensuring the migration process is not obstructed by incompatible plugins.

Quick Start

Migrate your Capacitor iOS app to SPM by running the command: npx cap spm-migration-assistant

Frequently Asked Questions about cocoapods-to-spm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my Capacitor iOS app from CocoaPods to Swift Package Manager?

To migrate your Capacitor iOS app from CocoaPods to Swift Package Manager, run the command `npx cap spm-migration-assistant`. This tool automates removing CocoaPods artifacts and setting up the new SPM project structure.

Will migrating to Swift Package Manager delete my native iOS project customizations?

Migrating to Swift Package Manager will not delete your native iOS customizations. The migration process specifically guides you on preserving and restoring custom files like Info.plist and custom source code during the transition.

What happens if my Capacitor plugins do not support Swift Package Manager?

If your Capacitor plugins do not support Swift Package Manager, the migration assistant provides advice on handling incompatible plugin dependencies. This ensures plugin compatibility issues do not obstruct the overall migration process.

Why should I transition my iOS app from CocoaPods to Swift Package Manager?

You should transition your iOS app from CocoaPods to Swift Package Manager to achieve better performance and maintainability. SPM provides a more integrated native experience for managing dependencies within Xcode.

Can I use the SPM migration assistant for any existing Capacitor iOS project?

You can use the SPM migration assistant for any existing Capacitor iOS project. It is specifically designed to transition projects currently using CocoaPods while handling plugin compatibility and maintaining native customizations.