widgetbook_cli 3.0.0-beta.11  widgetbook_cli: ^3.0.0-beta.11 copied to clipboard
widgetbook_cli: ^3.0.0-beta.11 copied to clipboard
A command-line application to upload Widgetbook builds to Widgetbook Cloud.
Overview #
widgetbook_cli allows developers to upload their Widgetbook to Widgetbook Cloud.
Currently the CLI supports two features:
- uploading a Widgetbook Build
- uploading a Widgetbook Review
Repository #
To access the source code of the CLI visit the Widgetbook repository.
Setup #
The widgetbook-cli is available as the widgetbook_cli package.
Install the CLI globally by running:
dart pub global activate widgetbook_cli
Run the CLI by using
widgetbook [<options>]
Arguments #
The CLI accepts the following arguments.
| Argument | Mandatory | Description | 
|---|---|---|
| --path | ➖ | The path to your project. Defaults to ./. | 
| --api-key | ✅ | The project specific API key for Widgetbook Cloud. See How to create an API key. | 
| --branch | ➖ | The name of the branch for which the Widgetbook is uploaded. Defaults to the current git branch. | 
| --commit | ➖ | The SHA hash of the commit for which the Widgetbook is uploaded. Defaults to the last commit of the current git branch. | 
| --repository | ✅ | The name of the repository for which the Widgetbook is uploaded. | 
| --actor | ✅ | The username of the actor which triggered the build. | 
| --git-provider | ➖ | The name of the Git provider. Allowed values: GitHub,GitLab,BitBucket,Azure,Local. Defaults toLocal | 
| --base-branch | ➖ | The name of the pull-request's base branch. | 
| --base-commit | ➖ | The SHA hash of pull-request's base branch. Defaults to the last commit of base-branch, ifbase-branchis set. | 
| --pr | ➖ | The number of the PR on which the CLI is running. | 
| --github-token | ➖ | The authentication token to post comments to the PR on which the CLI is running. | 
If base-branch or base-commit are omitted, a Widgetbook Build is created.
If base-branch and base-commit are provided, a widgetbook Build and a Widgetbook Review is created.