Home > @lynx-js/rspeedy > Config > mode

#Config.mode property

Specify the build mode for Rsbuild and Rspack, as each mode has different default behavior and optimizations.

Signature:

mode?: 'development' | 'production' | 'none' | undefined;

#Default Value

Depends on process.env.NODE_ENV: 'production' when NODE_ENV is 'production', 'development' when NODE_ENV is 'development', and 'none' otherwise. When using Rspeedy's CLI, rspeedy dev and rspeedy preview default to 'development', while rspeedy build defaults to 'production'.

#Example 1

If the value of mode is 'development':

• Enable HMR and register the HotModuleReplacementPlugin.

• Generate JavaScript source maps, but do not generate CSS source maps. See Output.sourceMap for details.

• The process.env.NODE_ENV in the source code will be replaced with 'development'.

• The import.meta.env.MODE in the source code will be replaced with 'development'.

• The import.meta.env.DEV in the source code will be replaced with true.

• The import.meta.env.PROD in the source code will be replaced with false.

#Example 2

If the value of mode is 'production':

• Enable JavaScript code minification and register the SwcJsMinimizerRspackPlugin.

• Generated JavaScript and CSS filenames will have hash suffixes, see Output.filenameHash.

• Generated CSS Modules classnames will be shorter, see CssModules.localIdentName.

• Do not generate JavaScript and CSS source maps, see Output.sourceMap.

• The process.env.NODE_ENV in the source code will be replaced with 'production'.

• The import.meta.env.MODE in the source code will be replaced with 'production'.

• The import.meta.env.DEV in the source code will be replaced with false.

• The import.meta.env.PROD in the source code will be replaced with true.