Capacitor App Upgrade (router)

Plan and run a Capacitor app upgrade one hop at a time, using the version-specific skill for each hop.

When to Use

TRIGGER when:

• User wants to upgrade a Capacitor app and the start or target version is unknown or more than one major apart
• User asks for "the latest Capacitor" (decide stable 8.5.x vs prerelease 9 with them)
• Xcode 27 builds fail on a Capacitor 8.4-or-older app (needs the 8.5 UIScene step)
• npx cap migrate failed midway and the user needs to know where they are

Do not use:

• Plugin library repos -> capacitor-plugin-upgrades
• Cordova/PhoneGap apps -> cordova-to-capacitor
• CocoaPods to SPM only -> cocoapods-to-spm

Live Project Snapshot