| .TH "NPM\-PUBLISH" "1" "June 2016" "" "" |
| .SH "NAME" |
| \fBnpm-publish\fR \- Publish a package |
| .SH SYNOPSIS |
| .P |
| .RS 2 |
| .nf |
| npm publish <tarball> [\-\-tag <tag>] [\-\-access <public|restricted>] |
| npm publish <folder> [\-\-tag <tag>] [\-\-access <public|restricted>] |
| .fi |
| .RE |
| .SH DESCRIPTION |
| .P |
| Publishes a package to the registry so that it can be installed by name\. All |
| files in the package directory are included if no local \fB\|\.gitignore\fP or |
| \fB\|\.npmignore\fP file is present\. See npm help 7 \fBnpm\-developers\fP for full details on |
| what's included in the published package, as well as details on how the package |
| is built\. |
| .P |
| By default npm will publish to the public registry\. This can be overridden by |
| specifying a different default registry or using a npm help 7 \fBnpm\-scope\fP in the name |
| (see npm help 5 \fBpackage\.json\fP)\. |
| .RS 0 |
| .IP \(bu 2 |
| \fB<folder>\fP: |
| A folder containing a package\.json file |
| .IP \(bu 2 |
| \fB<tarball>\fP: |
| A url or file path to a gzipped tar archive containing a single folder |
| with a package\.json file inside\. |
| .IP \(bu 2 |
| \fB[\-\-tag <tag>]\fP |
| Registers the published package with the given tag, such that \fBnpm install |
| <name>@<tag>\fP will install this version\. By default, \fBnpm publish\fP updates |
| and \fBnpm install\fP installs the \fBlatest\fP tag\. See npm help \fBnpm\-dist\-tag\fP for |
| details about tags\. |
| .IP \(bu 2 |
| \fB[\-\-access <public|restricted>]\fP |
| Tells the registry whether this package should be published as public or |
| restricted\. Only applies to scoped packages, which default to \fBrestricted\fP\|\. |
| If you don't have a paid account, you must publish with \fB\-\-access public\fP |
| to publish scoped packages\. |
| |
| .RE |
| .P |
| Fails if the package name and version combination already exists in |
| the specified registry\. |
| .P |
| Once a package is published with a given name and version, that |
| specific name and version combination can never be used again, even if |
| it is removed with npm help unpublish\. |
| .SH SEE ALSO |
| .RS 0 |
| .IP \(bu 2 |
| npm help 7 registry |
| .IP \(bu 2 |
| npm help 7 scope |
| .IP \(bu 2 |
| npm help adduser |
| .IP \(bu 2 |
| npm help owner |
| .IP \(bu 2 |
| npm help deprecate |
| .IP \(bu 2 |
| npm help tag |
| |
| .RE |
| |