Skip to content

Commit 58c5900

Browse files
authored
docs(troubleshooting): shamefully hoisting
1 parent 5bcec7a commit 58c5900

File tree

2 files changed

+24
-2
lines changed

2 files changed

+24
-2
lines changed

docs/content/en/1.getting-started/7.troubleshooting.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ seo:
99

1010
## `pnpm` issues
1111

12+
### Approve build scripts
13+
1214
If you encounter build or dev errors when using `pnpm`, especially related to `better-sqlite3` dependency, you might need to approve certain packages for building.
1315

1416
Run the following command to approve packages for building:
@@ -18,3 +20,13 @@ pnpm approve-builds
1820
```
1921

2022
When prompted, select `better-sqlite3` and `sharp` from the list of packages to approve it for building.
23+
24+
### Enable shameful hoisting (compatibility mode)
25+
26+
If you see errors such as `Can't resolve 'tailwindcss'` or `Can't resolve '@nuxt/ui-pro'` you don't necessary need to import them, you can just apply a flat `node_modules` layout (like npm or yarn).
27+
28+
You can enable compatibility mode by creating a `.npmrc` file with:
29+
30+
```text [.npmrc]
31+
shamefully-hoist=true
32+
```

docs/content/fr/1.getting-started/7.troubleshooting.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,22 @@ seo:
99

1010
## Problèmes avec `pnpm`
1111

12-
Si vous rencontrez des erreurs de build ou de dev lors de l'utilisation de `pnpm`, en particulier liées à la dépendance `better-sqlite3`, vous devrez peut-être approuver certains packages pour la compilation.
12+
Si vous rencontrez des erreurs lors du build ou du développement avec `pnpm`, en particulier liées à la dépendance `better-sqlite3`, il se peut que vous deviez approuver certains paquets pour qu’ils puissent être compilés.
1313

14-
Exécutez la commande suivante pour approuver les packages pour la compilation :
14+
Exécutez la commande suivante pour approuver les paquets à compiler :
1515

1616
```bash [Terminal]
1717
pnpm approve-builds
1818
```
1919

2020
Lorsque vous y êtes invité, sélectionnez `better-sqlite3` et `sharp` dans la liste des packages pour l'approuver pour la compilation.
21+
22+
### Activer le *shameful hoisting* (mode compatibilité)
23+
24+
Si vous voyez des erreurs du type `Can't resolve 'tailwindcss'` ou `Can't resolve '@nuxt/ui-pro'`, vous n’avez pas forcément besoin de les importer. Vous pouvez simplement appliquer une structure flat des `node_modules` (comme avec npm ou yarn).
25+
26+
Vous pouvez activer le mode compatibilité en créant un fichier `.npmrc` contenant :
27+
28+
```js
29+
shamefully-hoist=true
30+
```

0 commit comments

Comments
 (0)