@brightspace-ui/create
v3.3.1
Published
Initializer for Brightspace web components
Downloads
222
Keywords
Readme
@brightspace-ui/create
Initializer for Brightspace web components.
Usage
Run the following command from the directory where the new component directory should be created (e.g., if desired end location is Documents/button, run from Documents). GitHub repo creation should be done separately and the steps there can be followed to add this new component to source control.
npm init @brightspace-ui
Features
Default
- Project boilerplate including: README, .editorconfig, .gitignore, package.json, CODEOWNERS and LICENSE (Apache-2.0)
- Lit component scaffold
- Demo
- Linting (JavaScript, Style, Lit)
- Unit tests with cross-browser testing
- Continuous Integration using GitHub Actions
- Dependabot
- GitHub Release and publish to NPM*
Optional
- Localization
- Visual diff testing*
- Test reporting*
* Some additional setup required (see below)
Additional Setup
Visual Diff Testing
Visual diff results are published to a bucket in S3 and need special tokens to do so. To set these up, follow the instructions in the vdiff GitHub Action.
Semantic Release
In order for the release workflow to automatically update the version, the repo needs to be configured with a D2L_RELEASE_TOKEN
.
Learn more in the action docs.
Test Reporting
In order for test reports to be submitted, the repo needs to be configured with AWS_*
tokens with the correct permissions.
Learn more in the action docs.
Developing and Contributing
TODO:
- [ ] GitHub Actions integration for verify-translations
Pull requests welcome!
Versioning and Releasing
This repo is configured to use semantic-release
. Commits prefixed with fix:
and feat:
will trigger patch and minor releases when merged to main
.
To learn how to create major releases and release from maintenance branches, refer to the semantic-release GitHub Action documentation.