@nrwl/angular:webpack-server
The webpack-server executor is very similar to the standard dev server builder provided by the Angular Devkit. It is usually used in tandem with @nrwl/angular:webpack-browser
when your Angular application uses a custom webpack configuration.
Options can be configured in workspace.json
when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/configuration/projectjson#targets.
Examples
Seving an application with a custom webpack configuration
This executor should be used along with @nrwl/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": "@nrwl/angular:webpack-browser",
3 "options": {
4 ...
5 "customWebpackConfig": {
6 "path": "apps/appName/webpack.config.js"
7 }
8 }
9},
10"serve": {
11 "executor": "@nrwl/angular:webpack-server",
12 "configurations": {
13 "production": {
14 "browserTarget": "appName:build:production"
15 },
16 "development": {
17 "browserTarget": "appName:build:development"
18 }
19 },
20 "defaultConfiguration": "development",
21}
Options
browserTarget (required)
Type: string
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
.
allowedHosts
Type: array
List of hosts that are allowed to access the dev server.
disableHostCheck
Default: false
Type: boolean
Don't verify connected clients are part of allowed hosts.
hmr
Default: false
Type: boolean
Enable hot module replacement.
host
Default: localhost
Type: string
Host to listen on.
liveReload
Default: true
Type: boolean
Whether to reload the page on change, using live-reload.
open
Alias(es): o
Default: false
Type: boolean
Opens the url in default browser.
poll
Type: number
Enable and define the file watching poll time period in milliseconds.
port
Default: 4200
Type: number
Port to listen on.
proxyConfig
Type: string
Proxy configuration file. For more information, see https://angular.io/guide/build#proxying-to-a-backend-server.
publicHost
Type: 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.
servePath
Type: string
The pathname where the app will be served.
ssl
Default: false
Type: boolean
Serve using HTTPS.
sslCert
Type: string
SSL certificate to use for serving HTTPS.
sslKey
Type: string
SSL key to use for serving HTTPS.
verbose
Type: boolean
Adds more details to output logging.
watch
Default: true
Type: boolean
Rebuild on change.