Command Line Interface (CLI)
stencil build
Builds a Stencil project. The flags below are the available options for the
build
command.
Flag | Description | Alias |
---|---|---|
--ci |
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. | |
--config | Path to the stencil.config.ts file. This flag is not needed in most cases since Stencil will find the config. Additionally, a Stencil config is not required. |
-c |
--debug |
Adds additional runtime code to help debug, and sets the log level for more verbose output. | |
--dev | Runs a development build. | |
--docs-readme |
Generate readme.md docs based on the component types, properties, methods, events, JSDocs, CSS Custom Properties, etc. |
|
--es5 | 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. | |
--log | Write logs for the stencil build into
stencil-build.log . The log file is written in the same location as the config. |
|
--prerender |
Prerender the application using the www output target after the build has completed. |
|
--prod | 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
--dev flag. | |
--max-workers |
Max number of workers the compiler should use. Defaults to use the same number of CPUs the Operating System has available. | |
--next | Opt-in to test the "next" Stencil compiler features. | |
--no-cache |
Disables using the cache. | |
--no-open |
By default the --serve command will open a browser window. Using the
--no-open command will not automatically open a browser window. |
|
--port | Port for the Integrated Dev Server. Defaults to
3333 . |
-p |
--serve |
Starts the Integrated Dev Server. | |
--stats | Write stats about the project to stencil-stats.json . The stats file is written in the same location as the config. |
|
--verbose |
Logs additional information about each step of the build. | |
--watch | Watches files during development and triggers a rebuild when files are updated. |
stencil test
Tests a Stencil project. The flags below are the available options for the
test
command.
Flag | Description |
---|---|
--spec | Tests .spec.ts files using
Jest. |
--e2e |
Tests .e2e.ts files using
Puppeteer and
Jest. |
--no-build |
Skips build process before running the tests. (You are expected to have built it beforehand). |
stencil
Flag | Description |
---|---|
--help | Display the help output explaining the different flags. |
--version |
Prints the current Stencil version. |
stencil generate <sub-folder>
Starts the interactive component generator. You can specify one or more sub-folders to generate the component in.
Contributors
Thanks for your interest!
We just need some basic information so we can send the guide your way.