Migration tool to assist users in upgrading between versions of Dojo
Clone or download



The official CLI command for upgrading Dojo applications.



This command requires the @dojo/cli package to be installed globally.

npm install --global @dojo/cli


To use the @dojo/cli-upgrade-app in a single project, install the package using npm.

npm install @dojo/cli-upgrade-app

Basic Usage

Within the root of a Dojo application the command can be used with the upgrade command.

dojo upgrade


We appreciate your interest! Please see the Dojo 2 Meta Repository for the Contributing Guidelines.

Version upgrades are defined in directories starting with "v" and the major version number, (e.g. v3). Each version's configuration should be exported as config from a main.ts file in the directory.


After running npm install, run the npm build script

npm run build


Test cases should be written using Intern To test, run the npm test command.

npm test

Licensing Information

© 2018 JS Foundation. New BSD license.