|
|
.TH "NPM\-PUBLISH" "1" "August 2018" "" ""
|
|
|
.SH "NAME"
|
|
|
\fBnpm-publish\fR \- Publish a package
|
|
|
.SH SYNOPSIS
|
|
|
.P
|
|
|
.RS 2
|
|
|
.nf
|
|
|
npm publish [<tarball>|<folder>] [\-\-tag <tag>] [\-\-access <public|restricted>] [\-\-otp otpcode] [\-\-dry\-run]
|
|
|
|
|
|
Publishes '\.' if no argument supplied
|
|
|
Sets tag 'latest' if no \-\-tag specified
|
|
|
.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 exists\. If both files exist and a file is ignored by
|
|
|
\fB\|\.gitignore\fP but not by \fB\|\.npmignore\fP then it will be included\. 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\.
|
|
|
.IP \(bu 2
|
|
|
\fB[\-\-otp <otpcode>]\fP
|
|
|
If you have two\-factor authentication enabled in \fBauth\-and\-writes\fP mode
|
|
|
then you can provide a code from your authenticator with this\. If you
|
|
|
don't include this and you're running from a TTY then you'll be prompted\.
|
|
|
.IP \(bu 2
|
|
|
\fB[\-\-dry\-run]\fP
|
|
|
Does everything publish would do except actually publishing to the registry\.
|
|
|
Reports the details of what would have been published\.
|
|
|
|
|
|
.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\.
|
|
|
.P
|
|
|
As of \fBnpm@5\fP, both a sha1sum and an integrity field with a sha512sum of the
|
|
|
tarball will be submitted to the registry during publication\. Subsequent
|
|
|
installs will use the strongest supported algorithm to verify downloads\.
|
|
|
.P
|
|
|
Similar to \fB\-\-dry\-run\fP see npm help \fBnpm\-pack\fP, which figures out the files to be
|
|
|
included and packs them into a tarball to be uploaded to the registry\.
|
|
|
.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 dist\-tag
|
|
|
.IP \(bu 2
|
|
|
npm help pack
|
|
|
.IP \(bu 2
|
|
|
npm help profile
|
|
|
|
|
|
.RE
|
|
|
|