{"id":18259,"library":"cush","title":"Cush","description":"Cush is a modern module bundler for Node.js (>=9) focused on eager bundling, symlink-friendly resolution, and approachable configuration. Version 0.2.3 is the latest stable release, with an experimental API and limited adoption. It features automatic plugin installation, a worker farm for heavy tasks, and a simple plugin API. Differentiators include its use of wch for file watching and symlink support, though it is less mature compared to webpack or rollup.","status":"maintenance","version":"0.2.3","language":"javascript","source_language":"en","source_url":"https://github.com/aleclarson/cush","tags":["javascript"],"install":[{"cmd":"npm install cush","lang":"bash","label":"npm"},{"cmd":"yarn add cush","lang":"bash","label":"yarn"},{"cmd":"pnpm add cush","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"file watching","package":"wch","optional":true}],"imports":[{"note":"Cush is ESM-only; CommonJS require is not supported.","wrong":"const bundle = require('cush').bundle","symbol":"bundle","correct":"import { bundle } from 'cush'"},{"note":"TypeScript types may require additional type imports.","symbol":"FileInfo","correct":"import { FileInfo } from 'cush'"},{"note":"Use import type for TypeScript interfaces.","symbol":"Plugin","correct":"import type { Plugin } from 'cush'"}],"quickstart":{"code":"import { bundle, Config } from 'cush';\n\nconst config: Config = {\n  entry: './src/index.ts',\n  output: './dist/bundle.js',\n  plugins: ['typescript', 'resolve'],\n};\n\nbundle(config).then(() => {\n  console.log('Bundled successfully');\n}).catch(err => {\n  console.error('Bundle failed:', err);\n});","lang":"typescript","description":"Basic usage: imports bundle and Config, defines a configuration with TypeScript and resolve plugins, then calls bundle."},"warnings":[{"fix":"Upgrade Node.js to >=12 for full ESM compatibility.","message":"Cush requires Node.js >=9, but ESM support may be incomplete in older versions.","severity":"gotcha","affected_versions":">=0"},{"fix":"Pin to a specific version and monitor the plugin API changes.","message":"The plugin API is experimental and may change in breaking ways.","severity":"deprecated","affected_versions":">=0.2.0"},{"fix":"Explicitly specify plugin versions in configuration or package.json.","message":"Automatic plugin installation may fetch unexpected versions; use package.json resolutions.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install cush' at project root.","cause":"Missing or incorrect install path.","error":"Error: Cannot find module 'cush'"},{"fix":"Use 'import { bundle } from 'cush'' in an ESM context.","cause":"Using CommonJS require instead of ESM import.","error":"TypeError: (0 , cush.bundle) is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}