Functionality
This setup works out-of-the-box. It also includes a watcher which re-bundles the JS files whenever a JS file changes.
Usage
Write modern JS
You can write modern JS with support for ES modules using import statements and most ES2015/16 features without worrying about transpiling to ES5 for older browsers.
Rollup is used to write modular JS and tree-shake unused functions. This setup is pre-configured to compile all your JS in the src/ directory using the following plugins:
- Node Resolve Plugin to use external ES modules.
- CommonJS Plugin to use external CommonJS modules.
- Buble for fast and lightweight transpiling of your code to ES5. If you need more feature support, consider the heavier Babel Plugin.
- Uglify to minify your JS for production.
- ESLint to validate syntax and code style.
- Rollup Watch for fast incremental rebuilds during development.
src/index.js is the main entry point for the JS compile script. So be sure to start there.
Add & configure plugins
You can configure the plugins mentioned above or add your own plugins in rollup.config.js.
Compile JS
To compile your JS for production (incl. minification), run:
npm run build:jsOr simply npm run build as this will also run build:js.
The compiled JS plus its sourcemap is written to the dist/ directory.
Note: console and debugger are only allowed in development.
Development
To compile your JS (excl. minification) whenever you make a change to a JS file:
npm run watch:jsOr simply npm run watch as this will also run watch:js.
These scripts are configured in package.json.