Registry /
web-framework / esbuild-plugin-stimulus
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
muslnode 18–223 runs
build_error
glibcnode 18–223 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
stimulusPlugin
✓ const { stimulusPlugin } = require('esbuild-plugin-stimulus')
✗ import stimulusPlugin from 'esbuild-plugin-stimulus'
Uses CommonJS with named export; no default export. For ESM, use const { stimulusPlugin } = await import('esbuild-plugin-stimulus').
definitions
✓ import { definitions } from 'stimulus:./controllers'
✗ import definitions from 'stimulus:./controllers'
Named export from a virtual module with stimulus: prefix. Path is relative to project root.
Definition
✓ import type { Definition } from '@hotwired/stimulus'
Type import for the Definition type used in the .d.ts declaration. Only needed in TypeScript.
Sets up esbuild with the plugin and uses the virtual module to load controllers from the ./controllers directory.
// build.js (CommonJS)
const esbuild = require('esbuild');
const { stimulusPlugin } = require('esbuild-plugin-stimulus');
esbuild.build({
entryPoints: ['app.js'],
bundle: true,
outfile: 'dist/bundle.js',
plugins: [stimulusPlugin()],
}).catch(() => process.exit(1));
// app.js (ESM)
import { Application } from '@hotwired/stimulus';
import { definitions } from 'stimulus:./controllers';
const app = Application.start();
app.load(definitions);
// esbuild-plugin-stimulus.d.ts (optional, for TypeScript)
declare module 'stimulus:*' {
import type { Definition } from '@hotwired/stimulus';
export const definitions: Definition[];
}
Errors
Common errors & fixes
TypeScript error: Cannot find module 'stimulus:./controllers' or its corresponding type declarations.
Missing type declaration file for the virtual module.
fixAdd a `esbuild-plugin-stimulus.d.ts` file (as shown in the quickstart) to your project.
Error: [esbuild] Plugin 'stimulus' returned an error: Could not resolve 'stimulus:./controllers'
The stimulus plugin is not included in the esbuild plugins array.
fixAdd `stimulusPlugin()` to the `plugins` array in your esbuild configuration.
Audit
Dependencies
esbuildrequiredpeer dependency; provides the plugin API and build system
@hotwired/stimulusoptionalruntime peer; needed for Application and types