Preflight-Checks

Der vierte und letzte Wizard-Schritt überprüft Ihre Systemumgebung auf Einsatzbereitschaft. Erst wenn alle kritischen Prüfungen bestanden sind, wird der Wizard abgeschlossen.

Durchgeführte Prüfungen

xyva validiert folgende Bereiche automatisch:

Prüfung	Bedingung	Schweregrad
Node.js	Version 18.0 oder höher installiert	Kritisch
Git	Version 2.30 oder höher im PATH	Kritisch
npm	Version 8.0 oder höher verfügbar	Kritisch
Dateisystem	Schreibrechte im Projektverzeichnis	Kritisch
Playwright	@playwright/test in node_modules vorhanden	Warnung
Browser-Binaries	Mindestens ein Browser installiert	Warnung

Status-Anzeige

Jede Prüfung wird mit einem Ampelsystem dargestellt:

• Grün -- Prüfung bestanden, alles in Ordnung
• Gelb -- Warnung, funktioniert eingeschränkt (z. B. fehlende Browser-Binaries)
• Rot -- Kritischer Fehler, muss vor dem Fortfahren behoben werden

INFO

Gelbe Warnungen blockieren den Wizard nicht. Sie können fortfahren und die fehlenden Komponenten später nachinstallieren.

Häufige Probleme beheben

Node.js nicht gefunden

# Installierte Version prüfen
node --version

# Falls nicht installiert: von https://nodejs.org herunterladen
# Oder via Paketmanager:
brew install node             # macOS
winget install OpenJS.NodeJS  # Windows

Git nicht im PATH

# Prüfen ob Git verfügbar ist
git --version

# Installation:
# Windows: https://git-scm.com/download/win
# macOS: xcode-select --install
# Linux: sudo apt install git

Fehlende Playwright-Browser

# Alle Browser installieren
npx playwright install

# Oder nur einen bestimmten Browser
npx playwright install chromium

TIP

Falls xyva fehlende Browser erkennt, bietet es eine automatische Installation direkt im Preflight-Bildschirm an. Ein Klick genügt.

Preflight erneut ausführen

Sie können die Prüfungen jederzeit wiederholen:

1. Öffnen Sie Einstellungen > Allgemein
2. Klicken Sie auf Wizard erneut starten
3. Navigieren Sie zum Preflight-Schritt

Alternativ zeigt das Übersicht-Dashboard den aktuellen System-Status dauerhaft an.

WARNING

Änderungen an Ihrer Node.js- oder Git-Installation erfordern möglicherweise einen Neustart von xyva, damit die neuen Pfade erkannt werden.

Nächste Schritte

• Einstellungen -- xyva nach Ihren Wünschen konfigurieren
• Schnellstart -- Ersten Test ausführen