“ignore” in Bower's bower.json?

Question

Bower's website describes the ignore key in bower.json:

ignore [array]: An array of paths not needed in production that you want Bower to ignore when installing your package.

Does this mean that it's ignoring paths in installed components, or in your package? Or something else? I was confused by this.

Answer 1

TL;DR:

ignore only works within the scope of packages being installed, ignoring matching patterns.

---

Somewhat longer answer:

Bower will ignore all files matching the patterns specified in the ignore property of bower.json in installed packages.

So, suppose if you ran bower install someBowerPackage which had following structure:

someBowerPackage
|- css/
|- js/
|- index.html
|- bower.json

with a bower.json file having:

{
  ...
  "ignore": [ "index.html" ]
}

then, index.html file of this someBowerPackage will not be installed within this package.

Answer 2

• ignore is related to the files in your package
• You can't ignore on behalf of other packages
• Dependencies are loaded all or none

Answer 3

ignore values are only applied to packages fetched from a bower install endpoint by that component's bower.json file.
ignore values specified in project-root/bower.json have no effect on packages fetched as that project's components.

The bower.json Spec has been documented in its own github repo since this question was originally asked.

Ignore

Recommended
Type: Array of String

A list of files for Bower to ignore when installing your package.

Note: symbolic links will always be ignored. However bower.json will never be ignored.

The ignore rules follow the same rules specified in the gitignore pattern spec.

Files matching globs or file values in ignore will not be downloaded from an endpoint as part of the package.