# npm-submodule

Add a package as a git submodule

## SYNOPSIS

    npm.commands.submodule(packages, callback)

## DESCRIPTION

For each package specified, npm will check if it has a git repository url in its package.json description then add it as a git submodule at `node_modules/<pkg name>`.

This is a convenience only. From then on, it's up to you to manage updates by using the appropriate git commands. npm will stubbornly refuse to update, modify, or remove anything with a `.git` subfolder in it.

This command also does not install missing dependencies, if the package does not include them in its git repository. If `npm ls` reports that things are missing, you can either install, link, or submodule them yourself, or you can do `npm explore <pkgname> -- npm install` to install the dependencies into the submodule folder.

## SEE ALSO

- npm help json
- git help submodule