Command Line Interface (CLI)
Stencil's command line interface (CLI) is how developers can build their projects, run tests, and more.
Stencil's CLI is included in the compiler, and can be invoked with the
stencil command in a project where
@stencil/core is installed.
Builds a Stencil project. The flags below are the available options for the
|Run a build using recommended settings for a Continuous Integration (CI) environment. Defaults the number of workers to 4, allows for extra time if taking screenshots via the tests and modifies the console logs.|
|Path to the |
|Adds additional runtime code to help debug, and sets the log level for more verbose output.|
|Runs a development build.|
|Creates an ES5 compatible build. By default ES5 builds are not created during development in order to improve build times. However, ES5 builds are always created during production builds. Use this flag to create ES5 builds during development.|
|Write logs for the |
|Prerender the application using the |
|Runs a production build which will optimize each file, improve bundling, remove unused code, minify, etc. A production build is the default, this flag is only used to override the |
|Max number of workers the compiler should use. Defaults to use the same number of CPUs the Operating System has available.|
|Opt-in to test the "next" Stencil compiler features.|
|Disables using the cache.|
|By default the |
|Port for the Integrated Dev Server. Defaults to |
|Starts the Integrated Dev Server.|
|Write stats about the project to |
|Logs additional information about each step of the build.|
|Watches files during development and triggers a rebuild when files are updated.|
Performs a one-time generation of documentation for your project. For more information on documentation generation, please see the Documentation Generation section.
Starts the interactive generator for a new Stencil component. The generator will ask you for a name for your component, and whether any stylesheets or testing files should be generated.
If you wish to skip the interactive generator, a component tag name may be provided on the command line:
stencil generate my-new-component
All components will be generated within the
src/components, a directory will be created with the same name as the component tag name you provided containing the generated files.
For example, if you specify
page-home as the component tag name, the files will be generated in
It is also possible to specify one or more sub-folders to generate the component in.
For example, if you specify
pages/page-home as the component tag name, the files will be generated in
stencil generate pages/page-home
The command above will result in the following directory structure:
Prints various tasks that can be run and their associated flags to the terminal.
Tests a Stencil project. The flags below are the available options for the
|Skips build process before running the tests. (You are expected to have built it beforehand).|
|Opens the dev tools panel in Chrome for end-to-end tests. Setting this flag will disable |
|Sets the headless mode to use in Chrome for end-to-end tests. |
Prints the version of Stencil to the terminal.