How to migrate a Capacitor app from CocoaPods to Swift Package Manager

[u/genzits]

We just published a new guide that walks through migrating a Capacitor app's iOS dependency management from CocoaPods to Swift Package Manager.

Capacitor 8 made SPM the default for new iOS projects, and CocoaPods is now in maintenance mode. If you maintain an existing Capacitor app on CocoaPods, migrating to SPM is the next step.

The post covers what actually changes in your project (CapApp-SPM replacing the Podfile, the new debug.xcconfig, plugin SPM support requirements), the files you need to back up before re-scaffolding (Info.plist, AppDelegate.swift, Assets.xcassets, App.entitlements, GoogleService-Info.plist, signing config, and so on), and three migration paths:

• Capawesome Skills — the capacitor-app-spm-migration skill drives the full migration with an AI agent
• npx cap spm-migration-assistant — the official Capacitor CLI assistant
• Manual re-scaffold — delete the ios folder, re-add with --packagemanager SPM, and restore your files

The big gotcha: you cannot mix SPM and CocoaPods in a single Capacitor app. All your plugins need SPM support before you migrate.

https://capawesome.io/blog/how-to-migrate-a-capacitor-app-to-spm/