<aside> ⚠️ The guide is written to upgrade:
Starting from earlier versions might work, but it’s not guaranteed (it will probably need extra work). Note: there is an older guide to upgrade to Angular v16.
</aside>
<aside> 🎏 References:
<aside> 🆚 Before to start, make sure your developer tools are updated to the versions stated in our Development basics guide.
</aside>
Locate the front-end folder.
In the package.json file remove any @idea-ionic/xxx package. Then, run npm i.
Run ng update --allow-dirty @angular/core@17 @angular/cli@17 which should bring you to version 17 of Angular.
Remove the package-lock.json file and the node_modules folder.
Replace the content of angular.json file with the following one, make sure to adapt it in case of specific changes in the project.
angular.json of cloud-app-starter project (front-end).In the package.json file, refer to to the following versions for dependencies and devDependencies and manually fix the packages versions so that all of IDEA’s projects are aligned to the very same state. Note: you don’t have to add packages that your codebase don’t need; also: there could be some packages missing from the list.
package.json of cloud-app-starter project (front-end).Add the following piece of code at the end of the file, to support Ionic’s dynamic font scaling:
variables.scss of cloud-app-starter project (front-end).Run a npm i to reinstall everything from a clean state.
From the front-end folder, run npm i PACKAGE@latest, for each of the following packages:
idea-toolbox.@idea-ionic/xxx and other packages removed in the first steps.<aside> ⚠️ When updating these libraries, check the release notes from the previous version to make according changes.
</aside>