@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 (Developer Preview). Note: this is only supported in Angular versions >= 19.0.0.

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.

standaloneConfig

Deprecated
boolean
Default: true

Split the project configuration into <projectRoot>/project.json rather than including it inside workspace.json.

Nx only supports standaloneConfig