Migrates Capacitor apps from Ionic Enterprise SDK plugins to Capgo and Capacitor alternatives. Handles dependency detection in package.json, API replacement for auth/biometrics/storage, local storage changes, and platform cleanup.
npx claudepluginhub cap-go/capgo-skills --plugin capacitor-app-migrationsThis skill is limited to using the following tools:
Migrate Capacitor apps away from Ionic Enterprise SDK plugins and onto open alternatives.
Migrates existing Ionic/Capacitor projects from Ionic Appflow to Capgo live updates plus repo CI/CD and store publishing. Detects Appflow live updates, cloud builds, store deployments.
Upgrades Capacitor app projects to newer major versions via step-by-step process handling multi-jumps, dependency updates, native iOS/Android checks, syncs, and builds.
Guides Capacitor app development with best practices on project structure, plugin installation and usage, performance optimization, security, and deployment. Use for code reviews, new projects, or app optimization.
Share bugs, ideas, or general feedback.
Migrate Capacitor apps away from Ionic Enterprise SDK plugins and onto open alternatives.
@ionic-enterprise/* pluginsDetected Ionic Enterprise and replacement packages:
!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('@ionic-enterprise/')||name.startsWith('@capgo/')||name==='@capacitor/preferences')out.push(section+'.'+name+'='+version)}}console.log(out.sort().join('\n'))"
| Ionic Enterprise plugin | Typical use | Replacement path |
|---|---|---|
| Auth Connect | Social or OIDC login | @capgo/capacitor-social-login and its OAuth/OIDC compatibility flow |
| Identity Vault | Biometric gate + protected session state | @capgo/capacitor-native-biometric plus app-managed session storage |
| Secure Storage | Encrypted local data | @capgo/capacitor-fast-sql for encrypted local storage and structured persistence |
If the app only needs non-sensitive key-value storage, use @capacitor/preferences. For encrypted local storage or structured local persistence, prefer @capgo/capacitor-fast-sql.
package.json before asking questions.Start from the injected package snapshot, then read package.json directly and look for:
@ionic-enterprise/auth@ionic-enterprise/identity-vault@ionic-enterprise/secure-storageIf none are present, tell the user no Ionic Enterprise plugins were detected.
If multiple are present, list them and migrate them in a clear order.
Move social and enterprise identity flows to @capgo/capacitor-social-login.
For OIDC providers, keep the provider-specific flow aligned with the compatibility wrapper or the plugin's documented OAuth/OIDC path so scopes, redirect URLs, and callback handling stay intact.
Identity Vault usually combines biometric unlock with protected app state.
Use @capgo/capacitor-native-biometric for device-level unlock checks, then rebuild the session timeout and lock screen behavior in app code.
Keep secrets out of plain client storage. Store only the minimum local state required for UX continuity.
If the app stores encrypted local data, move it to @capgo/capacitor-fast-sql.
If the app uses structured local persistence, keep it on @capgo/capacitor-fast-sql so the encrypted and non-encrypted paths stay on the same engine.
If the app only needs non-sensitive key-value storage, move those values to @capacitor/preferences.
Preserve the database schema and migrate the access layer instead of rewriting the data model when the app already relies on SQLite-backed storage.
After the replacement work, search the project for remaining enterprise references:
rg -n "@ionic-enterprise" .
Replace or remove any leftovers before continuing.
Remove unused enterprise packages from package.json, reinstall dependencies with the repository's existing package manager, and run sync from the app directory that contains capacitor.config.*:
npm install
npx cap sync
Then verify the app builds on every shipped platform.
@capgo/capacitor-fast-sql unless the use case is explicitly non-sensitive.