Skip to content

Commit

Permalink
docs(angular): document PNPM workaround for ngcc
Browse files Browse the repository at this point in the history
  • Loading branch information
daniel-shuy committed Jul 14, 2023
1 parent 6ce7fc5 commit 70c2517
Showing 1 changed file with 18 additions and 2 deletions.
20 changes: 18 additions & 2 deletions docs/shared/guides/setup-incremental-builds-angular.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,24 @@ installation. You can check your `package.json` and make sure you have the follo
}
```

{% callout type="warning" title="ngcc limitations" %}
Please note that `ngcc` doesn’t support `pnpm` ([#32087](https://github.com/angular/angular/issues/32087#issuecomment-523225437) and [#38023](https://github.com/angular/angular/issues/38023#issuecomment-732423078)), so you need to use either `yarn` or `npm`.
{% callout type="warning" title="PNPM support" %}
To use `ngcc` with `pnpm`, set [`node-linker=hoisted` in `.npmrc`](https://pnpm.io/npmrc#node-linker) (angular/angular#50735) and explicitly declare `node-gyp-build` in `package.json` (#16319 and parcel-bundler/watcher#142), e.g.

```ini {% fileName=".npmrc" %}
node-linker=hoisted
```

```jsonc {% fileName="package.json" %}
{
...
"devDependencies": {
...
"node-gyp-build": "4.6.0",
...
}
...
}
```
{% /callout %}

## Use buildable libraries
Expand Down

0 comments on commit 70c2517

Please sign in to comment.