Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

npmignore

ljharb50.2kMIT0.3.1

Command line tool for creating or updating a .npmignore file based on .gitignore.

npmignore, gitignore

readme

npmignore NPM version

Command line tool for creating or updating a .npmignore file based on .gitignore.

Usage

Say .gitignore has:

node_modules/
build/

… so that build output is not committed, and you want .npmignore to have:

node_modules/
src/
test/

… so that source files and test files are not published, but build output is.

Automatic usage

On the command line, run npm install --save-dev npmignore.

In your .gitignore, add .npmignore so that the .npmignore file is no longer committed to version control.

In your package.json, add the following JSON to “scripts” and “publishConfig”:

"scripts": {
    …
    "prepack": "npmignore --auto"
    …
},
"publishConfig": {
    …
    "ignore": [
        "!build/",
        "src/",
        "test/"
    ]
    …
}

Whenever you run npm pack or npm publish, an .npmignore file will automatically be created:

node_modules/
build/

# npmignore
!build/
src/
test/

Manual usage

On the command line run:

npx npmignore -i src/,test/,!build/

An .npmignore file will be created, or updated:

node_modules/
build/

# npmignore
!build/
src/
test/

Heads up!

The # npmignore comment is used to ensure that .npmignore reflects the latest changes in your .gitignore file, just by running npmignore in the command line.

_If you want to preserve everything in your .npmignore file, regardless of what is in .gitignore, just add the # npmignore comment at the top of the .npmignore file.

Verification

Run npm pack --dry-run (or npm publish --dry-run) in a modern version of npm to get a printout of the files that will be included in your npm package.

CLI commands

  • --auto: automatic mode. The --ignore, --unignore, keepdest, and --npmignore options are incompatible with this mode.
  • -i|--ignore: comma-separated list of patterns to add to .npmignore
  • -u|--unignore: comma-separated list of patterns to remove from .npmignore. This will not un-ignore patterns in .gitignore.
  • -d|--dest: optionally define a different destination filepath. Good for test driving to see what will be generated in advance.
  • -g|--gitignore: alternate source filepath for .gitignore.
  • -n|--npmignore: alternate source filepath for .npmignore.
  • -k|--keepdest: avoids altering the destination file
  • --commentLines: a comma-separated list of lines of comment text.

API

To use via API, first:

npm install --save npmignore

Then:

var npmignore = require('npmignore');

npmignore(npm, git, options);

Params

  • npm {String|Array}: String from .npmignore or an array of patterns to use.
  • git {String|Array}: String from .gitignore or an array of patterns to use.
  • options {Object}
    • commentLines Array of comment lines. Defaults to:
        [
            'content above this line is automatically generated and modifications may be omitted',
            'see npmjs.com/npmignore for more details.'
        ]
    • ignore Array of patterns to add to the existing patterns from .gitignore
    • unignore Array of patterns to remove from .npmignore. This will not un-ignore patterns in .gitignore
    • keepdest if true, avoids altering the destination file

Tests

Simply clone the repo, npm install, and run npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue

changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v0.3.1 - 2023-11-29

Commits

  • [meta] update editorconfig c4b7754
  • [actions] remove redundant workflow fcdc202
  • [Tests] add nyc 98ec251
  • [actions] update rebase action cd7cc76
  • [Dev Deps] update @ljharb/eslint-config, aud, tape 79e56a5
  • [Fix] better error message when gitignore is not found 3cad507
  • [Dev Deps] update aud, tape cba23fc
  • [Deps] update minimist 56cac61
  • [Deps] update minimist a96fc20

v0.3.0 - 2022-05-04

Merged

  • Some improvements #11
  • fix format() jsDoc #5

Commits

  • [Refactor] spaces -> tabs d40c8b8
  • [Tests] add npm run lint cd5f42b
  • [New] add --auto mode, and dogfood it 624ef0a
  • Only apps should have lockfiles 706ac5c
  • [Refactor] remove verbalize and verb f98f4b4
  • [Tests] add github actions, FUNDING.yml 0e83333
  • [Tests] add aud, auto-changelog, safe-publish-latest 4e1e5d0
  • [Refactor] clean up the code a bit 037a72d
  • [New] add --commentLines CLI and commentLines API option 95a58a1
  • [Tests] initial tests 5ea6473
  • [meta] package.json field cleanup 9e8d32d
  • [meta] update repo URLs dc672e7
  • [meta] remove unused files e48ea97
  • [Refactor] replace array-uniq with a simple inline impl 3a3b88b
  • [Refactor] arrayify is never needed, since [].concat exists 7c56059
  • [New] add --keepdest command-line option to keep existing .npmignore 2fc3a3c
  • [Breaking] add exports 6636852
  • [Fix] ensure .npmignore always has a trailing newline f20380d
  • [Refactor] move cli script to bin dir e12c1e0
  • [Dev Deps] removed mocha, added verb a027807
  • [meta] avoid the dangerous "files" field 308b063
  • Allow absolute paths 3df0205
  • Add missing --gitignore --npmignore argument keys ba530e5
  • Allow multiple comma separated .gitignore/.npmignore files 6c9d7b3
  • [Deps] update minimist 078c5b3
  • [Refactor] extract: use a TypeError for a wrong type 38a9741
  • Adds name of the file from which the rules were copied 19e1ec6

v0.2.0 - 2015-03-17

Merged

  • issue a warning in the .npmignore file #3

Commits

v0.1.2 - 2014-10-26

Commits

v0.1.1 - 2014-10-26

Commits

  • adds CLI instructions. fixes bug related to missing npmignore e305cdf
  • fix examples a0e51ee

v0.1.0 - 2014-10-26

Commits