UNPKG

4.56 kBMarkdownView Raw
1<div align="center">
2 <a href="https://github.com/webpack/webpack-cli">
3 <img width="200" height="200" src="https://webpack.js.org/assets/icon-square-big.svg">
4 </a>
5</div>
6
7# webpack CLI
8
9The official CLI of webpack
10
11## About
12
13webpack CLI provides a flexible set of commands for developers to increase speed when setting up a custom webpack project. As of webpack v4, webpack is not expecting a configuration file, but often developers want to create a more custom webpack configuration based on their use-cases and needs. webpack CLI addresses these needs by providing a set of tools to improve the setup of custom webpack configuration.
14
15## How to install
16
17When you have followed the [Getting Started](https://webpack.js.org/guides/getting-started/) guide of webpack then webpack CLI is already installed!
18
19Otherwise
20
21```bash
22npm install --save-dev webpack-cli
23```
24
25or
26
27```bash
28yarn add webpack-cli --dev
29```
30
31## Supported arguments and commands
32
33### Usage
34
35All interactions with webpack-cli are of the form
36
37```bash
38npx webpack-cli [command] [options]
39```
40
41If no command is specified then `bundle` command is used by default
42
43### Help Usage
44
45You display basic commands and arguments -
46
47```bash
48npx webpack-cli --help
49```
50
51To display all supported commands and arguments -
52
53```bash
54npx webpack-cli --help=verbose
55```
56
57or
58
59```bash
60npx webpack-cli --help verbose
61```
62
63### Available Commands
64
65```
66 build|bundle|b [entries...] [options] Run webpack (default command, can be omitted).
67 configtest|t [config-path] Validate a webpack configuration.
68 help|h [command] [option] Display help for commands and options.
69 info|i [options] Outputs information about your system.
70 init|c [scaffold...] [options] Initialize a new webpack configuration.
71 loader|l [output-path] Scaffold a loader.
72 migrate|m <config-path> [new-config-path] Migrate a configuration to a new version.
73 plugin|p [output-path] Scaffold a plugin.
74 serve|s [entries...] [options] Run the webpack dev server.
75 version|v [commands...] Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and commands.
76 watch|w [entries...] [options] Run webpack and watch for files changes.
77```
78
79### webpack 4
80
81```
82 Options:
83 --analyze It invokes webpack-bundle-analyzer plugin to get bundle information
84 -c, --config <value...> Provide path to a webpack configuration file e.g. ./webpack.config.js.
85 --config-name <value...> Name of the configuration to use.
86 -m, --merge Merge two or more configurations using 'webpack-merge'.
87 --env <value...> Environment passed to the configuration when it is a function.
88 --progress [value] Print compilation progress during build.
89 -j, --json [value] Prints result as JSON or store it in a file.
90 -d, --devtool <value> Determine source maps to use.
91 --no-devtool Do not generate source maps.
92 --entry <value...> The entry point(s) of your application e.g. ./src/main.js.
93 -h, --hot Enables Hot Module Replacement
94 --no-hot Disables Hot Module Replacement
95 --mode <value> Defines the mode to pass to webpack.
96 --name <value> Name of the configuration. Used when loading multiple configurations.
97 -o, --output-path <value> Output location of the file generated by webpack e.g. ./dist/.
98 --prefetch <value> Prefetch this request
99 --stats [value] It instructs webpack on how to treat the stats e.g. verbose.
100 --no-stats Disable stats output.
101 -t, --target <value...> Sets the build target e.g. node.
102 -w, --watch Watch for files changes.
103 --no-watch Do not watch for file changes.
104 --watch-options-stdin Stop watching when stdin stream has ended.
105 --no-watch-options-stdin Do not stop watching when stdin stream has ended.
106
107Global options:
108 --color Enable colors on console.
109 --no-color Disable colors on console.
110 -v, --version Output the version number of 'webpack', 'webpack-cli' and 'webpack-dev-server' and commands.
111 -h, --help [verbose] Display help for commands and options.
112```
113
114### webpack 5
115
116Checkout [`OPTIONS.md`](../../OPTIONS.md) to see list of all available options.