Folge 018: Node 22, npm install und npm run dev lokal

Das Repo enthält Quellcode und package.json, aber nicht den ganzen node_modules-Berg. In deiner lokalen IDE (Entwicklungsumgebung) brauchst du Node.js (für hautuu empfohlen: Version 22) und npm, damit npm run dev und npm run build laufen.

Das Video zu dieser Folge

Du hast noch keinen ZugangsCode? Dann melde dich bei mir!

Node installieren

Auf nodejs.org liegt ein Linux-Install-Skript (oft per curl | bash). Fehlt curl, zuerst:

sudo apt update
sudo apt install curl

Kaputte Paketlisten auf einem frisch eingerichteten Rechner fixst du ggf. mit sudo apt-get update und den Hinweisen aus apt (broken packages, fix-missing). Danach das Node-Skript erneut ausführen. Das Setup legt oft nvm mit, sodass mehrere Node-Versionen parallel möglich sind.

Prüfen:

node -v

Ziel: etwas wie v22.x.x.

Erstes Aufsetzen im Projektordner

Nach dem Clone einmal Abhängigkeiten holen und den Dev-Server starten:

npm install
npm run dev

npm install liest package.json (und im Repo auch package-lock.json) und legt die Pakete in node_modules ab, wie in der npm-Doku zu install beschrieben. Darin stecken Astro, Sveltia-Build-Tools und weitere Bibliotheken. npm ist eine CLI.

npm run dev startet den Entwicklungsmodus (Skript dev in package.json, Tabelle der npm-Skripte in der Repo-Doku Lokale Entwicklung weiter oben). Du bekommst eine lokale URL (oft http://localhost:4321). Link im Terminal anklicken oder URL kopieren; CMS-Vorschau dann unter /admin/.

Alltag: meist reicht npm run dev

Wenn node_modules schon da ist und sich an den Abhängigkeiten nichts geändert hat, startest du die Vorschau ohne vorheriges npm install:

npm run dev

Das gilt auch, wenn du den Dev-Server gestern beendet hast und heute weiterarbeitest: einfach wieder npm run dev im Projektordner. Texte, Artikel, Bilder oder CSS im Repo ändern daran nichts. node_modules liegt lokal auf deinem Rechner und wird nicht mit Commit und Push mit hochgeladen (Folge 002).

So testest du Änderungen ohne jedes Mal auf main zu pushen. Für öffentliche Previews nutzt du weiter Branches und Cloudflare-URLs mit „Preview“ (Vorschau) (Folge 012).

Wann npm install nötig ist

• Erstes Mal nach dem Klonen
  Ohne node_modules kann npm run dev die Pakete nicht finden. Einmal npm install im Projektroot, danach Dev-Server.
• package.json oder package-lock.json haben sich geändert
  Nach Pull oder Merge, wenn jemand (oder ein Agent in Cursor) neue Abhängigkeiten eingetragen hat. npm synchronisiert dann node_modules mit der Datei im Repo.
• node_modules fehlt oder wurde gelöscht
  Der Ordner ist groß und steht in .gitignore. Wenn er weg ist, Abhängigkeiten neu installieren.
• Andere Node-Version aktiv
  Nach Wechsel mit nvm oder neu installiertem Node: installieren erneut ausführen, damit native Module zur laufenden Version passen (in der Praxis der sichere Standard).
• npm run dev bricht mit „Cannot find module“ o. Ä. ab
  Oft fehlt ein Paket oder der Stand von node_modules passt nicht mehr. npm install erneut; wenn es dann noch scheitert, Fehlermeldung und Lockfile-Änderungen prüfen.

Wann npm install nicht nötig ist

• Normale Inhaltsarbeit
  Markdown unter src/content/, Seiten, Glossar, Bilder: speichern, Browser aktualisieren oder Hot Reload vom Dev-Server reicht.
• Dev-Server neu starten
  Terminal mit Ctrl+C beendet, später wieder npm run dev: kein Install-Schritt dazwischen, solange die Fälle oben nicht zutreffen.
• Nur Git holen ohne Dependency-Änderung
  Pull mit reinen Text- oder Layout-Commits: weiter mit npm run dev arbeiten.

Was npm hier nicht ist

Du hostest die fertige Site nicht mit npm run dev. Production läuft über Cloudflare Pages nach Push (Folge 011). Lokal ist npm nur Werkzeugkiste: installieren, entwickeln, npm run build vor dem Commit wenn du den Produktionsbuild prüfen willst.