Probleme beheben

Nach der Installation solltest du das Terminal einmal schließen und wieder öffnen, damit die Änderungen durch die Installation wirksam sind.

Teste über das Terminal, ob Git, npm und Yarn erfolgreich installiert wurden. Das kann man über dessen Ausgabe der Versionsnummer herausfinden.

$ git -v
git version 2.39.3 (Apple Git-145)

$ npm -v
10.2.3

$ yarn -v
1.22.21

Probleme unter macOS beheben

Auf manchen Rechnern kommt es bei Node unter Umständen zu Problemen bei der Rechtevergabe. Dies kannst du mit dem folgenden Befehl beheben:

$ sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

Fehler bei der Installation

Sollten bei yarn install oder yarn dev Fehlermeldungen auftreten, in denen von node-gyp die Rede ist, handelt es sich vermutlich um Inkompatibilitäten mit der vorinstallierten Software deines Rechners.

Führe bitte ein Downgrade von Node auf die letzte LTS-Version durch. Die aktuelle Version findest du über auf der Node-Website unter dem Button „Recommended For Most Users“. Zum Stand der Dokumentation ist das „20.10.0 LTS“.

$ brew install node@20
$ brew link --force node@20

Danach solltest du wieder ein yarn install durchführen können.

Bekommst du weiterhin die o.g. Fehlermeldung, installiere dir die CommandLineTools von macOS neu:

$ sudo rm -rf  /Library/Developer/CommandLineTools
$ xcode-select --install

Installiere dir zur Sicherheit Node noch einmal neu in der letzten LTS-Version (siehe oben).

Probleme beim kopieren von Projekten

Wenn du dir das Starterkit von einer vorherigen Installation kopierst, solltest du die Abhängigkeiten eines Starterkits neu installieren. Das funktioniert so:

rm -rf ./node_modules .yarn.lock && yarn install