Polymer Bundler

polymer-bundler is a library for packaging project assets for production to minimize network round-trips.

Relationship to Polymer CLI

The Polymer CLI uses polymer-build, which uses polymer-bundler, so you can think of the CLI's build pre-configured polymer-build pipeline including polymer-bundler. Setting this up for you makes the CLI easy to use, but as a command-line wrapper its customization options are more limited. polymer-bundler allows you to completely customize your bundle strategy.

Usage

Web pages that use multiple HTML Imports, external scripts, and stylesheets to load dependencies may end up making lots of network round-trips. In many cases, this can lead to long initial load times and unnecessary bandwidth usage. The polymer-bundler tool follows HTML Imports, external script and stylesheet references, inlining these external assets into "bundles", to be used in production.

In the future, technologies such as HTTP/2 and Server Push will likely obsolete the need for a tool like polymer-bundler for web deployment uses.

Installation

polymer-bundler is available on npm. For maximium utility, polymer-bundler should be installed globally.

npm install -g polymer-bundler

This will install polymer-bundler to /usr/local/bin/polymer-bundler (you may need sudo
for this step).

Options

- -h|--help: Print this message
- -v|--version: Print version number
- -r|--root: The root of the package/project being bundled. Defaults to the current working folder.
- --exclude : Exclude a subpath from root. Use multiple times to exclude multiple paths. Tags (imports/scripts/etc) that reference an excluded path are left in-place, meaning the resources are not inlined. ex: --exclude=elements/x-foo.html --exclude=elements/x-bar.html
- --inline-scripts: External scripts will only be inlined if this flag is provided.
- --inline-css: External stylesheets will only be inlined if this flag is provided.
- --manifest-out : If specified, the bundle manifest will be written out to .
- --redirect |: Routes URLs with arbitrary , possibly including a protocol, hostname, and/or path prefix to a on local filesystem. For example --redirect "myapp://|src" would route myapp://main/home.html to ./src/main/home.html. Multiple redirects may be specified; the earliest ones have the highest priority.
- --rewrite-urls-in-templates: Fix URLs found inside