> 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/pnpm.md).

# PNPM

## Install

> \[!NOTE]\
> Since v16.13, Node.js is shipping Corepack for managing package managers.

```shell
brew install node
# This will automatically install pnpm on your system.
corepack enable pnpm
# (in your node project root) You can pin the version of pnpm used on your project using the following command:
corepack use pnpm@latest-10
```

To upgrade in the future:

```shell
corepack up
```

## Project Setup

> \[!NOTE]\
> You can pin the version of pnpm used on your project using the following command

```shell
# for example to pin pnpm version for spectacular
cd ~/Developer/Work/web/spectacular
corepack use pnpm@latest-10 
```

## Commands

```shell
# add package to monorepo's root
pnpm add debug -W
# add package to global
pnpm add debug --global

# update package versions in a repo
pnpm up
pnpm up --latest
pnpm up --latest --global

pnpm ls prune
pnpm ls
pnpm ls --global

pnpm audit
# find why a specific package installed 
pnpm why vite
# for monorepo use -r to search all sub projects
pnpm why vite -r

# Publish all packages in topological order from the workspace.
pnpm publish -r
```

### Patching a node module

In your project repo directory, run:

```shell
pnpm patch @auth/core@0.2.4
```

Output:

> You can now edit the following folder: /private/var/folders/t\_/2rzsqx111439\_19vxd5f\_p800000gp/T/f6f8c74999a108b642b97ab160392cd8\
> Once you're done with your changes, run "pnpm patch-commit /private/var/folders/t\_/2rzsqx111439\_19vxd5f\_p800000gp/T/f6f8c74999a108b642b97ab160392cd8"'

Edit the files you need to patch then run: `pnpm patch-commit "path-to-edited-module"` as stated above.

### create SvelteKit workspace

```shell
pnpm create svelte@latest svelte-starter-kit
# select `yes` for TypeScript, ESLint, Prettier, Playwright and Vitest
```

## Reference

* <https://medium.com/pixel-and-ink/switching-an-nx-repo-to-pnpm-5b1cbd5c3797>