4.0 KiB

Raw Blame History

<img src="https://cloud.githubusercontent.com/assets/1016365/10639063/138338bc-7806-11e5-8057-d34c75f3cafc.png" alt="Universal Angular 2" height="320"/>

Angular 2 Universal Starter

Server-Side Rendering for Angular 2

A minimal Angular 2 starter for Universal JavaScript using TypeScript 2 and Webpack 2

If you're looking for the Angular Universal repo go to angular/universal

Universal "Gotchas"

To use templateUrl or stylesUrl you must use angular2-template-loader in your TS loaders.
- This is already setup within this starter repo. Look at the webpack.config file here for details & implementation.
window & document do not exist on the server - so using them, or any library that uses them (jQuery for example) will not work.
- If you need to use them, consider limiting them to only your main.client and wrapping them situationally with the imported isBrowser / isNode features from Universal. `import { isBrowser, isNode } from 'angular2-universal';
The application runs XHR requests on the server & once again on the Client-side (when the application bootstraps)
- Use a UniversalCache to save certain requests so they aren't re-ran again on the Client.

Upcoming Universal features

SeoServices
Universal fixes for Angular Core 2.1.1
AoT funcionality is still a work-in-progress, but is available as of 2.1.0-rc1

Installation

npm install

Serve

npm start to build your client app and start a web server
npm run build to prepare a distributable bundle

Development

run npm start and npm run watch in two separate terminals to build your client app, start a web server, and allow file changes to update in realtime

Watch files

npm run watch to build your client app and start a web server

Edge case of server compatibility with Promise polyfills

If you have node modules with promise polyfill dependency on server - there is chance to get the following exception:

Error: Zone.js has detected that ZoneAwarePromise `(window|global).Promise` has been overwritten.

It occurs because Zone.js Promise implementation is not detected as Promise by some polyfills (e.g. es6-promise before 4.x).

To sort it out, you need such polyfills initialized before zone.js. Zone.js is initialized in 'angular2-universal-polyfills' import of server.ts. So import problematic modules before this line.