ionic-enterprise-sdk-migration

Migrates Capacitor apps from discontinued Ionic Enterprise SDK plugins to Capawesome replacements.

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/involvex/ionic-everywhere --skill ionic-enterprise-sdk-migration-involvex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ionic-enterprise-sdk-migration
Source: https://github.com/involvex/ionic-everywhere/tree/main/.agents/skills/ionic-enterprise-sdk-migration
Command: npx skills add https://github.com/involvex/ionic-everywhere --skill ionic-enterprise-sdk-migration-involvex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Ionic Enterprise SDK plugins (Auth Connect, Identity Vault, Secure Storage) are discontinued, leaving Capacitor apps dependent on unmaintained packages. This Skill guides an agent through replacing them with maintained Capawesome alternatives while preserving existing app behavior and stored data. ## Core Features & Use Cases - Dependency Detection: Scans package.json for @ionic-enterprise/auth, @ionic-enterprise/identity-vault, and @ionic-enterprise/secure-storage before starting migration. - Side-by-Side API Mapping: Provides feature mapping tables and before/after code replacements for OAuth, Vault, Biometrics, Secure Preferences, and SQLite plugins. - Data Migration Strategies: Supports both preserve-data gradual cutover and hard cutover strategies for Identity Vault, including runtime export/import of vault contents. - Use Case: A team with a production Capacitor 7 app using Auth Connect and Identity Vault needs to move off the discontinued SDK. The agent detects both plugins, configures the Capawesome npm registry, replaces login/refresh/logout calls with the OAuth plugin, and migrates vault data at runtime without users losing stored credentials. ## Quick Start Ask the agent to migrate the Ionic Enterprise plugins in this Capacitor project to their Capawesome replacements.

Frequently Asked Questions about ionic-enterprise-sdk-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate from Ionic Auth Connect to Capawesome OAuth?

Uninstall @ionic-enterprise/auth, install @capawesome-team/capacitor-oauth, then replace AuthConnect.login with Oauth.login using an issuerUrl instead of a discovery URL. The Capawesome plugin needs no setup call and takes scopes as an array rather than a space-delimited string.

What replaces Ionic Identity Vault after discontinuation?

The Capawesome Vault plugin (@capawesome-team/capacitor-vault) is a near drop-in replacement supporting biometric unlock, auto-lock, and lock/unlock events. Add @capawesome-team/capacitor-biometrics only if the app uses Identity Vault's Device class for hardware checks.

Can I preserve existing Identity Vault data during migration?

Yes, keep both plugins installed temporarily and run a runtime migration that unlocks the legacy vault, calls exportVault(), and imports the data into the Capawesome Vault via importData(). Remove Identity Vault in a later release after the migration has run on user devices.

Does Capawesome Secure Preferences encrypt data on the web?

No, Capawesome Secure Preferences stores values unencrypted in localStorage on the web platform. This is intended for development only and should not be used in production web deployments.

Why does npm install fail for @capawesome-team packages?

Installation fails with 404 or authentication errors when the Capawesome npm registry is not configured. Set @capawesome-team:registry to https://npm.registry.capawesome.io and provide your Insiders license key as the auth token.

When should I not use this migration skill?

Do not use it for upgrading Capacitor versions, setting up Capawesome Cloud, or migrating non-Capacitor mobile frameworks. It only covers replacing Ionic Enterprise SDK plugins with Capawesome alternatives in Capacitor 6, 7, or 8 apps.