Integrationen
GitHub
Sende den Code deiner App an ein privates Repository auf deinem eigenen GitHub-Konto, sende neue Versionen, wann du willst, und gib den Code an einen Entwickler weiter.
Der Code deiner App gehört dir. Mit GitHub kannst du eine Kopie davon in einem privaten Repository auf deinem eigenen GitHub-Konto aufbewahren, neuere Versionen dorthin senden, wann du willst, und den Code mit einem Entwickler teilen. Der GitHub-Export ist in jedem Tarif enthalten und verbraucht keine Credits.
So funktioniert die GitHub-Synchronisierung
| Was du tust | Was passiert |
|---|---|
| Du sendest dein Projekt zum ersten Mal | Buildliy erstellt ein privates Repository auf deinem GitHub-Konto, benannt nach deinem Projekt (zum Beispiel buildliy-candle-shop oder buildliy-candle-shop-2, falls der Name schon vergeben ist), und sendet deine neueste Version mit einer README |
| Du baust in Buildliy weiter | Es wird nichts automatisch gesendet. Ein kleiner Punkt am GitHub-Symbol zeigt dir, dass es neuere Versionen gibt, die GitHub noch nicht hat |
| Du wählst Neueste Version senden | Deine neueste Version kommt als neuer Commit ins Repository |
| Jemand hat das Repository auf GitHub bearbeitet | Buildliy überschreibt die Arbeit dieser Person nicht. Dein Update kommt als Pull Request an, den du auf GitHub ansehen und zusammenführen kannst |
Änderungen, die auf GitHub gemacht werden, bleiben auf GitHub. Sie fließen nicht zurück in dein Buildliy-Projekt oder in dessen Vorschau.
GitHub verbinden und dein Repository erstellen
Auf das GitHub-Symbol klicken
Öffne dein Projekt und klicke oben rechts auf das GitHub-Symbol neben Veröffentlichen. Wenn du GitHub noch nicht verbunden hast, gelangst du damit zu GitHub.
Auf GitHub bestätigen
Melde dich bei GitHub an, falls nötig, und erlaube Buildliy den Zugriff. GitHub zeigt dir, was Buildliy anfragt: vollen Zugriff auf deine Repositories, öffentliche und private, den Buildliy braucht, um das Repository deines Projekts zu erstellen und zu aktualisieren, und Lesezugriff auf dein Profil. Danach kommst du zurück zu deinem Projekt und siehst „GitHub ist verbunden – du kannst dieses Projekt jetzt an GitHub senden.“
Das Repository erstellen
Klicke noch einmal auf das GitHub-Symbol und wähle Privates Repo erstellen. Dafür brauchst du mindestens einen fertigen Build. Bis dahin steht dort Erst bauen. Wenn alles fertig ist, siehst du „An GitHub gesendet“ mit dem Namen des Repositorys und einem Button Öffnen.
Du kannst auch in Verwalten → Übersicht auf Auf GitHub sichern klicken (unter Zauberassistenten, sobald das Backend deiner App bereit ist). Das macht dasselbe: Beim ersten Mal erstellt es das Repository, danach aktualisiert es dieses. Verbinde GitHub vorher über das GitHub-Symbol.
Neuere Versionen senden
Klicke auf das GitHub-Symbol, um das Menü zu öffnen:
- Neueste Version senden sendet deine neueste Version. Im Menü steht Neue Änderungen, wenn es etwas zu senden gibt, sonst Auf dem neuesten Stand.
- Repo öffnen öffnet das Repository auf GitHub.
- GitHub trennen entfernt den Zugriff von Buildliy (siehe unten).
Nach dem Senden siehst du eine dieser Meldungen:
- „Deine neueste Version wurde gesendet an …“: Das Repository entspricht jetzt deiner App.
- „… hat bereits deine neueste Version.“: Es gab nichts Neues zu senden.
- „Pull Request auf GitHub erstellt“: Im Repository gab es Änderungen, die auf GitHub gemacht wurden. Darum ist dein Update in einem Pull Request gelandet. Klicke auf Ansehen und führe ihn dann auf GitHub zusammen, damit das Repository auf den neuesten Stand kommt.
Was im Repository steckt
- Alle Dateien deiner App, auch die Bilder, mit denselben kleinen Sicherheitskorrekturen, die Buildliy beim Veröffentlichen macht (zum Beispiel wird das Hilfsprogramm des Builders für die Bearbeitung der Vorschau weggelassen).
- Eine README mit dem Namen und der Beschreibung deiner App, ihrer Live-Adresse, falls sie veröffentlicht ist, einer Anleitung, wie du sie auf einem Computer startest (Node.js 20 oder neuer, dann
npm installundnpm run dev), allen Einstellungen, die sie braucht, und einem Link zurück zu deinem Buildliy-Projekt. - Eine
.env.example-Datei, wenn deine App irgendwelche Einstellungen (Umgebungsvariablen) liest. Sie listet deren Namen mit Hinweisen auf. Werte stehen nie darin.
Manches ist nie im Repository:
- Secrets. Buildliy sendet keinen Code, der aussieht, als enthielte er einen geheimen Schlüssel. Wenn Buildliy einen findet, sagt es dir, in welcher Datei er steckt, und bittet dich, den Schlüssel nach Verwalten → Secrets zu verschieben (oder die KI darum zu bitten), bevor du es noch einmal versuchst. Schlüssel, die als Secrets oder Konnektoren gespeichert sind, bleiben in Buildliy. Mehr dazu unter Secrets und API-Schlüssel.
- Die Daten deiner App. Die Tabellen und alles, was darin gespeichert ist, bleiben in der Datenbank deiner App. Wenn du den Code mit einer neuen Datenbank verbindest, startet er leer.
- Der private Buildliy-Schlüssel deiner App. Eingebaute Funktionen wie KI in deiner App und Zahlungen nutzen ihn. Er wird automatisch gesetzt, wenn deine App auf Buildliy läuft. Läuft der Code woanders, funktionieren diese Funktionen ohne ihn nicht.
Wenn Buildliy dein Repository nicht aktualisieren kann
Wenn das Repository gelöscht oder archiviert wurde, zu einem anderen GitHub-Konto gehört als dem, das du verbunden hast, oder dein Konto dort nichts senden darf, zeigt Buildliy Aktualisierung nicht möglich mit dem Namen des Repositorys und dem Grund. Wähle Neues Repo erstellen, um deine neueste Version stattdessen an ein frisches privates Repository zu senden. Das alte wird dabei nicht verändert oder gelöscht.
Mit einem Entwickler arbeiten
Zugriff auf GitHub geben
Lade den Entwickler in den GitHub-Einstellungen zum Repository ein. Dein Repository ist privat, also können es nur die Personen sehen, die du einlädst.
Die README befolgen lassen
Die README erklärt, wie man die App lokal startet und welche Einstellungen man ausfüllen muss. Der Entwickler kopiert
.env.examplenach.env.localund trägt seine eigenen Werte ein.Klären, wo Änderungen passieren
Buildliy holt keine Änderungen von GitHub zurück in dein Projekt. Wenn du in Buildliy weiterbaust, während ein Entwickler auf GitHub etwas ändert, kommt jedes deiner Updates als Pull Request an. Der Entwickler kann ihn zusammen mit seiner eigenen Arbeit zusammenführen.
Du möchtest GitHub lieber nicht nutzen? Du kannst den gesamten Code als ZIP-Datei im Tab Code herunterladen. Mehr dazu unter Code ansehen und herunterladen.
In einem gemeinsamen Workspace kann nur der Workspace-Inhaber ein Projekt an GitHub senden, weil der Code an sein GitHub-Konto geht. Teammitglieder können ein verknüpftes Repository über das GitHub-Symbol öffnen. GitHub zeigt es aber nur den Personen, denen der Inhaber auf GitHub Zugriff gegeben hat.
GitHub trennen
Klicke auf das GitHub-Symbol, wähle GitHub trennen und bestätige. Buildliy hat dann für kein Projekt mehr Zugriff auf dein GitHub-Konto, und der bisherige Zugriff wird widerrufen. Deine Repositories und ihr Code bleiben auf GitHub, und jedes Projekt bleibt mit seinem Repository verknüpft. Bis du dich wieder verbindest, zeigt das GitHub-Menü bei einem verknüpften Projekt GitHub zum Senden verbinden. Du kannst dich jederzeit wieder verbinden, auch mit einem anderen GitHub-Konto.
Verwandte Themen
Du kommst nicht weiter? Lies die FAQ oder schreib uns.