#Use Rsdoctor

Rsdoctor is a build analyzer tailored for the Rspack ecosystem.

Rsdoctor aims to be a one-stop, intelligent build analyzer that makes the build process transparent, predictable, and optimizable through visualization and smart analysis, helping teams pinpoint bottlenecks, improve performance, and raise engineering quality.

Use Rsdoctor to debug build outputs or the build process.

#Quick start

In an Rslib project, enable Rsdoctor as follows:

1. Install the Rsdoctor plugin:

npm add @rsdoctor/rspack-plugin -D

yarn add @rsdoctor/rspack-plugin -D

pnpm add @rsdoctor/rspack-plugin -D

bun add @rsdoctor/rspack-plugin -D

deno add npm:@rsdoctor/rspack-plugin -D

2. Set the RSDOCTOR=true environment variable before running the CLI command:

{
  "scripts": {
    "build:rsdoctor": "RSDOCTOR=true rslib build"
  }
}

Because Windows does not support this syntax, you can use cross-env to set environment variables across different systems:

{
  "scripts": {
    "build:rsdoctor": "cross-env RSDOCTOR=true rslib build"
  },
  "devDependencies": {
    "cross-env": "^7.0.0"
  }
}

After running these scripts, Rslib automatically registers the Rsdoctor plugin and opens the build analysis page when the build finishes. See the Rsdoctor documentation for all features.

#Options

To configure the options exposed by the Rsdoctor plugin, manually register the plugin:

import { RsdoctorRspackPlugin } from '@rsdoctor/rspack-plugin';
import { defineConfig } from '@rslib/core';

export default defineConfig({
  lib: [
    // ...lib configuration
  ],
  tools: {
    rspack: {
      plugins: [
        process.env.RSDOCTOR === 'true' &&
          new RsdoctorRspackPlugin({
            // plugin options
          }),
      ],
    },
  },
});