rollup-plugin-browserify-transform

1.0.1 verified Mon Apr 27 auth: no javascript

A Rollup plugin that lets you use any Browserify transform (e.g., brfs, coffeeify) within Rollup. Version 1.0.1 is stable but rarely updated; it bridges gaps where no equivalent Rollup plugin exists. Unlike manual transform replication, this plugin wraps Browserify transforms directly, accepting options like include/exclude patterns. It depends on Rollup's plugin system and the transform package itself. Use when migrating from Browserify to Rollup, but prefer native Rollup plugins for performance and compatibility.

Common errors

error Error: Cannot find module 'rollup-plugin-browserify-transform' ↓

cause Package not installed or incorrect import path.

fix

Run npm install --save-dev rollup-plugin-browserify-transform

error TypeError: browserifyPlugin is not a function ↓

cause Named import when only default export exists.

fix

Use import browserifyPlugin from 'rollup-plugin-browserify-transform'

error The transform function must be a function. Got undefined ↓

cause Passed a module name string instead of the actual transform function.

fix

Import the transform module and pass the function: import brfs from 'brfs'; browserifyPlugin(brfs)

Warnings

gotcha Browserify transforms may not work correctly with ES module syntax or Rollup's tree-shaking. ↓

fix Test transforms thoroughly; prefer native Rollup plugins when available.

breaking Breaking change: Rollup >=0.25 required; older versions not supported. ↓

fix Upgrade Rollup to 0.25 or later.

gotcha The plugin ignores include/exclude options if not provided; defaults to all files. ↓

fix Explicitly set include/exclude to narrow scope and avoid unnecessary transforms.

Install

npm install rollup-plugin-browserify-transform

yarn add rollup-plugin-browserify-transform

pnpm add rollup-plugin-browserify-transform

Imports

default (browserifyPlugin)

wrong

const browserifyPlugin = require('rollup-plugin-browserify-transform')

correct

import browserifyPlugin from 'rollup-plugin-browserify-transform'

Default export, not named. CommonJS require works but is not recommended for ESM projects.

browserifyPlugin (with named import)

wrong

const { browserifyPlugin } = require('rollup-plugin-browserify-transform')

correct

import { browserifyPlugin } from 'rollup-plugin-browserify-transform'

No named export exists; only default export. Use default import.

transform function usage

wrong

browserifyPlugin(require('brfs')); // works but ESM prefer imports

correct

import brfs from 'brfs';
browserifyPlugin(brfs)

Pass the transform function directly, not a module path string.

Quickstart

Shows how to use the default export with a Browserify transform (brfs) in Rollup config.

// rollup.config.js (ESM)
import browserifyPlugin from 'rollup-plugin-browserify-transform';
import brfs from 'brfs';

export default {
  input: 'src/index.js',
  output: { file: 'dist/bundle.js', format: 'cjs' },
  plugins: [
    browserifyPlugin(brfs, { /* transform options */ }),
  ],
};