npm-uninstall

Remove a package

Synopsis

npm uninstall [<@scope>/]<pkg>[@<version>]... [-S|--save|-D|--save-dev|-O|--save-optional|--no-save]

aliases: remove, rm, r, un, unlink

Description

This uninstalls a package, completely removing everything npm installed on its behalf.

Example:

npm uninstall sax

In global mode (ie, with -g or --global appended to the command), it uninstalls the current package context as a global package.

npm uninstall takes 3 exclusive, optional flags which save or update the package version in your main package.json:

-S, --save: Package will be removed from your dependencies.
-D, --save-dev: Package will be removed from your devDependencies.
-O, --save-optional: Package will be removed from your optionalDependencies.
--no-save: Package will not be removed from your package.json file.

Further, if you have an npm-shrinkwrap.json then it will be updated as well.

Scope is optional and follows the usual rules for npm-scope.

Examples:

npm uninstall sax --save
npm uninstall @myorg/privatepackage --save
npm uninstall node-tap --save-dev
npm uninstall dtrace-provider --save-optional
npm uninstall lodash --no-save

npm Services

npm Orgs - the npm Orgs documentation site
npm Enterprise - the npm Enterprise documentation site

Getting started

Private packages

Troubleshooting

Using npm

coding-style npm's "funny" coding style
config More than you probably want to know about npm configuration
developers Developer Guide
disputes Handling Module Name Disputes
orgs Working with Teams & Orgs
registry The JavaScript Package Registry
removing-npm Cleaning the Slate
scope Scoped packages
scripts How npm handles the "scripts" field
semver The semantic versioner for npm

CLI commands

access Set access level on published packages
adduser Add a registry user account
audit Run a security audit
bin Display npm bin folder
bugs Bugs for a package in a web browser maybe
build Build a package
bundle REMOVED
cache Manipulates packages cache
ci Install a project with a clean slate
completion Tab Completion for npm
config Manage the npm configuration files
dedupe Reduce duplication
deprecate Deprecate a version of a package
dist-tag Modify package distribution tags
docs Docs for a package in a web browser maybe
doctor Check your environments
edit Edit an installed package
explore Browse an installed package
help Get help on npm
help-search Search npm help documentation
hook Manage registry hooks
init create a package.json file
install Install a package
install-ci-test
install-test
link Symlink a package folder
logout Log out of the registry
ls List installed packages
npm javascript package manager
outdated Check for outdated packages
owner Manage package owners
pack Create a tarball from a package
ping Ping npm registry
prefix Display prefix
profile Change settings on your registry profile
prune Remove extraneous packages
publish Publish a package
rebuild Rebuild a package
repo Open package repository page in the browser
restart Restart a package
root Display npm root
run-script Run arbitrary package scripts
search Search for packages
shrinkwrap Lock down dependency versions for publication
star Mark your favorite packages
stars View packages marked as favorites
start Start a package
stop Stop a package
team Manage organization teams and team memberships
test Test a package
token Manage your authentication tokens
uninstall Remove a package
unpublish Remove a package from the registry
update Update a package
version Bump a package version
view View registry info
whoami Display npm username

Configuring npm

folders Folder Structures Used by npm
npmrc The npm config files
package-lock.json A manifestation of the manifest
package-locks An explanation of npm lockfiles
package.json Specifics of npm's package.json handling
shrinkwrap.json A publishable lockfile