Table of Contents
Getting Started with Universal
- w/ NodeJS Server
- w/ ASP.NET Core Server
- Upgrading to Version 8
- Universal "Gotchas"
- Upgrading from Angular2-Universal
- What's in a name?
- Universal Team
The Angular Universal project is a community driven project to expand on the core APIs from Angular (platform-server) to enable developers to do server side rendering of Angular applications in a variety of scenarios.
This repository will host the various tools like engines to integrate with various backends(NodeJS, ASP.NET etc.) and also extra modules and examples to help you started with server side rendering.
The Universal project is driven by community contributions. Please send us your Pull Requests!
- Minimal universal example
Installation: Clone the above repo,
npm i && dotnet restore(VStudio will run these automatically when opening the project)
- Launch files included for both VSCode & VStudio to run/debug automatically (press F5).
Follow this upgrade guide if you are upgrading an exsiting Universal project to Angular version 8 - Guide
The packages from this repo are published as scoped packages under @nguniversal
Moved to /docs/gotchas.md
- Integrate the platform API into core
- Support Title and Meta services on the server
- Develop Express, ASP.NET Core, Hapi engines
- Angular CLI support for Universal
- Provide a DOM implementation on the server
- Hooks in
renderModule*to do stuff just before rendering to string
- Generic state transfer API in the platform
- Http Transfer State Module that uses HTTP interceptors and state transfer API
- Material 2 works on Universal
- Write documentation for core API
- Support AppShell use cases
- Better internal performance and stress tests
- Make it easier to write unit tests for Universal components
- Node.js bridge protocol to communicate with different language backends - Django, Go, PHP etc.
- Static site rendering
- Development server/watch mode builder with livereload for CLI
- Full client rehydration strategy that reuses DOM elements/CSS rendered on the server
Upgrading from Angular2-Universal
If you're coming from the original
angular2-universal (2.x) here are some helpful steps for porting your application to Angular 4 & platform-server.
Control server-rendered page and transfer state before client-side web app loads to the client-side-app. Repo
What's in a name?
- Adam Plumer and Fabian Wiles - Current maintainers
- PatrickJS and Jeff Whelpley - Founders of the Angular Universal project. (Universal rendering is also called PatrickJS-ing)
- Mark Pieszak - Contributor and Evangelist, ASP.NET Core Engine
- Jason Jean - Express engine and Universal support for CLI
- Wassim Chegham - Contributor and Evangelist, Hapi engine developer.
- Jeff Cross - Evangelist and performance consultant
- Vikram Subramanian and Alex Rickabaugh - Angular Core API