@rollup/plugin-run

Run your bundle after you've built it

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@rollup/plugin-run
3,134553.0.15 months ago3 years agoMinified + gzip package size for @rollup/plugin-run in KB

Readme

!npmnpmnpm-url !sizesizesize-url libera manifesto
@rollup/plugin-run
šŸ£ A Rollup plugin which runs your bundles in Node once they're built.
Using this plugin gives much faster results compared to what you would do with nodemon.

Requirements

This plugin requires an LTS Node version (v14.0.0+) and Rollup v2.0.0+.

Install

Using npm:
npm install @rollup/plugin-run --save-dev

Usage

Create a rollup.config.js configuration file and import the plugin:
import run from '@rollup/plugin-run';

export default {
  input: 'src/index.js',
  output: {
    file: 'dist/index.js',
    format: 'cjs'
  },
  plugins: [run()]
};

Then call rollup either via the CLI or the API. If the build produces any errors, the plugin will write a 'alias' character to stderr, which should be audible on most systems.
The plugin forks a child process with the generated file, every time the bundle is rebuilt (after first closing the previous process, if it's not the first run).
Note: This plugin works with Rollup's code-splitting if you're using dynamic import(...) ā€” the only constraint is that you have a single entry point specified in the config.

Options

This plugin supports pass through option available for childprocess.fork(...).
Example:
Debugging with sourcemaps using source-map-support:
// rollup.config.js
import run from '@rollup/plugin-run';

export default {
  input: 'src/index.js',
  output: {
    file: 'dist/index.js',
    format: 'cjs',
+    sourcemap: true
  },
  plugins: [
-    run()
+    run({
+      execArgv: ['-r', 'source-map-support/register']
+    })
  ]
};

allowRestarts

Type: Boolean
Default: false
If true, instructs the plugin to listen to stdin for the sequences listed below followed by enter (carriage return).

stdin Input Actions

When this option is enabled, stdin will listen for the following input and perform the associated action:
  • restart ā†’ Kills the currently running bundle and starts it again. Note: This does not create a new bundle, the bundle is run again "as-is". This can be used to test configuration changes or other changes that are made without modifying your source
Also allowed: rs, CTRL+K
  • clear ā†’ Clears the screen of all text
Also allowed: cls, CTRL+L

Practical Example

The feature is usually intended for development use, you may prefer to only include it when Rollup is being run in watch mode:
// rollup.config.js
import run from '@rollup/plugin-run';

+const dev = process.env.ROLLUP_WATCH === 'true';

export default {
  input: 'src/index.js',
  output: {
    file: 'dist/index.js',
    format: 'cjs'
  },
  plugins: [
-    run()
+    dev && run()
  ]
};

Meta

CONTRIBUTING
LICENSE (MIT)