#performance.buildCache

• Type:

type BuildCacheConfig =
  | boolean
  | {
      cacheDirectory?: string;
      cacheDigest?: Array<string | undefined>;
      buildDependencies?: string[];
    };

• Default: false
• Version: >= 1.2.5

To enable or configure persistent build cache.

When enabled, Rspack will store the build snapshots in the cache directory. In subsequent builds, if the cache is hit, Rspack can reuse the cached results instead of rebuilding from scratch, which can reduce the build time.

#Enable cache

Setting performance.buildCache to true will enable the persistent build cache:

export default {
  performance: {
    buildCache: true,
  },
};

Or only enable cache in development mode:

const isDev = process.env.NODE_ENV === 'development';

export default {
  performance: {
    buildCache: isDev,
  },
};

#Options

#cacheDirectory

• Type: string
• Default: node_modules/.cache

Set the output directory of the cache files.

import path from 'node:path';

export default {
  performance: {
    buildCache: {
      cacheDirectory: path.resolve(__dirname, 'node_modules/.my-cache'),
    },
  },
};

#cacheDigest

• Type: Array<string | undefined>
• Default: undefined

Add additional cache digests, the previous build cache will be invalidated when any value in the array changes.

cacheDigest allows you to add variables that affect the build result, for example process.env.SOME_ENV.

export default defineConfig({
  performance: {
    buildCache: {
      cacheDigest: [process.env.SOME_ENV],
    },
  },
});

#buildDependencies

• Type: string[]

buildDependencies is an array of additional code dependencies for the build. Rspack will use a hash of each of these items and all dependencies to invalidate the filesystem cache.

Equivalent to Rspack's cache.buildDependencies option.

#Default value

Rsbuild will use the following configuration files as the default build dependencies:

• package.json
• tsconfig.json
• .env, .env.*
• .browserslistrc
• tailwindcss.config.*

Additionally:

• When using Rsbuild CLI, it will also automatically add the Rsbuild configuration file (rsbuild.config.*) to the build dependencies.
• When using Rsbuild's loadConfig JS API, it will also automatically add the configuration file path to the build dependencies.

#Example

When you add other build dependencies, Rsbuild merges these custom dependencies with the default dependencies and passes them to Rspack.

export default {
  performance: {
    buildCache: {
      buildDependencies: [__filename],
    },
  },
};