Bit v1.0: Upgrade Notes

ed
eden-e7 months ago

Bit is now available in version 1.0.0. This version is a major release that includes a few changes that require your attention.

Update your Bit version by running the following command:

$npx @teambit/bvm upgrade
Copiedcopy

Verify that you're running version 1.0.0 by running the following command:

$bit -v
Copiedcopy

Default bit.cloud registry has changed

bit.cloud's package registry has now changed from https://node.bit.cloud to https://node-registry.bit.cloud. While the old registry is still supported, we recommend migrating to the new one.

To do so, you will need to delete your workspace's lock file and run the installation again. In addition to that, any .npmrc file that points to node.bit.cloud (in your CI server or local machine) should be updated to node-registry.bit.cloud.

For example, the following .npmrc file will need to be updated from:

@my-bit-org:registry=https://node.bit.cloud
@teambit:registry=https://node.bit.cloud
//node.bit.cloud/:_authToken=9f1cf38d-f479-43f1-7aff-b1088726ff23
always-auth=true

To the following:

@my-bit-org:registry=https://node-registry.bit.cloud
@teambit:registry=https://node-registry.bit.cloud
//node-registry.bit.cloud/:_authToken=9f1cf38d-f479-43f1-7aff-b1088726ff23
always-auth=true

To learn more about configuring your npm client to work with bit.cloud, see configuring bit.cloud in your NPM config.

Cloud builds by default

Version 1.0.0 uses Ripple CI as the default CI for components builds. Components are built in the cloud after they've been exported and not when they are snapped.

If your automation flow uses bit tag --soft and bit tag --persist combo, it is still supported and you do not need to make any changes.

To snap (or 'tag') components and run their build locally, use the --build option:

$bit
Copiedcopy
See command synopsis
$bit
Copiedcopy
See command synopsis

To opt out of Ripple CI, and permanently run your builds locally, run the following command:

$bit
Copiedcopy
See command synopsis

Alternatively, set the following env var:

$export BIT_CONFIG_FORCE_LOCAL_BUILD=true
Copiedcopy

Running bit build will always build your components locally.