@nx/angular:webpack-dev-server

The webpack-dev-server executor is very similar to the standard dev server builder provided by the Angular Devkit. It is usually used in tandem with @nx/angular:webpack-browser when your Angular application uses a custom webpack configuration.

Options can be configured in project.json when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/reference/project-configuration#targets.

Seving an application with a custom webpack configuration

This executor should be used along with @nx/angular:webpack-browser to serve an application using a custom webpack configuration.

Your project.json file should contain a build and serve target that matches the following:

1"build": { 2 "executor": "@nx/angular:webpack-browser", 3 "options": { 4 ... 5 "customWebpackConfig": { 6 "path": "apps/appName/webpack.config.js" 7 } 8 } 9}, 10"serve": { 11 "executor": "@nx/angular:webpack-dev-server", 12 "configurations": { 13 "production": { 14 "browserTarget": "appName:build:production" 15 }, 16 "development": { 17 "browserTarget": "appName:build:development" 18 } 19 }, 20 "defaultConfiguration": "development", 21} 22
Nx 15 and lower use @nrwl/ instead of @nx/

Options

browserTarget

Required
string
Pattern: ^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$

A browser builder target to serve in the format of project:target[:configuration]. You can also pass in more than one configuration name as a comma-separated list. Example: project:target:production,staging.

buildLibsFromSource

boolean

Read buildable libraries from source instead of building them separately. If not set, it will take the value specified in the browserTarget options, or it will default to true if it's also not set in the browserTarget options.

allowedHosts

Array<string>
Default: []

List of hosts that are allowed to access the dev server.

disableHostCheck

boolean
Default: false

Don't verify connected clients are part of allowed hosts.

host

string
Default: localhost

Host to listen on.

headers

Custom HTTP headers to be added to all responses.

hmr

boolean
Default: false

Enable hot module replacement.

liveReload

boolean
Default: true

Whether to reload the page on change, using live-reload.

open

o
boolean
Default: false

Opens the url in default browser.

port

number
Default: 4200

Port to listen on.

proxyConfig

string

Proxy configuration file. For more information, see https://angular.io/guide/build#proxying-to-a-backend-server.

publicHost

string

The URL that the browser client (or live-reload client, if enabled) should use to connect to the development server. Use for a complex dev server setup, such as one with reverse proxies.

poll

number

Enable and define the file watching poll time period in milliseconds.

ssl

boolean
Default: false

Serve using HTTPS.

sslKey

string

SSL key to use for serving HTTPS.

sslCert

string

SSL certificate to use for serving HTTPS.

servePath

string

The pathname where the app will be served.

verbose

boolean

Adds more details to output logging.

watch

boolean
Default: true

Rebuild on change.