> ## Documentation Index
> Fetch the complete documentation index at: https://vibewax.be/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Sichere dein Vibewax-Projekt und synchronisiere es mit GitHub

Vibewax' GitHub-Integration verbindet dein Projekt mit einem privaten GitHub-Repository. Sichere deinen Code, synchronisiere Änderungen in beide Richtungen und nimm dein Projekt in einem neuen Chat wieder auf, wann immer du willst.

## Warum GitHub verbinden

- **Sichere dein Projekt in einem privaten Repository.** Dein Code liegt in einem GitHub-Repository, das dir gehört.
- **Sende Updates an GitHub.** Schicke deine neueste Vibewax-Version als Pull Request ans Repository, den du dann mergst.
- **Hol Änderungen zurück in dein Projekt.** Stelle dein Projekt aus der auf GitHub gespeicherten Version wieder her.
- **Importiere ein Projekt von GitHub.** Starte ein neues Vibewax-Projekt aus einem Repository, das du zuvor gepusht hast.

## GitHub mit deinem Projekt verbinden

<Steps>
  <Step title="Projekteinstellungen öffnen">
    Klicke in deinem Projekt oben in der Leiste auf **Einstellungen** und öffne dann den Tab **Allgemein**.
  </Step>
  <Step title="Repository erstellen">
    Scrolle zu **GitHub-Verbindung** und klicke auf **Auf GitHub erstellen**. Beim ersten Mal autorisierst du Vibewax auf GitHub und wählst, welches GitHub-Konto oder welche Organisation du verbinden möchtest. Wähle eines, in dem die App bereits installiert ist, oder wähle **Install on another GitHub account**. Vibewax erstellt dann ein privates Repository und synchronisiert dein Projekt hinein.

    <img src="https://vibewax.be/docs/images/integrations_github_create.png" alt="Einstellungen Allgemein GitHub-Verbindung Schaltfläche Auf GitHub erstellen" width="1500" height="1000" />
  </Step>
  <Step title="Dein Repository ist verknüpft">
    Der Abschnitt zeigt jetzt den Namen deines Repositorys mit einem Link, um es auf GitHub zu öffnen. Von hier aus kannst du Änderungen pushen und pullen.
  </Step>
</Steps>

## Änderungen pushen und pullen

Sobald dein Repository verknüpft ist, zeigt der Abschnitt **GitHub-Verbindung** zwei Schaltflächen:

- **Änderungen pushen** sendet deine neueste Vibewax-Version an GitHub. Vibewax öffnet einen Pull Request mit dem Titel "Updates from Vibewax", den du auf GitHub prüfst und mergst.
- **Änderungen pullen** ersetzt die Dateien deines Projekts durch die Version von GitHub. Vibewax bittet dich zuerst um Bestätigung. Deine Dateien `.env` und `.env.local` bleiben immer erhalten.

Um das Repository zu trennen, klicke auf die Schaltfläche `X` neben seinem Namen.

## Ein Projekt von GitHub importieren

Du kannst ein neues Vibewax-Projekt aus einem Repository starten, das du zuvor von Vibewax aus gepusht hast.

<Steps>
  <Step title="Import-Aktion aktivieren">
    Öffne **Präferenzen** in deinen Kontoeinstellungen, scrolle zu **Erweitert** und aktiviere **Von GitHub importieren**. Dadurch erscheint die Aktion auf dem Startbildschirm.

    <img src="https://vibewax.be/docs/images/integrations_github_import.png" alt="Präferenzen Erweitert Schalter Von GitHub importieren" width="1500" height="1000" />
  </Step>
  <Step title="Von GitHub importieren öffnen">
    Öffne auf dem Startbildschirm das **+**-Menü in der Prompt-Leiste und wähle **Von GitHub importieren**.
  </Step>
  <Step title="Ein Repository auswählen">
    Suche das Repository und wähle es aus. Vibewax erstellt daraus ein neues Projekt. Nutze **Konfigurieren**, um dich erneut mit GitHub zu verbinden oder das Konto zu wechseln, und **Aktualisieren**, um die Liste neu zu laden. Du siehst nur Repositories, auf die dein GitHub-Konto Zugriff hat.
  </Step>
</Steps>

<Note>
  Der Import funktioniert mit Repositories, die Vibewax erstellt hat. Der Import eines externen Repositorys, das nicht von Vibewax stammt, wird nicht unterstützt.
</Note>

## Was synchronisiert wird

Deine Projektdateien, Komponenten, Seiten, Styles, Assets und die Vibewax-Konfiguration sind enthalten. Umgebungsvariablen (`.env`-Dateien) und Cache-Dateien werden nie gepusht, und beim Pullen werden deine `.env` und `.env.local` nie überschrieben.

## Gut zu wissen

- **Repositories sind immer privat.** Dein Code wird von Vibewax nie öffentlich gemacht.
- **Ein kostenloses GitHub-Konto reicht.** Du brauchst keinen kostenpflichtigen GitHub-Plan.
- **Pushen öffnet einen Pull Request**, den du auf GitHub mergst. Es ändert nicht deine Live-Website.
- **Pullen ersetzt deine Projektdateien**, behält aber deine `.env` und `.env.local`.


This page is part of the [Vibewax documentation](https://vibewax.be/docs/de/welcome/overview).