server.htmlFallback

  • Type: false | 'index'
  • Default: 'index'

Whether to enable HTML fallback.

Default behavior

By default, when the request meets the following conditions and the corresponding resource is not found, it will fallback to index.html:

  • The request is a GET or HEAD request
  • Which accepts text/html (the request header accept type is text/html or */*)
rsbuild.config.ts
export default {
  server: {
    htmlFallback: 'index',
  },
};

Disable

If you don't want to enable HTML fallback, you can set server.htmlFallback to false.

rsbuild.config.ts
export default {
  server: {
    htmlFallback: false,
  },
};

Customize

If server.htmlFallback cannot meet your needs, you can use server.historyApiFallback for more flexible settings.