bit.envs
bit.envs copied to clipboard
DEPRECATED - Bit compilers and testers were moved to https://github.com/teambit/envs
Deprecated. Compilers and testers for Bit are now in https://github.com/teambit/envs
Bit compilers, transpilers and testers.
Bit helps you easily share many components. To save the overhead of separately defining build and test steps for every component, bit lets you use reusable extensions as compilers and testers for the components in your workspace.
The component environment is a unique type of an extension that implements specific APIs to support building (compiling/transpiling) components and running unit tests.
This repository contains officially supported bit compilers and testers for the public use of the developer community.
All issues and PRs re Bit compilers and testers should be opened in this repository.
Compilers and testers on bit.dev
All bit compilers and testers are available and can be used from this bit.dev collection.
Bit compilers and transpilers
See: "Which Bit compiler should I use?"
How to use a Bit compiler
See full documentation on the usage of bit compilers.
Bit uses a global compiler configuration for a workspace, which propagates to each component tracks in that workspace. Therefore, can import a single compiler for all the components in your project.
Example
Use the --compiler
flag when importing a bit compiler.
$ bit import bit.envs/compilers/babel --compiler
the following component environments were installed
- bit.envs/compilers/[email protected]
Develop your own Bit compiler/tester
Since there are so many build tools and configurations, some of you might discover that the existing compilers don’t fit their requirements. Compilers are bit components, and anyone can develop a new compiler.
Contributing
Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct.
Pull Requests
We actively welcome your pull requests.
- Fork the repo and create your branch from
master
. - If you've added code that should be tested, add tests.
- Ensure the test suite passes.
- Add your change to the CHANGELOG.md file at the [unreleased] section.
Running this project
- clone
- make sure the local scope name is different then bit.envs to prevent collision with bit.dev scope name. (either change the name inside
.git/bit/scope.json
or make sure to clone to a folder other thanbit.envs
(the default scope name is the same as the dir name)) -
bit import
(it takes some time) -
npm i
-
bit import --merge
-
bit link
- validate by running
bit status
and make sure everything is ok
License
By contributing to Bit, you agree that your contributions will be licensed under its Apache2 license.