Upgrading from Angular 2 beta 17 to Angular 2 RC1

by Guido Tapia

in software-engineering,

May 10, 2016

Upgrading through the angular2 betas has been a bit of a pain with lots of breaking changes but it seemed manageable. However, upgrading to RC1 was bad… So in the hopes of helping others here is my step by step guide. Please note: This works on my project. If you have other dependencies I do not use this may not work for you.



To upgrade package.json remove “angular2”: “^2.0.0-beta.17” and replace with:

“@angular/common”: “2.0.0-rc.1”,

“@angular/compiler”: “2.0.0-rc.1”,

“@angular/core”: “2.0.0-rc.1”,

“@angular/http”: “2.0.0-rc.1”,

“@angular/platform-browser”: “2.0.0-rc.1”,

“@angular/platform-browser-dynamic”: “2.0.0-rc.1”,

“@angular/router”: “2.0.0-rc.1”,

“@angular/router-deprecated”: “2.0.0-rc.1”,

“@angular/upgrade”: “2.0.0-rc.1”


Also ensure these dependencies are also at compatible versions:

“es6-promise”: “^3.0.2”,

“es6-shim”: “^0.35.0”,

“reflect-metadata”: “0.1.2”,

“rxjs”: “^5.0.0-beta.6”,

“systemjs”: “^0.19.8”,

“zone.js”: “^0.6.12”


Delete your node_modules directory

Run npm install to set up new dependencies



Update your build tool to copy node_modules/@angular/**/index.js to your application directory. If you read your libraries straight from node_modules then this step is not required.



I use index.html to set up my system.js so here is how to get going:

Remove old angular2 scripts, mine were:


And this is my copy of my System.js configuration:


packages: {

‘app’ : {format: ‘register’, defaultExtension: ‘js’},

‘@angular/core’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/common’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/compiler’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/router’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/router-deprecated’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/http’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/platform-browser’ : {defaultExtension: ‘js’, main: ‘index.js’},

‘@angular/platform-browser-dynamic’: {defaultExtension: ‘js’, main: ‘index.js’}


map: {

‘@angular/core’ : ‘lib/@angular/core’,

‘@angular/common’ : ‘lib/@angular/common’,

‘@angular/compiler’ : ‘lib/@angular/compiler’,

‘@angular/router’ : ‘lib/@angular/router’,

‘@angular/router-deprecated’ : ‘lib/@angular/router-deprecated’,

‘@angular/http’ : ‘lib/@angular/http’,

‘@angular/platform-browser’ : ‘lib/@angular/platform-browser’,

‘@angular/platform-browser-dynamic’: ‘lib/@angular/platform-browser-dynamic’




Now the fun part, lets fix all the broken angular imports:

import {bootstrap} from ‘angular2/platform/browser’ -> import {bootstrap} from ‘@angular/platform-browser-dynamic’

import … from ‘angular2/router’ -> import … from ‘@angular/router-deprecated’;

You can safely do a search and replace for “from ‘angular2/” -> “from ‘@angular/”



A note on router

I am using router-deprecated as changing to the new router is evil and beyond the scope or sanity of this document and developer.

For deprecated router to work you still need to add the following:

Ensure you have this as one of your application providers: provide(APP_BASE_HREF, { useValue: ’/’ }). Example:

import {APP_BASE_HREF} from ‘@angular/common’;

import {provide} from ‘@angular/core’;

import {ROUTER_PROVIDERS} from ‘@angular/router-deprecated’;


selector: ‘app’,

templateUrl: ‘app/layout/app.html’,

directives: [ROUTER_DIRECTIVES],

providers: [ROUTER_PROVIDERS, provide(APP_BASE_HREF, { useValue: ’/’ })]


Hope the pain in the last few hours at least helps someone out there. And please do not try to upgrade to the new router yet. It is nasty!