Cocoapods To Spm

Migrates Capacitor iOS apps from CocoaPods to Swift Package Manager, the default in Capacitor 8+. Walks you through `npx cap spm-migration-assistant`, preserving native customizations like entitlements and signing configs, or shows when to nuke and re-scaffold `ios/` cleanly. The catch is every plugin in your `package.json` needs SPM support before you can fully switch, so you'll check compatibility first or swap out stragglers. Covers both the automated CLI path and manual Xcode surgery. Useful if you're upgrading to Cap 8 or just tired of maintaining a `Podfile` when the rest of the ecosystem moved on.

skills.sh installs: 836
GitHub stars: 77
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add cap-go/capgo-skills --skill cocoapods-to-spm --agent claude-code

Installs into .claude/skills of the current project.

Files

CocoaPods to Swift Package Manager Migration

Move a Capacitor iOS app from CocoaPods to SPM without losing native project customizations.

When to Use

TRIGGER when:

ios/App/Podfile, Pods/, Podfile.lock, or App.xcworkspace exists and the user wants SPM.
User asks about npx cap spm-migration-assistant, CapApp-SPM, debug.xcconfig, or --packagemanager SPM.
User worries about CocoaPods Trunk becoming read-only (expected December 2, 2026), or about pods that can no longer be published/updated.
npx cap sync warns Some installed Capacitor plugins are not compatible with SPM or <plugin id> does not have a Package.swift.
Upgrading to Capacitor 9 and wanting to drop CocoaPods at the same time.

Do not use:

Adding Package.swift / CAPBridgedPlugin to a plugin you maintain -> capacitor-plugin-spm-support.
SceneDelegate / UIScene adoption (Capacitor 8.5+, required by Xcode 27) -> capacitor-uiscene-migration.
The Capacitor major upgrade itself -> capacitor-app-upgrades, capacitor-app-upgrade-v8-to-v9.
Build or runtime failures unrelated to dependency management -> debugging-capacitor.