An ES6+ aware minifier based on the Babel toolchain.

• Checkout our CONTRIBUTING.md if you want to help out!

• Babili is consumable via API, CLI, or Babel preset.

• Try it online - babeljs.io/repl

• Requirements
• Why
• CLI
• Babel Preset
• Individual Plugins
• Benchmarks
• Team

• node >= 4
• babel >= 6.20.0

Current tools don't support targeting the latest version of ECMAScript. (yet)

• Babili can because it is just a set of Babel plugins, and Babel already understands new syntax with our parser Babylon.
• When it's possible to only target browsers that support newer ES features, code sizes can be smaller because you don't have to transpile and then minify.

Check out our blog post for more info!

// Example ES2015 Code
class Mangler {
  constructor(program) {
    this.program = program;
  }
}
new Mangler(); // without this it would just output nothing since Mangler isn't used

Before

// ES2015+ code -> Babel -> Babili/Uglify -> Minified ES5 Code
var a=function a(b){_classCallCheck(this,a),this.program=b};new a;

After

// ES2015+ code -> Babili -> Minified ES2015+ Code
class a{constructor(b){this.program=b}}new a;

Package	Version	Dependencies
babili

This is simple wrapper around the regular babel-cli and thus takes in the same cli options as running babel on its own. You can use this if you don't already use babel or want to run it standalone.

npm install babili --save-dev

babili src -d lib

Equivalent to:

babel src -d lib --presets=babili --no-babelrc

Note that, because the babili command uses the default preset with no-babelrc, you cannot set any non-default options in the preset's plugins with this command. To do this, you can use the babel command with the options set in a .babelrc. See the preset docs for more information on how to do this.

Package	Version	Dependencies
babel-preset-babili

npm install babel-preset-babili --save-dev

You'll most likely want to use it only in the production environment. Check out the env docs for more help.

Options specific to a certain environment are merged into and overwrite non-env specific options.

.babelrc:

{
  "presets": ["es2015"],
  "env": {
    "production": {
      "presets": ["babili"]
    }
  }
}

Then you'll need to set the env variable which could be something like BABEL_ENV=production npm run build

The babili repo is comprised of many npm packages. It is a lerna monorepo similar to babel itself.

The npm package babel-preset-babili is at the path packages/babel-preset-babili

Package	Version	Dependencies
babel-plugin-minify-constant-folding
babel-plugin-minify-dead-code-elimination
babel-plugin-minify-flip-comparisons
babel-plugin-minify-guarded-expressions
babel-plugin-minify-infinity
babel-plugin-minify-mangle-names
babel-plugin-minify-replace
babel-plugin-minify-simplify
babel-plugin-minify-type-constructors
babel-plugin-transform-member-expression-literals
babel-plugin-transform-merge-sibling-variables
babel-plugin-transform-minify-booleans
babel-plugin-transform-property-literals
babel-plugin-transform-simplify-comparison-operators
babel-plugin-transform-undefined-to-void

Normally you wouldn't be consuming the plugins directly since the preset is available.

Add to your .babelrc's plugins array.

{
  "plugins": ["babel-plugin-transform-undefined-to-void"]
}

Package	Version	Dependencies
babel-plugin-transform-inline-environment-variables
babel-plugin-transform-node-env-inline
babel-plugin-transform-remove-console
babel-plugin-transform-remove-debugger

Bootstrap: npm run bootstrap

Build: npm run build

Running the benchmarks: ./scripts/benchmark.js [file...] - defaults to a few packages fetched from unpkg.com and is defined in benchmark.js.

Note: All Input sources are ES5.

Benchmark Results for react.js:

Input Size: 133.2kB

Input Size (gzip): 31.03kB

Benchmark Results for vue.js:

Input Size: 248.78kB

Input Size (gzip): 68.52kB

Benchmark Results for lodash.js:

Input Size: 526.94kB

Input Size (gzip): 93.91kB

Benchmark Results for three.js:

Input Size: 1008.64kB

Input Size (gzip): 200.53kB

Babili is best at targeting latest browsers (with full ES6+ support) but can also be used with the usual Babel es2015 preset to transpile down the code first.

Amjad Masad	Boopathi Rajaa	Juriy Zaytsev	Henry Zhu	Vignesh Shanmugam
@amasad	@boopathi	@kangax	@hzoo	@vigneshshanmugam
@amasad	@heisenbugger	@kangax	@left_pad	@_vigneshh