| name | capacitor-app-upgrade-v6-to-v7 |
| description | Guides the agent through upgrading a Capacitor app from v6 to v7. Use when the project is on Capacitor 6 and needs the v7 migration path. Do not use for other major versions, plugin-only upgrades, or non-Capacitor apps. |
| allowed-tools | ["Bash(node -e *)","Bash(npm *)","Bash(npx cap *)"] |
Capacitor App Upgrade v6 to v7
Upgrade a Capacitor app from version 6 to version 7.
When to Use This Skill
- User says the app is on Capacitor 6 and must move to v7
- User wants the exact v6 to v7 migration path
- User needs v7-specific native and package updates
Live Project Snapshot
Current Capacitor packages from package.json:
!node -e "const fs=require('fs');if(!fs.existsSync('package.json'))process.exit(0);const pkg=JSON.parse(fs.readFileSync('package.json','utf8'));const out=[];for(const section of ['dependencies','devDependencies']){for(const [name,version] of Object.entries(pkg[section]||{})){if(name.startsWith('@capacitor/'))out.push(section+'.'+name+'='+version)}}console.log(out.sort().join('\n'))"
Procedure
- Start from the injected package snapshot and confirm the current
@capacitor/core version.
- Update all
@capacitor/* packages to the v7-compatible range.
- Review the v6 to v7 migration notes before editing native files.
- Run
npm install.
- Sync with
npx cap sync.
- Verify the iOS and Android builds.
Error Handling
- If the automated migration misses a package, update it manually before syncing again.
- If iOS fails, check the deployment target and Xcode compatibility for Capacitor 7.
- If Android fails, check the Gradle and Java requirements for Capacitor 7.
