Ioniconf 2022 logo

Uniting our global community of Ionic developers and contributors. May 25, 2022.

Cordova to Capacitor Migration

A modern development experience and 99% backward-compatibility with Cordova.

01

Create a new code branch.

Recommended, but not required.

02

Install Capacitor.

Create the Capacitor app using the Cordova app's name and id found in `config.xml`.

03

Build the Web App.

The compiled web assets will be copied into each Capacitor native platform during the next step.

04

Install the native platforms you want to target.

AppleAndroid

Capacitor native projects exist in their own top-level folders and should be considered part of your app (check them into source control). Any existing Cordova plugins are automatically installed into each native project. 🎉

05

Recreate Splash Screens and Icons.

Reuse the existing splash screen/icon images, located in the top-level `resources` folder of your Cordova project, using the `cordova-res` tool. Images are copied into each native project.

06

Audit existing Cordova plugins.

Review all of Capacitor's core and community plugins. You may be able to switch to the Capacitor-equivalent Cordova plugin, such as the Camera.

Remove unneeded ones to improve performance and reduce app size.

07

Remove Cordova from your project.

After successful migration testing, Cordova can be removed from the project.

The latest updates. Delivered monthly.

Capacitor is getting better every day. Sign up for a monthly email on the latest updates, releases, articles, and news!