Artikel · 04.10.2026

• #Node.js
• #Astro
• #Cursor

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

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 einer frischen VM 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.

Abhängigkeiten und Dev-Server

Im Projektordner:

npm install
npm run dev

npm install lädt alle in package.json genannten Pakete (Astro, Sveltia-Build-Tools, …). npm run dev baut die Site im Entwicklungsmodus und zeigt eine lokale URL (oft localhost:4321). Link im Terminal anklicken oder URL kopieren.

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

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.