Registry / devops / cosmic-esbuild

cosmic-esbuild

JSON →
library0.7.2jsnpmunverified

A configuration loader for esbuild that integrates with cosmiconfig, allowing users to define esbuild build options in familiar config formats (JSON, YAML, TOML, JS, TS, etc.) without custom scripts. Current stable version is 0.7.2, with monthly releases. Supports ESM and CommonJS, ships TypeScript types. Unlike esbuild's CLI, it auto-loads config from standard locations and supports watch mode. Requires Node >=20 and esbuild >=0.25.

devops
npm install cosmic-esbuild
github ↗package ↗
INSTALL
IMPORT
SIG · COSMIC-ESBUILD
C
cosmic-esbuild
devopsjavascriptv0.7.2
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

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

cosmicEsbuild
✓ import cosmicEsbuild from 'cosmic-esbuild'
✗ const cosmicEsbuild = require('cosmic-esbuild')
Default export; CJS require() works in Node but the package is ESM-first.
cosmicEsbuild
✓ import cosmicEsbuild from 'cosmic-esbuild'
Default export; CJS require() works in Node but the package is ESM-first.
build
✓ import { build } from 'cosmic-esbuild'
✗ import build from 'cosmic-esbuild'
Named export for programmatic use; not the default export.

Shows both config file and programmatic usage of cosmic-esbuild to build an esbuild project.

// Install: npm install cosmic-esbuild // cosmic-esbuild.config.js export default { entryPoints: ['src/index.js'], outdir: 'dist', bundle: true, minify: true, sourcemap: true, platform: 'node', target: 'node20' } // Run: // npx cosmic-esbuild // or programmatically: import cosmicEsbuild from 'cosmic-esbuild'; const result = await cosmicEsbuild(); console.log('Build completed', result);
Debug
Known issues
breakingRequired Node.js >=20 as of v0.6.0
fix
Upgrade Node.js to version 20 or higher.
affects: >=0.6.0
breakingPeer dependency esbuild >=0.25 required since v0.7.0
fix
Ensure esbuild is installed at version 0.25 or later.
affects: >=0.7.0
deprecatedDirect e18e dependency removed in v0.7.2
fix
No action needed; dependency was removed.
affects: >=0.7.2
gotchaCLI does not support all esbuild options; only basic flags are available.
fix
Use a configuration file for full esbuild build options.
affects: >=0.0.0
gotchaDefault outdir is not cwd; must be set explicitly or via config.
fix
Set 'outdir' in config or use --outdir flag.
affects: >=0.6.5
Errors
Common errors & fixes
Error: Cannot find module 'cosmic-esbuild'
Package not installed or not in node_modules.
fix
Run npm install cosmic-esbuild in your project.
TypeError: cosmicEsbuild is not a function
Importing named export when default export should be used.
fix
Use import cosmicEsbuild from 'cosmic-esbuild' (default import).
Error: esbuild version >=0.25 is required
Installed esbuild version is too old.
fix
Upgrade esbuild: npm install esbuild@latest
Error: Config file not found
No configuration file in standard locations or specified path is wrong.
fix
Create a config file like esbuild.config.js, or use --config flag with correct path.
Upgrade
Version history
0.7.2latest on npm
Audit
Dependencies
esbuildrequiredPeer dependency: the actual build tool that this package configures
Agent activity
9 hits · last 30 days
node
8
Resources
githubhttps://github.com/idleberg/cosmic-esbuild ↗
packagehttps://www.npmjs.com/package/cosmic-esbuild ↗
cosmic-esbuild — npm install cosmic-esbuild · libregistry