For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /config/context.md.
close

Context

  • Type: string
  • Default:process.cwd()

The context configuration is used to set the base directory for Rspack builds.

context is an absolute path that is used as the base path for relative paths in Rspack configurations such as entry and output.

By default, Rspack uses the current working directory of the Node.js process as the base directory. In most cases, it is recommended to set a base directory manually, rather than relying on the current working directory of Node.js.

Example

For example, you can use __dirname as the base directory:

ESM
CJS
rspack.config.mjs
import { dirname } from 'node:path';
import { fileURLToPath } from 'node:url';

const __dirname = dirname(fileURLToPath(import.meta.url));

export default {
  context: __dirname,
  entry: {
    main: './src/index.js',
  },
};

In the above example, the main entry will be resolved based on the path.join(__dirname, './src/index.js') path.

This page is adapted from webpack documentation under the CC BY 4.0, with modifications.