cush

library0.2.3jsnpmunverified

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.

devops

npm install cush

github ↗package ↗

INSTALL

IMPORT

SIG · CUSH

cush

devopsjavascriptv0.2.3

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–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

bundle

✓ import { bundle } from 'cush'

✗ const bundle = require('cush').bundle

Cush is ESM-only; CommonJS require is not supported.

FileInfo

✓ import { FileInfo } from 'cush'

TypeScript types may require additional type imports.

Plugin

✓ import type { Plugin } from 'cush'

Use import type for TypeScript interfaces.

Basic usage: imports bundle and Config, defines a configuration with TypeScript and resolve plugins, then calls bundle.

import { bundle, Config } from 'cush'; const config: Config = { entry: './src/index.ts', output: './dist/bundle.js', plugins: ['typescript', 'resolve'], }; bundle(config).then(() => { console.log('Bundled successfully'); }).catch(err => { console.error('Bundle failed:', err); });

cush --version

Debug

Known issues

gotchaCush requires Node.js >=9, but ESM support may be incomplete in older versions.

fix

Upgrade Node.js to >=12 for full ESM compatibility.

affects: >=0

deprecatedThe plugin API is experimental and may change in breaking ways.

fix

Pin to a specific version and monitor the plugin API changes.

affects: >=0.2.0

gotchaAutomatic plugin installation may fetch unexpected versions; use package.json resolutions.

fix

Explicitly specify plugin versions in configuration or package.json.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'cush'

Missing or incorrect install path.

fix

Run 'npm install cush' at project root.

TypeError: (0 , cush.bundle) is not a function

Using CommonJS require instead of ESM import.

fix

Use 'import { bundle } from 'cush'' in an ESM context.

Upgrade

Version history

0.2.3latest on npm

Audit

Dependencies

wchoptionalfile watching

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/aleclarson/cush ↗

packagehttps://www.npmjs.com/package/cush ↗