See how Stencil fits into the entire Ionic Ecosystem ->
Stencil is part of the Ionic Ecosystem ->

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 Generate 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 no 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.


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.