Capacitor App Upgrade V4 To V5
- 359 installs
- 57 repo stars
- Updated July 13, 2026
- cap-go/capgo-skills
capacitor-app-upgrade-v4-to-v5 is a Capgo agent skill that guides step-by-step migration of Capacitor 4 hybrid apps to Capacitor 5 for developers who must update packages, native settings, and sync iOS/Android projects.
About
capacitor-app-upgrade-v4-to-v5 is a Capgo agent skill in cap-go/capgo-skills that walks through upgrading a Capacitor hybrid app from version 4 to version 5. The skill snapshots current @capacitor/* versions from package.json, updates all packages to v5-compatible ranges, reviews official v4-to-v5 migration notes before editing native files, runs npm install and npx cap sync, then verifies iOS and Android builds. It includes Bash allowed-tools for reading dependency versions and documents error handling for missed packages, iOS deployment targets, and Android Gradle/Java requirements. Developers reach for capacitor-app-upgrade-v4-to-v5 when package.json shows @capacitor/core v4 and the team needs the exact v5 migration path—not plugin-only bumps or other major versions.
- Capacitor v4 to v5 dependency and CLI upgrades
- Breaking API and config migration checklist
- Plugin and native project compatibility fixes
- Incremental verification on iOS and Android
Capacitor App Upgrade V4 To V5 by the numbers
- 359 all-time installs (skills.sh)
- Ranked #351 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-v4-to-v5Add your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 359 |
|---|---|
| repo stars | ★ 57 |
| Last updated | July 13, 2026 |
| Repository | cap-go/capgo-skills ↗ |
How do you migrate Capacitor 4 to Capacitor 5?
Migrate an existing Capacitor v4 codebase to v5, updating dependencies, breaking API changes, plugin compatibility, and native project settings step by step.
Who is it for?
Mobile developers maintaining Capacitor 4 hybrid apps who need a guided v4-to-v5 upgrade covering npm packages, cap sync, and native build verification.
Skip if: Skip capacitor-app-upgrade-v4-to-v5 when the app is already on Capacitor 5+, you only need a single plugin update, or the project is React Native or Flutter rather than Capacitor.
When should I use this skill?
User says the app is on Capacitor 4 and must move to v5, or asks for the exact v4-to-v5 migration procedure.
What you get
Updated package.json with v5 @capacitor/* ranges, synced native iOS/Android projects, and verified platform builds.
- Updated package.json with v5 @capacitor/* ranges
- Synced iOS and Android native directories
By the numbers
- 6-step v4-to-v5 migration procedure in SKILL.md
- Reads all @capacitor/* packages from package.json before editing
- Runs npx cap sync after npm install for native project sync
Files
Capacitor App Upgrade v4 to v5
Upgrade a Capacitor app from version 4 to version 5.
When to Use This Skill
- User says the app is on Capacitor 4 and must move to v5
- User wants the exact v4 to v5 migration path
- User needs v5-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 v5-compatible range. 3. Review the v4 to v5 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 5.
- If Android fails, check the Gradle and Java requirements for Capacitor 5.
{
"version": "1.0.0",
"organization": "Capgo",
"date": "March 2026",
"abstract": "Version-specific guide for upgrading a Capacitor app from v4 to v5.",
"triggers": [
"capacitor 4 to 5",
"upgrade app to capacitor 5",
"v4 to v5 migration",
"capacitor app upgrade v5"
],
"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.3kHow it compares
Pick capacitor-app-upgrade-v4-to-v5 over generic dependency bump skills when you need Capacitor-specific v4-to-v5 migration notes plus iOS/Android native verification steps.
FAQ
What steps does capacitor-app-upgrade-v4-to-v5 follow?
capacitor-app-upgrade-v4-to-v5 follows six steps: confirm @capacitor/core from package.json, update all @capacitor/* packages to v5 ranges, review v4-to-v5 migration notes, run npm install, run npx cap sync, and verify iOS and Android builds.
When should you not use capacitor-app-upgrade-v4-to-v5?
Do not use capacitor-app-upgrade-v4-to-v5 for Capacitor versions other than v4-to-v5, plugin-only upgrades, or non-Capacitor mobile projects. The skill description explicitly limits scope to the v4-to-v5 major migration path.
How does the skill read current Capacitor versions?
capacitor-app-upgrade-v4-to-v5 injects a Bash node script that parses package.json dependencies and devDependencies, listing every @capacitor/* package and its installed version before any upgrade edits begin.