Does NPM ignore files listed in .gitignore?

node.jsGitNpm

node.js Problem Overview


I have a file that is generated by npm install command (using preinstall task). I don't want to add it in the git repository, nor in the NPM project.

Supposing the file name is foo.json, I added it in .gitignore file as foo.json.

Is this enough to avoid uploading it on NPM registry?

I know I can add .npmignore file that will surely ignore the file, but I won't add it if .gitignore already does this.

node.js Solutions


Solution 1 - node.js

If a project has both an .npmignore and .gitignore file, npm will only use the .npmignore file.

From the documentation:

> Use a .npmignore file to keep stuff out of your package. If there's no .npmignore file, but there is a .gitignore file, then npm will ignore the stuff matched by the .gitignore file. If you want to include something that is excluded by your .gitignore file, you can create an empty .npmignore file to override it.

In simpler terms, npm prefers the .npmignore file if it is there, but will fall back to the .gitignore file.

In many cases, both Git and npm can ignore the same files, so it makes sense to just use a .gitignore file on its own. If there's ever a discrepancy (i.e. npm and Git need to ignore different files), then you need to maintain separate .gitignore and .npmignore files.

More information on what to put in .npmignore files: https://stackoverflow.com/questions/25124844/should-i-npmignore-my-tests

Solution 2 - node.js

For anyone reading this trying to ignore a file/dir from git but wish to include it in npm publish and have tried using an empty .npmignore file with no luck. This works.

In your .gitignore file, add the file/dir you wish to exclude **/build for example and in your .npmignore file make sure you specify the same file/dir but with the ! prefix so for the build example you would include !**/build

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionIonică BizăuView Question on Stackoverflow
Solution 1 - node.jscmbuckleyView Answer on Stackoverflow
Solution 2 - node.jsStewart DuffyView Answer on Stackoverflow