Key Points

Before starting the migration of your projects into Monaca, there are some key points you need to pay attention to in order to have a seamless migration.

Build environment

Before getting started with the migration, you may want to know about the supported Cordova versions and build environments in Monaca.

All newly created projects in Monaca will be using the latest supported Cordova version by default.


Android platform

iOS platform

Windows platform (electron)





For more information on build environments for lower Cordova versions, pleaser refer to Supported Environments.

Installed plugins

In Monaca, the Cordova plugins are managed by the package.json file. If your plugin information is defined in the config.xml file, you will need to import the plugins again into Monaca. Please refer to Importing Cordova plugins.

Third party Cordova plugins

The store-version Monaca Debugger (found in Google play or AppStore) only includes the core Cordova plugins. If your project contains any third party Cordova plugins besides the core Cordova plugins, you will need to build a custom debugger to test it. A custom debugger will only include the plugins used in the project. Please refer to:

JS/CSS component

There is a GUI page for you to manage the CSS/JavaScript libraries.

  • For the Monaca CLI, you can open the GUI page by running monaca remote config in the project directory.

  • For the Monaca Localkit, you can go there by clicking the Settings menu.

On the JS/JSS components page, you can add CSS/JavaScript libraries to your project. However, this works only if you include the following lines in your index.html file:

<!--Load selected JavaScript libraries-->
<script src="components/loader.js"></script>
<!--Load selected CSS libraries-->
<link rel="stylesheet" href="components/loader.css">

Please note that the loader.js file loads also the cordova.js file. Therefore, if you are going to include the above lines, you can remove this line:

<script src="cordova.js"></script>

Output directory

Lastly, please notice the following points since they are important when working with the Monaca Debugger and the Monaca Build Server.

  • The output folder for the building process must be www. You may need to change the build output to www.

  • Make sure that opening the index.html file over file:// works. For example, you may need to set <base href="./" in the index.html file.

See Also:

Last updated