Entwicklung

Lokale Entwicklung

Eine reproduzierbare Arbeitsumgebung einrichten und Produktionsdaten vermeiden.

Installation

git clone https://github.com/lucas-lepajollec/nasdash.git
cd nasdash
npm ci
cp .env.example .env
npm run dev

Standardmäßig lauscht der Entwicklungsserver nur auf http://127.0.0.1:2499. Um ihn von einem anderen Gerät im vertrauenswürdigen lokalen Netzwerk zu testen:

npm run dev:lan

Verwenden Sie anschließend die von Next.js angezeigte Netzwerkadresse. Das Produkt basiert auf Next.js 16, React 19 und TypeScript; der offizielle Container basiert auf Node.js 22.

Datenisolierung

Standardmäßig verwendet der lokale Server data/. Für experimentelle Arbeiten setzen Sie NASDASH_DATA_DIR auf einen dedizierten, wegwerfbaren Ordner. Relative Pfade werden relativ zum Projektverzeichnis aufgelöst.

Verwenden Sie niemals einen Produktionsordner für Interface-Tests oder E2E-Skripte. Die offizielle Browser-Testsuite verwendet .e2e/data, Port 2510 und isolierte Zugangsdaten.

Entwicklungsintegrationen

Für Docker führen Sie einen dedizierten und eingeschränkten Socket-Proxy aus. Mounten Sie den Docker-Socket nicht direkt in den NasDash-Prozess. Für andere Integrationen verwenden Sie nur-lesende Konten und Test-Hosts.