@nx/angular:setup-ssr

Create the additional configuration required to enable SSR via Angular Universal for an Angular application.

Usage

1nx generate setup-ssr ... 2

By default, Nx will search for setup-ssr in the default collection provisioned in workspace.json.

You can specify the collection explicitly as follows:

1nx g @nx/angular:setup-ssr ... 2

Show what will be generated without writing to disk:

1nx g setup-ssr ... --dry-run 2

Options

project

Required
string

The name of the application to generate the Angular Universal configuration for.

appId

string
Default: serverAppFormat: html-selector

The appId to use with withServerTransition. Note: This is only used in Angular versions <16.0.0. It's deprecated since Angular 16 and not supported since Angular 17.

hydration

boolean

Set up Hydration for the SSR application. It defaults to true for Angular versions >= 17.0.0. Otherwise, it defaults to false. Note: This is only supported in Angular versions >= 16.0.0.

main

string
Default: main.server.tsFormat: path

The name of the main entry-point file.

rootModuleFileName

string
Default: app.server.module.tsFormat: path

The name of the root module file

rootModuleClassName

string
Default: AppServerModule

The name of the root module class.

serverFileName

string
Default: server.ts

The name of the Express server file.

serverPort

number
Default: 4000

The port for the Express server.

standalone

boolean

Use Standalone Components to bootstrap SSR.

skipFormat

Internal
boolean

Skip formatting the workspace after the generator completes.

skipPackageJson

Internal
boolean
Default: false

Do not add dependencies to package.json.