Bit Version Manager

BVM is a version manager for Bit.
Using BVM makes it easier to install and manage multiple versions of Bit in a single environment.

• Consistent installation: All Bit dependencies are bundled together to ensure a consistent and predictable package installation that is not affected by SemVer rules.
• Fast installation: A simple and quick installation process that requires no additional time-consuming operations (post-install scripts, etc.)
• Friendly UX: Easy upgrades and version management
• Multiple Bit versions: Easily switch between Bit versions or even use multiple versions in parallel

Install with npm:

npm i -g @teambit/bvm
Copied

Install with Yarn:

yarn global add @teambit/bvm
Copied

BVM versions older than 0.2.1 will not install Bit versions newer than 0.0.870. If you have an older version of BVM, please update it (see the installation instructions above).

bvm install
Copied

bvm upgrade
Copied

BVM updates your path automatically. However, this process can fail due to terminal-specific issues, permissions issues, and so on. It also might happen that BMV is not in PATH because the global npm/yarn bin folder is not in PATH. In that case you need to add them manually.

Set the location in PATH, manually.

# npm
echo 'export PATH=$(npm bin -g):$PATH' >> ~/.zshrc && source ~/.zshrc
# yarn
echo 'export PATH=$(yarn global bin):$PATH'  >> ~/.zshrc && source ~/.zshrc
Copied

# npm
echo 'export PATH=$(npm bin -g):$PATH' >> ~/.bashrc && source ~/.bashrc
# yarn
echo 'export PATH=$(yarn global bin):$PATH'  >> ~/.bashrc && source ~/.bashrc
Copied

Set the location in PATH, manually.

Please run the following command:

echo 'export PATH=$HOME/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
Copied

echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc && source ~/.bashrc
Copied

then re-open the terminal.

Depending on your proxy or firewall settings, use the following configs to have BVM use the correct proxy:

bvm config set proxy http://proxy.example.com:8080
bvm config set https_proxy https://proxy.example.com:8080;
Copied

If you have a previous version of Bit installed (bit-bin), the default binary name for v15 will be bbit.

You can change the binary name for Harmony by running the following command after installing BVM and before installing Bit.

bvm config set DEFAULT_LINK <new-value>
Copied

bvm version
Copied

bvm list --remote
Copied

bvm list
Copied

bvm remove <bit-version>
Copied

By default BVM installs the latest stable Bit version. To experiment with Bit's latest features, set BVM to install the latest nightly build.

bvm config set RELEASE_TYPE nightly
Copied

To undo that, and get only stable versions, remove the RELEASE_TYPE variable:

bvm config del RELEASE_TYPE
Copied

BVM has several configurations

• DEFAULT_LINK - The default command name to be linked to BVM's latest version.
  bit is linked by default unless a legacy version of Bit is installed. In that case, bbit will be linked, instead.
• BVM_DIR - The location for BVM

bvm config
Copied

bvm config set <property> <new-value>
Copied