@nxarch/ng-nest v0.13.0

A Nx plugin to integrate a NestJS server with a server side rendered Angular application.

From a conceptual point of view the NestJS server incorporates an Angular Universal application that will be reached on specified routes. The server uses the AngularUniversalModule provided by @nxarch/nest-nguniversal. The setup for both applications can be tedious and error-prone. This library takes care of the entire setup and provides an executor for a good DX.

Prerequisites

• You need a NestJS application and an Angular application in the same workspace.
• Nx Version >= 14.0.0

Installation

npm i @nxarch/ng-nest
yarn add @nxarch/ng-nest

Setup

Use the provided generator to setup all files. If you don't have an Angular and a NestJS app refer to this part on how to generate these applications.

yarn nx generate @nxarch/ng-nest:init --ssrApp=my-angular-project --serverApp=my-nestjs-project

App Start

Use the added script in the package.json.

yarn dev:server

Setup Nx apps (if not already setup)

Use this command to quickly scaffold a new workspace with an Angular and a NestJS application.

npx create-nx-workspace --preset angular-nest

Setup an Angular app and a NestJS app in an existing Nx workspace.

yarn add --dev @nrwl/angular @nrwl/nest
yarn nx generate @nrwl/angular:app
yarn nx generate @nrwl/nest:app

Configuration

You can configure the plugin with these properties. Use them in server projects project.json: targets -> serve-ssr -> options

For configuring the AngularUniversalModule refer to @nxarch/nest-nguniversal.

Notice

When using Angulars http client make sure to set an absolute url. Or use an Interceptor to prepend a base path on the server side.

// don't
hello$ = this.http.get<Message>('/api/hello');
// do
hello$ = this.http.get<Message>('http://localhost:4200/api/hello');