Releasing#

All releases are automated through GitHub actions.

All published releases of @rspack/cli can be found on the npm versions page. They are tagged as

• latest with semver version x.y.z
• nightly
• canary

Latest Full Release#

The full release workflow is currently triggered manually every Tuesday with full release notes.

The following 9 targets are built

• x86_64-unknown-linux-gnu
• aarch64-unknown-linux-gnu
• x86_64-unknown-linux-musl
• aarch64-unknown-linux-musl
• i686-pc-windows-msvc
• x86_64-pc-windows-msvc
• aarch64-pc-windows-msvc
• x86_64-apple-darwin
• aarch64-apple-darwin

Nightly#

The nightly release workflow is triggered every day at UTC 16:00:07, which is 00:07 AM Beijing Time (offset with an odd minute to avoid cron jobs firing off at the same time).

The nightly build fully replicates the full release build for catching errors early.

Canary#

canary release workflow requires manual triggering.

Using nightly/canary version#

When releasing the nightly/canary versions of Rspack, the package name will be appended with the -canary suffix. You need to use the overrides feature of package managers like npm, yarn, or pnpm to use these versions.

Take pnpm as an example:

{
  "pnpm": {
    "overrides": {
      "@rspack/binding": "npm:@rspack/binding-canary@nightly",
      "@rspack/core": "npm:@rspack/core-canary@nightly",
      "@rspack/plugin-react-refresh": "npm:@rspack/plugin-react-refresh@nightly"
    },
    "peerDependencyRules": {
      "allowAny": ["@rspack/*"]
    }
  }
}

The Rspack community provides the install-rspack tool to quickly modify the Rspack version:

npx install-rspack --version nightly # Get latest nightly npm tag version
npx install-rspack --version 0.7.5-canary-d614005-20240625082730 # A specific canary version