# Key Differences

Before migrating your PhoneGap projects into Monaca, you should read through some key differences between PhoneGap and Monaca projects in order to have a seamless migration.

## File and folder structures

File and folder structures of Monaca and PhoneGap projects are quite different:

### PhoneGap project structure

```markup
Project
├── config.xml
├── hooks
├── platforms
├── plugins
└── www
    ├── css
    ├── img
    ├── index.html
    ├── js
    ├── res
    │   ├── icon
    │   └── screen
    ├── spec
    └── spec.html
```

### Monaca project structure

```markup
Project
├── config.xml
├── package.json
├── plugins
├── res
│   ├── android
│   ├── ios
│   └── winrt
└── www
    ├── components
    ├── css
    └── index.html
```

The main differences are `res` folder location and `package.json` file.\
In Monaca project, the default `res` folder is stored in the root folder. But if the `src` attribute of the project's `config.xml` file is set correctly, the default `res` folder is not used. Moreover, `package.json` file is required and used for managing the Cordova plugins.

Because of these differences, when importing a PhoneGap project into Monaca, some files and folders will be changed.

## 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. If you want to use a lower version, please [contact us](https://monaca.io/service/index.html).

| Cordova           | Android platform | iOS platform | Windows platform (electron) |
| ----------------- | ---------------- | ------------ | --------------------------- |
| **cordova-9.0.0** | **8.0.0**        | **5.0.1**    | **1.1.1**                   |

For more information about build environments for lower Cordova versions, pleaser refer to[ Supported environments](https://en.docs.monaca.io/environment).

## Remarks

When migrating a project into Monaca, there are a few things you should be aware of:

### Some installed plugins may disappear

In Monaca, 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 them again into Monaca. Please refer to [Importing Cordova plugins](https://en.docs.monaca.io/products_guide/migration/phonegap_migration/broken-reference).

### Using third party Cordova plugins requires a custom debugger

The store version Monaca Debugger (found in Google play or AppStore) includes only the [core Cordova plugins](https://en.docs.monaca.io/reference/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. Custom debugger will only include the plugins used in the project. Please refer to:

* [Build custom debugger for iOS](https://en.docs.monaca.io/debugger/installation/debugger_ios#building-a-custom-monaca-debugger)
* [Build custom debugger for Android](https://en.docs.monaca.io/debugger/installation/debugger_android#build-and-install-a-custom-monaca-debugger)

## Managing the CSS/JavaScript libraries

In the Monaca Cloud IDE, there is a GUI page for managing the CSS/JavaScript libraries. You can see it by going to **Configure → JS/CSS Component Settings**.

![](https://3091308003-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MfWe1U2tFctp8FkP9W8%2F-Mg9OHFSADb5YTniXKnf%2F-Mg9PT2upyH6_crqFSEU%2Fimage.png?alt=media\&token=bd8a0013-f6ea-4ac9-9aec-d71ad5a8bf62)

You can then add the CSS/JavaScript libraries you need. However, this works only if you include the following lines in the `index.html` file:

```markup
<!--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:

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