package-specPackage name specifier
npm install and the dependency sections in the
package.json use a package name specifier. This can be many different
things that all refer to a "package". Examples include a package name,
git url, tarball, or local directory. These will generally be referred
<package-spec> in the help output for the npm commands that use
this package name specifier.
Refers to a package by name, with or without a scope, and optionally tag, version, or version range. This is typically used in combination with the registry config to refer to a package in a registry.
Primarily used by commands like
npm install and in the dependency
sections in the
package.json, this refers to a package by an alias.
<alias> is the name of the package as it is reified in the
node_modules folder, and the
<name> refers to a package name as
found in the configured registry.
Package name above for more info on referring to a package by
name, and registry for configuring which
registry is used when referring to a package by name.
This refers to a package on the local filesystem. Specifically this is
a folder with a
package.json file in it. This should always be
prefixed with a
./ (or your OS equivalent) to reduce confusion.
npm currently will parse a string with more than one
/ in it as a
folder, but this is legacy behavior that may be removed in a future
Refers to a package in a tarball format, either on the local filesystem or remotely via url. This is the format that packages exist in when uploaded to a registry.
<github username>/<github project>
Refers to a package in a git repo. This can be a full git url, git
shorthand, or a username/package on GitHub. You can specify a
git tag, branch, or other git ref by appending