The official CLI of webpack
- About
- Supported arguments and commands
- Packages
- Getting started
- webpack CLI Scaffolds
- Exit codes and their meanings
- Contributing and Internal Documentation
- Open Collective
webpack 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.
When you have followed the Getting Started guide of webpack then webpack CLI is already installed!
Otherwise npm install --save-dev webpack-cli or yarn add webpack-cli --dev will install it.
Get to know what are the available commands and arguments here.
We organize webpack CLI as a multi-package repository using lerna. Every command has a dedicated subfolder in the packages folder. Here's a summary of commands provided by the CLI.
Supporting developers is an important task for webpack CLI. Thus, webpack CLI provides different commands for many common tasks.
build|bundle|b [entries...] [options]- Run webpack (default command, can be omitted).configtest|t [config-path]- Validate a webpack configuration.help|h [command] [option]- Display help for commands and options.init|c [scaffold...] [options]- Create a new webpack configuration.info|i [options]- Returns information related to the local environment.migrate|m <config-path> [new-config-path]- Migrate project from one version to another.plugin|p [output-path]- Initiate new plugin project.loader|l [output-path]- Initiate new loader project.serve|s [entries...] [options]- Use webpack with a development server that provides live reloading.version|v [commands...]- Output the version number ofwebpack,webpack-cli,webpack-dev-server, and commandswatch|w [entries...] [options]- Run webpack and watch for files changes.
The project also has several utility packages which are used by other commands
generators- Contains all webpack-cli related yeoman generators.
When you have followed the Getting Started guide of webpack then webpack CLI is already installed! Otherwise, you would need to install webpack CLI and the packages you want to use. If you want to use the init command to create a new webpack.config.js configuration file:
npm i webpack-cli @webpack-cli/init
npx webpack-cli initYou will be prompted for some questions about what how you want to generate your config file when running the init command so webpack CLI can provide the best fitting configuration.
With v3 of webpack CLI, we introduced scaffolding as an integral part of the CLI. Our goal is to simplify the creation of webpack configurations for different purposes. Additionally, sharing such solutions with the community is beneficial and with webpack, we want to allow this. We provide webpack-scaffold as a utility suite for creating these scaffolds. It contains functions that could be of use for creating a scaffold yourself.
You can read more about Scaffolding, learn How to compose a webpack-scaffold? or generate one with webpack-scaffold-starter.
| Exit Code | Description |
|---|---|
0 |
Success |
1 |
Errors from webpack |
2 |
Configuration/options problem or an internal error |
The webpack family welcomes any contributor, small or big. We are happy to elaborate, guide you through the source code and find issues you might want to work on! To get started have a look at our documentation on contributing.
If you like webpack, please consider donating to our Open Collective to help us maintain it.