@nx/angular:host

Create an Angular Consumer (Host) Module Federation Application.

Usage

1nx generate host ... 2
1nx g consumer ... #same 2

By default, Nx will search for host in the default collection provisioned in workspace.json.

You can specify the collection explicitly as follows:

1nx g @nx/angular:host ... 2

Show what will be generated without writing to disk:

1nx g host ... --dry-run 2

Examples

Create an Angular application with configuration in place for Module Federation. If the remotes option is provided, attach the Producer (remote) application to this application's configuration:

1nx g @nx/angular:host appName --remotes=remote1 2

Create an Angular application with configuration in place for Module Federation. If the producers option is provided, attach the Producer (remote) application to this application's configuration:

1nx g @nx/angular:consumer appName --producers=remote1 2

Options

directory

Required
string

The directory of the new application.

name

string
Pattern: ^[a-zA-Z][^:]*$

The name to give to the Consumer (host) Angular application.

remotes

producers
Array<anything>

The names of the Producers (remote) applications to add to the Consumer (host).

ssr

boolean
Default: false

Whether to configure SSR for the Consumer (host) application

addTailwind

boolean
Default: false

Whether to configure Tailwind CSS for the application.

backendProject

string

Backend project that provides data to this application. This sets up proxy.config.json.

dynamic

boolean
Default: false

Should the host application use dynamic federation?

e2eTestRunner

string
Default: playwright
Accepted values: playwright, cypress, none

Test runner to use for end to end (E2E) tests.

inlineStyle

s
boolean
Default: false

Specifies if the style will be in the ts file.

inlineTemplate

t
boolean
Default: false

Specifies if the template will be in the ts file.

linter

string
Default: eslint
Accepted values: eslint, none

The tool to use for running lint checks.

prefix

p
string
Format: html-selector

The prefix to apply to generated selectors.

style

string
Default: css
Accepted values: css, scss, sass, less

The file extension to be used for style files.

skipTests

S
boolean
Default: false

Skip creating spec files.

strict

boolean
Default: true

Create an application with stricter type checking and build optimization options.

setParserOptionsProject

boolean
Default: false

Whether or not to configure the ESLint parserOptions.project option. We do not do this by default for lint performance reasons.

standalone

boolean
Default: true

Whether to generate a Consumer (host) application that uses standalone components.

serverRouting

boolean

Creates a server application using the Server Routing and App Engine APIs for application using the application builder (Developer Preview). Note: this is only supported in Angular versions 19.x.x. From Angular 20 onwards, SSR will always enable server routing when using the application builder.

tags

string

Add tags to the application (used for linting).

typescriptConfiguration

boolean
Default: true

Whether the module federation configuration and webpack configuration files should use TS.

unitTestRunner

string
Default: jest
Accepted values: jest, vitest, none

Test runner to use for unit tests.

viewEncapsulation

string
Accepted values: Emulated, None, ShadowDom

Specifies the view encapsulation strategy.

skipPackageJson

Internal
boolean
Default: false

Do not add dependencies to package.json.

skipPostInstall

Internal
boolean
Default: false

Do not add or append ngcc to the postinstall script in package.json.

skipFormat

Internal
boolean
Default: false

Skip formatting files.