Bit

Website | Docs | Community | Bit Cloud

Bit is a build system for development of **composable software**. It makes the composition of applications from independently versioned components seamless and fast. Bit is similar in sense, but stands as the opposite for the "Monorepo" approach, which aims to center all code under a central repository. Instead, Bit is bringing simplicity for distribution of source code into independently versioned components, depending on each other. People often use Bit to run a Monorepo, a Polyrepo or without using repositories at all. The core innovation of Bit is the ["Bit Component"](https://bit.dev/#component), a composable and versioned container for source code, whereas dependencies are first-class citizens. Components can be used as packages, ESM modules, runtime scripts, and any other artifact a build task can generate. - 📦 **Descriptive module names**. Use components through descriptive package names. No aliases required. - 🚀 **Dependency versioning.** Automatic detection and versioning of dependency changes. No more redundant package.json files. - ⚓ **Reusable development environments.** Reusable components including all of your dev config. No more duplication of countless `tsconfig.json`, `eslintrc` or `prettierrc` configs. - ⚒️ **Build pipelines**. Independently build and store packages, bundles, and binaries. - 👓 **Preview and auto-generated docs**. Every component is an asset with auto-generated docs and component previews. - 🛫 **Change review**. Use Lanes to propose and preview changes and collaborate on them with others. - 🧑‍💻 **Component generators**. Create new components using pre-built or custom templates for any type of component. ## Getting started ### Install Bit Use the Bit installer to install Bit to be available on your PATH. ```bash npx @teambit/bvm install ``` For better VSCode dev experience, install the [Bit VSCode Plugin](https://marketplace.visualstudio.com/items?itemName=bit.vscode-bit). ### Create a new workspace Run the following to create a workspace with a few components included, using the hello-world starter: ```bash bit new hello-world my-hello-world --env teambit.community/starters/hello-world ``` For the quick start, we use two React components and one Node module, though you can create components using any JS-based framework. You can explore our [official starters](https://bit.dev/docs) for [Vue](https://bit.dev/docs/quick-start/hello-world-vue), [Angular](https://bit.dev/docs/quick-start/hello-world-angular), and other supported tools or [learn how to create your own](https://bit.dev/docs/node-env/set-up-your-env). ### Run the app Your workspace maintains a number of components. One of these components is also an [app](https://bit.dev/reference/apps/application-types/). Run it using: ```bash bit run hello-world-app ``` You can get any component to become an app by adding a single file to it. ### Create components Start creating components using the default component generators, or [create your own](https://bit.dev/docs/node-env/generators). ```bash bit create react buttons/button ``` You can view other built-in component templates, by running the `bit templates` command. ### Use components After creating a new component, start using it by adding an import statement in one of your workspace components. ```ts import { Button } from '@org/scope-name.buttons.button'; ``` Once added, Bit will autodetect the dependency between these components. Use `bit show` or the VSCode plugin to view the list of dependencies Bit detected for your components. ### Create a remote scope You can either use hosted scopes on [Bit Cloud](https://bit.cloud) or by [hosting scopes on your own](https://bit.dev/reference/scope/running-a-scope-server). Use the following command to create your Bit Cloud account and your first scope. ```bash bit login ``` Once done, change to your own owner and scope names using this command: ```bash bit scope rename org.scope-name my-org.my-scope-name --refactor ``` This command will refactor your components to use the new owner and scope names. ### Record component and dependency changes Run `snap` or `tag` to record component changes, and assign a semantic version to them. Bit will version the dependents graph of each modified components. ```bash bit snap --message 'initial release' ``` Snapped components are ready to be built upon 'export' (see next step). The build artifacts will also be stored in the component's new version ('snap'). By default, components are built using bit.cloud's CI platform, Ripple CI. However, you can run the components' build locally by adding the --build flag, or use your own CI platform. [To learn more see Set up CI](https://bit.dev/reference/git/automating-component-releases). ### Export components to a remote scope Export your staged components from your workspace to their remote scopes. This will make them available to be used by components outside of your workspace, and from your other projects. ```bash bit export ``` Head over to your bit.cloud account to see your components build progress. Once the build process is completed, the components will be available for use in their remote scopes. 🎉🎉🎉 ## Contributors Bit is entirely built with Bit and you can find all its components on [Bit Cloud](https://bit.cloud/teambit/~scopes). Your contribution, no matter how big or small, is much appreciated. Before contributing, please read the [code of conduct](CODE_OF_CONDUCT.md). See [Contributing](CONTRIBUTING.md). ## License [Apache License, Version 2.0](https://github.com/teambit/bit/blob/master/LICENSE)