Registry / devops / vite-plugin-chunk-split

vite-plugin-chunk-split

library0.5.0jsnpmunverified

A Vite plugin for fine-grained chunk splitting (v0.5.0, active development). Provides strategies like 'default', 'all-in-one', 'single-vendor', and 'unbundle' (one chunk per file). Supports custom splitting via regex/string patterns for grouping modules. Differentiates from Vite's built-in rollupOptions.output.manualChunks by offering simpler declarative config and pre-built strategies. Requires Vite ^4 or ^5.

devops web-framework

npm install vite-plugin-chunk-split

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-CHUNK-

vite-plugin-chunk-split

devopsjavascriptv0.5.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

chunkSplitPlugin

✓ import { chunkSplitPlugin } from 'vite-plugin-chunk-split'

✗ import chunkSplitPlugin from 'vite-plugin-chunk-split'

Named export; default import will fail.

ChunkSplitOptions

✓ import type { ChunkSplitOptions } from 'vite-plugin-chunk-split'

✗ import { ChunkSplitOptions } from 'vite-plugin-chunk-split'

Use type import for TypeScript type definitions.

chunkSplitPlugin (require)

✓ const { chunkSplitPlugin } = require('vite-plugin-chunk-split')

✗ const chunkSplitPlugin = require('vite-plugin-chunk-split')

Must destructure require; plugin is not default exported.

Configures the plugin with single-vendor strategy groups react/react-dom into one chunk and files matching /src\/utils/ into another.

import { chunkSplitPlugin } from 'vite-plugin-chunk-split'; export default { plugins: [ chunkSplitPlugin({ strategy: 'single-vendor', customSplitting: { 'react-vendor': ['react', 'react-dom'], 'utils': [/src\/utils/] } }) ] };

Debug

Known issues

gotchaOptions 'customChunk' does not exist; property is 'customSplitting' only.

fix

Use 'customSplitting' instead.

affects: >=0.0.0

gotchaStrategy 'single-vendor' uses 'customChunk' in examples but it is not an option; the plugin only accepts 'strategy' and 'customSplitting'.

fix

Define custom chunk logic via 'customSplitting' only.

affects: >=0.0.0

deprecatedNo breaking changes known; check GitHub for updates.

affects: >=0.0.0

gotchaIncorrect import: import default from 'vite-plugin-chunk-split' returns undefined.

fix

Use named import: import { chunkSplitPlugin } from 'vite-plugin-chunk-split'.

affects: >=0.0.0

Errors

Common errors & fixes

Error: The plugin 'vite-plugin-chunk-split' requires vite version ^4 or ^5, but you have vite@3.2.0.

Vite version mismatch; plugin requires Vite 4 or 5.

fix

Upgrade Vite to version 4 or 5.

TypeError: chunkSplitPlugin is not a function

Default import instead of named import.

fix

Use const { chunkSplitPlugin } = require('vite-plugin-chunk-split') or import { chunkSplitPlugin } from 'vite-plugin-chunk-split'.

Property 'customChunk' does not exist on type 'ChunkSplitOptions'.

Typo in option name.

fix

Replace 'customChunk' with 'customSplitting' in config.

Upgrade

Version history

0.5.0latest on npm

Audit

Dependencies

viterequiredpeer dependency required for plugin to function

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/sanyuan0704/vite-plugin-chunk-split ↗

packagehttps://www.npmjs.com/package/vite-plugin-chunk-split ↗