Capacitor App Upgrade V5 To V6
- 360 installs
- 57 repo stars
- Updated July 13, 2026
- cap-go/capgo-skills
capacitor-app-upgrade-v5-to-v6 is an agent skill that migrates an existing Capacitor v5 project to Capacitor v6 without breaking native builds, plugins, or CI release pipelines for developers maintaining hybrid mobile ap
About
capacitor-app-upgrade-v5-to-v6 is an agent skill from cap-go/capgo-skills that walks developers through upgrading a Capacitor v5 hybrid mobile application to Capacitor v6. The skill addresses breaking changes across native iOS and Android projects, Capacitor configuration files, plugin compatibility, and CI release pipelines so builds keep passing after the major version bump. Developers reach for capacitor-app-upgrade-v5-to-v6 when Capacitor v6 features or security fixes require migration, plugin vendors drop v5 support, or native toolchain updates fail against an outdated Capacitor baseline. The migration skill focuses on preserving working Xcode and Gradle builds while updating JavaScript and native bridge APIs, making it essential during mobile frontend maintenance rather than greenfield app creation. Invoke when asked to upgrade Capacitor from v5 to v6, fix post-migration native build errors, or align plugins and CI with Capacitor 6 requirements.
- Capacitor v5 to v6 breaking-change inventory
- package.json, CLI, and native project sync steps
- Android Gradle and iOS Xcode setting updates
- Plugin compatibility checks and replacement guidance
- Post-upgrade build, run, and regression validation
Capacitor App Upgrade V5 To V6 by the numbers
- 360 all-time installs (skills.sh)
- Ranked #350 of 1,039 Mobile Development skills by installs in the Skillselion catalog
- Data as of Aug 1, 2026 (Skillselion catalog sync)
npx skills add https://github.com/cap-go/capgo-skills --skill capacitor-app-upgrade-v5-to-v6Add your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 360 |
|---|---|
| repo stars | ★ 57 |
| Last updated | July 13, 2026 |
| Repository | cap-go/capgo-skills ↗ |
How do you upgrade Capacitor v5 apps to v6?
Migrate an existing Capacitor v5 project to v6 without breaking native builds, plugins, or CI release pipelines.
Who is it for?
Developers maintaining Capacitor v5 hybrid iOS and Android apps who need a guided v6 migration without breaking native builds or CI.
Skip if: Greenfield Capacitor app scaffolding or teams still on Capacitor v4 who should migrate to v5 first with capacitor-plugin-upgrade-v4-to-v5.
When should I use this skill?
User asks to upgrade Capacitor from v5 to v6, fix Capacitor 6 migration build errors, or update plugins and CI for Capacitor v6.
What you get
Capacitor v6 project with updated native builds, compatible plugins, revised config files, and passing CI release pipeline.
- Upgraded Capacitor v6 project
- Updated native iOS and Android build configs
Files
Capacitor App Upgrade v5 to v6
Upgrade a Capacitor app from version 5 to version 6.
When to Use This Skill
- User says the app is on Capacitor 5 and must move to v6
- User wants the exact v5 to v6 migration path
- User needs v6-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
1. Start from the injected package snapshot and confirm the current @capacitor/core version. 2. Update all @capacitor/* packages to the v6-compatible range. 3. Review the v5 to v6 migration notes before editing native files. 4. Run npm install. 5. Sync with npx cap sync. 6. 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 6.
- If Android fails, check the Gradle and Java requirements for Capacitor 6.
{
"version": "1.0.0",
"organization": "Capgo",
"date": "March 2026",
"abstract": "Version-specific guide for upgrading a Capacitor app from v5 to v6.",
"triggers": [
"capacitor 5 to 6",
"upgrade app to capacitor 6",
"v5 to v6 migration",
"capacitor app upgrade v6"
],
"references": [
"https://capacitorjs.com/docs"
]
}
Related skills
Xcode Project SetupAutomatically create and configure a new Xcode project with Swift Package Manager dependencies for iOS or macOS agent projects.74.7k392
Expo Tailwind SetupInstantly configure Tailwind CSS v4 with NativeWind v5 and react-native-css inside an Expo project for universal styling.46.7k2.3kExpo Dev ClientCreate custom development clients for Expo React Native apps that need native modules or Apple-specific targets.45.9k2.3k
Swiftui Expert SkillGet expert guidance when writing, reviewing, or refactoring SwiftUI views, state, performance, and modern iOS/macOS APIs.27.6k3.3k
Flutter Apply Architecture Best PracticesEnforce clean layered architecture when creating or refactoring a Flutter mobile application.25.4k2.7kExpo ModuleCreate custom config plugins that safely modify native Android and iOS projects generated by Expo prebuild.25k2.3kFAQ
What does capacitor-app-upgrade-v5-to-v6 change?
capacitor-app-upgrade-v5-to-v6 migrates Capacitor v5 projects to v6, updating native iOS and Android builds, configuration files, plugin APIs, and CI release steps without breaking hybrid app compilation.
Should capacitor plugins be upgraded separately?
capacitor-app-upgrade-v5-to-v6 covers the app-level v5 to v6 migration. Individual Capacitor plugins may need separate version upgrades if their APIs changed between Capacitor major releases.