12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788 |
- .TH "NPM\-PUBLISH" "1" "August 2021" "" ""
- .SH "NAME"
- \fBnpm-publish\fR \- Publish a package
- .SS 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
- .SS 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 \fBdevelopers\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 \fBscope\fP in the name (see npm help \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 \fBnpm\-dist\-tag\fP \fInpm\-dist\-tag\fR 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
- As of \fBnpm@6\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 \fBunpublish\fP\|\.
- .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 \fBpack\fP, which figures out the files to be
- included and packs them into a tarball to be uploaded to the registry\.
- .SS See Also
- .RS 0
- .IP \(bu 2
- npm help registry
- .IP \(bu 2
- npm help 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
|