Package Exports
- @roots/bud-cli
Readme
@roots/bud-cli
👩💻 The @roots/bud CLI runner utility
- Installation
- Getting started
- bud build
- bud extensions
- Running the build with logging
- Installing dependencies automatically
- Running the build in CI
- Exiting the CLI from
devmode - Contributing
- Bud sponsors
- Community
Installation
With yarn.
yarn add @roots/bud-cli --devWith npm:
npm install @roots/bud-cli --save-devGetting started
The CLI includes detailed usage instructions:
yarn bud --helpbud build
Compile assets for production:
bud buildCompile assets for development:
bud build:devbud extensions
List installed extensions:
bud extensions:listInstall extension dependencies:
bud extensions:installRunning the build with logging
Use the --log flag to run the build with logging enabled.
Installing dependencies automatically
Try the --install flag to install packages flagged as required by various extensions.
Running the build in CI
It is possible, depending on your environment, that Bud's CLI output causes issues. In particular, it's usage of tty raw mode can cause issues in CI.
To run the build but not use the @roots/bud-cli renderer, there is a --ci flag which indicates you want to run the build for these environments.
Exiting the CLI from dev mode
Type q to gracefully exit the interface when running in development mode.
Contributing
Contributions are welcome from everyone.
We have contributing guidelines to help you get started.
Bud sponsors
Help support our open-source development efforts by becoming a patron.
Community
Keep track of development and community news.
- Participate on the Roots Discourse
- Follow @rootswp on Twitter
- Read and subscribe to the Roots Blog
- Subscribe to the Roots Newsletter
- Listen to the Roots Radio podcast