codeSplitting

• Type: boolean | object with the properties below
• Optional

Defined in: options/output-options.ts:557

Controls how code splitting is performed.

• true: Default behavior, automatic code splitting. (default)
• false: Inline all dynamic imports into a single bundle (equivalent to deprecated inlineDynamicImports: true).
• object: Advanced manual code splitting configuration.

For deeper understanding, please refer to the in-depth documentation.

Example

Basic vendor chunk

export default defineConfig({
  output: {
    codeSplitting: {
      minSize: 20000,
      groups: [
        {
          name: 'vendor',
          test: /node_modules/,
        },
      ],
    },
  },
});

Multiple chunk groups with priorities

export default defineConfig({
  output: {
    codeSplitting: {
      groups: [
        {
          name: 'react-vendor',
          test: /node_modules[\\/]react/,
          priority: 20,
        },
        {
          name: 'ui-vendor',
          test: /node_modules[\\/](antd%7C@mui)/,
          priority: 15,
        },
        {
          name: 'vendor',
          test: /node_modules/,
          priority: 10,
        },
        {
          name: 'common',
          minShareCount: 2,
          minSize: 10000,
          priority: 5,
        },
      ],
    },
  },
});

Size-based splitting

export default defineConfig({
  output: {
    codeSplitting: {
      groups: [
        {
          name: 'large-libs',
          test: /node_modules/,
          minSize: 100000, // 100KB
          maxSize: 250000, // 250KB
          priority: 10,
        },
      ],
    },
  },
});

Default

true

groups?

• Type: CodeSplittingGroup[]
• Optional

Defined in: options/output-options.ts:850

Groups to be used for code splitting.

includeDependenciesRecursively?

• Type: boolean
• Optional

Defined in: options/output-options.ts:826

By default, each group will also include captured modules' dependencies. This reduces the chance of generating circular chunks.

If you want to disable this behavior, it's recommended to both set

• preserveEntrySignatures: false | 'allow-extension'
• strictExecutionOrder: true

to avoid generating invalid chunks.

Default

true

maxModuleSize?

• Type: number
• Optional

Defined in: options/output-options.ts:838

Global fallback of group.maxModuleSize, if it's not specified in the group.

maxSize?

• Type: number
• Optional

Defined in: options/output-options.ts:834

Global fallback of group.maxSize, if it's not specified in the group.

minModuleSize?

• Type: number
• Optional

Defined in: options/output-options.ts:842

Global fallback of group.minModuleSize, if it's not specified in the group.

minShareCount?

• Type: number
• Optional

Defined in: options/output-options.ts:846

Global fallback of group.minShareCount, if it's not specified in the group.

minSize?

• Type: number
• Optional

Defined in: options/output-options.ts:830

Global fallback of group.minSize, if it's not specified in the group.