#Quick start

Get up to speed quickly with a new Rspack based project.

• Create a new project: Choose the right tool to create a new project powered by Rspack.
• Migrating from existing projects: Migrate from a webpack-based project to Rspack.

#Ecosystem

As a low-level bundler, Rspack has a rich ecosystem that includes various frameworks, tools, and solutions. These ecosystem projects cover different aspects from frameworks to development tools, meeting diverse development needs across scenarios and providing an out-of-the-box experience.

See the Ecosystem page to explore these ecosystem projects.

#Environment preparation

Rspack supports using Node.js, Deno, or Bun as the JavaScript runtime.

You can refer to the following installation guides and choose one runtime:

• Install Node.js
• Install Bun
• Install Deno

#Create a new project

#Web applications

For web applications, we recommend Rsbuild. It builds on Rspack with defaults for common build tasks, a dev server, and integrations for frameworks such as React and Vue to help you start developing quickly. You can customize the build through configuration and plugins, or adjust the underlying Rspack configuration.

Run the following command and follow the prompts:

npm create rsbuild@latest

yarn create rsbuild

pnpm create rsbuild@latest

bun create rsbuild@latest

deno init --npm rsbuild@latest

See Rsbuild - Quick start to learn more.

#JavaScript libraries

For JavaScript libraries that other projects consume, such as utility packages and component libraries, we recommend Rslib. It builds on Rsbuild with defaults for library development and supports generating ESM and CommonJS output and TypeScript declarations, so you can publish your library to npm or share it across projects.

Run the following command and follow the prompts:

npm create rslib@latest

yarn create rslib

pnpm create rslib@latest

bun create rslib@latest

deno init --npm rslib@latest

See Rslib - Quick start to learn more.

#Using Rspack CLI directly

If you want to set up your own build workflow and manage the Rspack configuration directly, you can use Rspack CLI. It provides development, build, and preview commands, while you choose and configure loaders, plugins, and other build capabilities yourself.

#Using a scaffold

Run the following command and follow the prompts to create a project from a template:

npm create rspack@latest

yarn create rspack

pnpm create rspack@latest

bun create rspack@latest

deno init --npm rspack@latest

#Manual installation

You can also install Rspack CLI and create a configuration file manually. Start by creating a project directory and generating an npm package.json file:

mkdir rspack-demo
cd rspack-demo
npm init -y

Then install @rspack/core and @rspack/cli as dev dependencies:

npm add @rspack/core @rspack/cli -D

yarn add @rspack/core @rspack/cli -D

pnpm add @rspack/core @rspack/cli -D

bun add @rspack/core @rspack/cli -D

deno add npm:@rspack/core npm:@rspack/cli -D

Update your build scripts to use Rspack CLI:

{
  "scripts": {
    "dev": "rspack dev",
    "build": "rspack build",
    "preview": "rspack preview"
  }
}

Next, see Configure Rspack to learn about how to configure Rspack.

#Migrating from existing projects

If you need to migrate from an existing project to Rspack, you can refer to the following guides:

• Migrating from webpack to Rspack
• Migrating from webpack to Rsbuild
• Migrating from Create React App to Rsbuild
• Migrating from Vue CLI to Rsbuild
• Migrating from Vite to Rsbuild
• Migrating from Tsup to Rslib
• Migrating from Storybook

#Install canary version

When you need to test or verify the features of Rspack that are not yet released to the stable version, you may need to use the canary version.

The canary version of Rspack has a -canary suffix in the package scope. For example, the canary package name of @rspack/core is @rspack-canary/core. To use these versions, you can configure the overrides of the package manager (npm/yarn/pnpm/bun).

Here is an example of using pnpm overrides:

{
  "pnpm": {
    "overrides": {
      "@rspack/core": "npm:@rspack-canary/core@latest"
    },
    "peerDependencyRules": {
      "allowAny": ["@rspack/*"]
    }
  }
}

Rspack community also provides install-rspack tool to easily install canary version:

npx install-rspack --version latest # Install the latest version
npx install-rspack --version canary # Install the canary version
npx install-rspack --version 1.0.0-canary-d614005-20250101082730 # Install the specified canary version