> For the complete documentation index, see [llms.txt](https://xmlking.gitbook.io/macos-setup/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xmlking.gitbook.io/macos-setup/platforms/node/npm.md).

# NPM

### Usage

```shell
# example installing packages globally. use `-g` flag
npm install -g npm-check-updates
npm install -g dynamodump --force 
# Write shell scripts with Google's [zx](https://github.com/google/zx)
npm install -g zx
```

#### Workspace

```shell
# Run "test" script on all packages
npm run test --workspaces

# Tip - this also works:
npm run test  -ws
```

```shell
# Runs "test" only on package-a
npm run test --workspace package-a

# Tip - this also works:
npm run test -w package-a
```

```shell
# Install `lodash` on `package-a`
npm install lodash --workspace package-a
npm install @nestjs/microservices --workspace apps/api

# Install `tap` on `package-b` as a dev dependency
npm install tap --workspace package-b --save-dev

# Install `package-a` on `package-b`
npm install package-a --workspace package-b

# Install `eslint` in all packages
npm install eslint --workspaces
```

## Update

```shell
# To install major updates globally
npm install -g npm-check-updates

# To see a list of outdated packages
npm outdated

# To update the packages to their latest versions in package.json
ncu -u

# To install the new updates
npm update  or  npm install
```

## References

* [Getting Started with npm Workspaces](https://ruanmartinelli.com/posts/npm-7-workspaces-1)