Registry /
devops / rollup-plugin-invariant
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.
default
✓ import invariantPlugin from 'rollup-plugin-invariant'
✗ const invariantPlugin = require('rollup-plugin-invariant')
The package exports a single function; default import is correct. CJS require works but is not the recommended ES module syntax.
invariantPlugin
✓ import invariantPlugin from 'rollup-plugin-invariant'
✗ import { invariantPlugin } from 'rollup-plugin-invariant'
Named export does not exist; use default import.
invariantPlugin (used in rollup.config)
✓ import invariant from 'rollup-plugin-invariant'
✗ import { default as invariantPlugin } from 'rollup-plugin-invariant'
You can rename the default import to any name; common is 'invariant' (unrelated to the 'invariant' package).
Configures rollup-plugin-invariant in a rollup config, showing include/exclude options and production flag override.
// rollup.config.js
import invariantPlugin from 'rollup-plugin-invariant';
export default {
input: 'src/index.js',
output: {
dir: 'dist',
format: 'esm'
},
plugins: [
invariantPlugin({
// Default: include all files
include: ['**/*.js'],
// Optionally exclude node_modules
exclude: ['node_modules/**'],
// Force production mode (default: process.env.NODE_ENV === 'production')
production: true
})
]
};
Errors
Common errors & fixes
Error: Unknown plugin options: include, exclude
Using options 'include' and 'exclude' as top-level plugin options instead of nested under 'invariantPlugin'.
fixOptions are passed as object to the plugin function: invariantPlugin({ include: ... }) Audit
Dependencies
@rollup/pluginutilsrequiredused for creating filter function from include/exclude options
invariantrequiredpeer dependency; the invariant package that provides the function to be stripped