{"id":22606,"library":"vite-plugin-chunk-split","title":"vite-plugin-chunk-split","description":"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.","status":"active","version":"0.5.0","language":"javascript","source_language":"en","source_url":"ssh://git@github.com/sanyuan0704/vite-plugin-chunk-split","tags":["javascript","vite","code-splitting","typescript"],"install":[{"cmd":"npm install vite-plugin-chunk-split","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-chunk-split","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-chunk-split","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency required for plugin to function","package":"vite","optional":false}],"imports":[{"note":"Named export; default import will fail.","wrong":"import chunkSplitPlugin from 'vite-plugin-chunk-split'","symbol":"chunkSplitPlugin","correct":"import { chunkSplitPlugin } from 'vite-plugin-chunk-split'"},{"note":"Use type import for TypeScript type definitions.","wrong":"import { ChunkSplitOptions } from 'vite-plugin-chunk-split'","symbol":"ChunkSplitOptions","correct":"import type { ChunkSplitOptions } from 'vite-plugin-chunk-split'"},{"note":"Must destructure require; plugin is not default exported.","wrong":"const chunkSplitPlugin = require('vite-plugin-chunk-split')","symbol":"chunkSplitPlugin (require)","correct":"const { chunkSplitPlugin } = require('vite-plugin-chunk-split')"}],"quickstart":{"code":"import { chunkSplitPlugin } from 'vite-plugin-chunk-split';\n\nexport default {\n  plugins: [\n    chunkSplitPlugin({\n      strategy: 'single-vendor',\n      customSplitting: {\n        'react-vendor': ['react', 'react-dom'],\n        'utils': [/src\\/utils/]\n      }\n    })\n  ]\n};","lang":"typescript","description":"Configures the plugin with single-vendor strategy groups react/react-dom into one chunk and files matching /src\\/utils/ into another."},"warnings":[{"fix":"Use 'customSplitting' instead.","message":"Options 'customChunk' does not exist; property is 'customSplitting' only.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Define custom chunk logic via 'customSplitting' only.","message":"Strategy 'single-vendor' uses 'customChunk' in examples but it is not an option; the plugin only accepts 'strategy' and 'customSplitting'.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"","message":"No breaking changes known; check GitHub for updates.","severity":"deprecated","affected_versions":">=0.0.0"},{"fix":"Use named import: import { chunkSplitPlugin } from 'vite-plugin-chunk-split'.","message":"Incorrect import: import default from 'vite-plugin-chunk-split' returns undefined.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Upgrade Vite to version 4 or 5.","cause":"Vite version mismatch; plugin requires Vite 4 or 5.","error":"Error: The plugin 'vite-plugin-chunk-split' requires vite version ^4 or ^5, but you have vite@3.2.0."},{"fix":"Use const { chunkSplitPlugin } = require('vite-plugin-chunk-split') or import { chunkSplitPlugin } from 'vite-plugin-chunk-split'.","cause":"Default import instead of named import.","error":"TypeError: chunkSplitPlugin is not a function"},{"fix":"Replace 'customChunk' with 'customSplitting' in config.","cause":"Typo in option name.","error":"Property 'customChunk' does not exist on type 'ChunkSplitOptions'."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}