NAME

       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

                                           October 2013                          NPM-SUBMODULE(3)