Skip to content

Commit 791e330

Browse files
add Troubleshooting to Setup guide with callout for Rollup optional dependencies
1 parent 5502028 commit 791e330

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

src/pages/docs/introduction/setup.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,3 +89,32 @@ The CLI supports three commands, that can be easily mapped to npm scripts in you
8989
</app-ctc-block>
9090

9191
<!-- prettier-ignore-end -->
92+
93+
## Troubleshooting
94+
95+
### Rollup Linux x64 GNU
96+
97+
<!-- if / when Greenwood bumps up Node 24, we can remove this message -->
98+
99+
If using npm, depending on the version, if you see an error like this in GitHub Actions or any hosting provider:
100+
101+
```shell
102+
Error: Cannot find module @rollup/rollup-linux-x64-gnu. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). Please try `npm i` again after removing both package-lock.json and node_modules directory.
103+
```
104+
105+
Add [**@rollup/rollup-linux-x64-gnu**](https://www.npmjs.com/package/@rollup/rollup-linux-x64-gnu) as an [optional dependency to your _package.json_](https://stackoverflow.com/questions/79048814/github-action-is-failing-due-to-rollup-rollup-linux-x64-gnu):
106+
107+
<!-- prettier-ignore-start -->
108+
<app-ctc-block variant="snippet" heading="package.json">
109+
110+
```json
111+
{
112+
"optionalDependencies": {
113+
"@rollup/rollup-linux-x64-gnu": "^4.50.0"
114+
}
115+
}
116+
```
117+
118+
</app-ctc-block>
119+
120+
<!-- prettier-ignore-end -->

0 commit comments

Comments
 (0)