Skip to content

teambit/bit.envs

Repository files navigation

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.

See developing bit compilers.

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.

  1. Fork the repo and create your branch from master.
  2. If you've added code that should be tested, add tests.
  3. Ensure the test suite passes.
  4. Add your change to the CHANGELOG.md file at the [unreleased] section.

Running this project

  1. clone
  2. 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 than bit.envs (the default scope name is the same as the dir name))
  3. bit import (it takes some time)
  4. npm i
  5. bit import --merge
  6. bit link
  7. 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.

Releases

No releases published

Packages

No packages published

Languages