Automatisieren Sie Capgo Live-Updates von Lovable mit GitHub Aktionen

Ihr Kunde möchte einen einzelnen Button in Lovable haben, der Änderungen an jeden aktiven Benutzer schickt. Sie haben bereits den Update-Weg manuell bewiesen:

npx @capgo/cli@latest bundle upload --channel=production

Der fehlende Teil ist nicht noch ein Terminal-Befehl innerhalb von Lovable. Lovable kann Capgo nicht auf Publish ausführen. Wenn GitHub-Synchronisierung aktiviert ist, Pushen sendet einen Commit an Ihren Repository. GitHub Actions führt das Build und bundle upload für Sie durch.

Diese Anleitung behandelt die einzige manuelle Einrichtung, die Ihr Client einmal durchführen muss: Hinzufügen von CAPGO_TOKEN als einem GitHub-Geheimnis. Alles andere kann mit einem Lovable-Prompt oder einem kleinen Workflow-File hinzugefügt werden.

Wie das Pipeline funktioniert

Schritt	Wer	Was passiert
1	Client	Bearbeitet die App in Lovable und klickt auf Publish
2	Lovable	Commits und Pushes an GitHub (normalerweise `main`)
3	GitHub-Aktionen	`npm ci`, `npm run build`, `bundle upload` zu Capgo
4	Capgo	Aktive Geräte auf dem `production` Kanal erhalten die Aktualisierung

Kein SSH, kein lokales CLI, kein zusätzlicher Klick nach der Konfiguration des Geheimnisses.

Voraussetzungen

Lovable-Projekt verbunden mit GitHub (Export-Anleitung)
Capacitor + @capgo/capacitor-updater in dem Repository (Lovable zu mobilen Leitfaden)
App in Capgo registriert mit capacitor.config.ts weist auf die richtige appId
production Kanal existiert und ist mit den Builds verbunden, die Ihre Benutzer ausführen

Schritt 1 — Erstellen Sie ein Capgo API-Schlüssel

Öffnen console.capgo.app/apikeys/
Erstellen Sie einen API-Schlüssel mit Berechtigung, um Pakete für Ihre App hochzuladen
Kopieren Sie den Schlüssel einmal. Sie werden den vollständigen Wert nicht wiedersehen

Behandeln Sie diesen Schlüssel wie ein Passwort. Komiten Sie ihn nie in Git oder fügen Sie ihn nicht in Lovable-Chat ein.

Schritt 2 — Hinzufügen `CAPGO_TOKEN` In GitHub (der einzige Umgebungsstep)

Dies ist der Schritt, den Sie an Kuldeep und jedem Kunden, der den Repository besitzt, senden.

Öffnen Sie das GitHub Repository, das Lovable synchronisiert.
Zu Einstellungen → Geheime und Variablen → Aktionen
Klicken Sie Neues Repository-Secret
Name: CAPGO_TOKEN
Wert: Fügen Sie die Capgo API-Schlüssel aus Schritt 1 ein.
Speichern

GitHub injiziert das Geheimnis in Workflows ein. ${{ secrets.CAPGO_TOKEN }}. Das unten stehende Workflow liest es als das CAPGO_TOKEN Umweltvariable für den Capgo CLI.

Wenn das Repository unter der Organisation Ihres Kunden liegt, müssen sie das Geheimnis auf ihrem Repository hinzufügen. Sie benötigen nur den Schlüssel in GitHub, nicht in Lovable-Einstellungen.

Schritt 3 — Fügen Sie dem GitHub Actions-Workflow hinzu

Option A — Lassen Sie Lovable das Datei erstellen

Fügen Sie dies in Lovable-Chat ein (Anpassen Sie die Branch-Name, wenn Ihr Standard nicht main):

Create `.github/workflows/capgo-live-updates.yml` that runs on every push to `main`:

1. Checkout code
2. Setup Node.js 24 with npm cache
3. Run `npm ci` and `npm run build`
4. Run `npx @capgo/cli@latest bundle upload --channel=production`
5. Use environment variable `CAPGO_TOKEN` from GitHub Actions secrets (do not hardcode the API key)

Use `actions/checkout@v6` and `actions/setup-node@v6`. Commit the workflow file to the repo.

Lovable wird die YAML hinzufügen und es auf dem nächsten Publish pushen.

Option B — Fügen Sie die Datei selbst hinzu

Erstellen Sie .github/workflows/capgo-live-updates.yml:

name: Capgo Live Updates

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: '24'
          cache: 'npm'

      - name: Install and build
        run: |
          npm ci
          npm run build

      - name: Upload bundle to Capgo
        run: npx @capgo/cli@latest bundle upload --channel=production
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Commit und pushen. Der erste Lauf startet, sobald GitHub den Push erhält.

Vite base path: Liebenswerte Vite-Anwendungen benötigen oft base: './' in vite.config.ts so laden sich die Assets innerhalb des nativen Shells. Wenn Benutzer nach einer OTA-Update eine weiße Seite sehen, beheben Sie base, veröffentlichen Sie erneut und lassen Sie den Workflow wiederum bereitstellen.

Verschlüsselte Bundles: Wenn Sie Capgo-Verschlüsselungverwenden, fügen Sie CAPGO_PRIVATE_KEY als zweites GitHub-Geheimnis und übergeben Sie --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" auf dem Upload-Schritt.

Schritt 4 — Bestätige Veröffentlichung löst einen Bereitstellung aus

In Lovable, machen Sie eine kleine sichtbare Änderung (zum Beispiel den Text des Schalters)
Klicken Sie Veröffentlichen
Auf GitHub, öffnen Sie Aktionen und beobachten Sie Capgo Live-Updates
Wenn der Job grün ist, öffnen Sie Ihr Capgo-Konsole und bestätigen Sie eine neue Bundle auf dem production Kanal
Auf einem Gerät mit der installierten App bestätigen Sie, dass die Änderung eingetroffen ist (kann einige Minuten dauern, je nach Einstellungen des Kanals)

✅ Erfolg: In Lovable veröffentlichen → grün GitHub Aktion → neue Bundle in Capgo → Benutzer erhalten die Aktualisierung.

Fehlersuche

Symptom	Wahrscheinliche Ursache	Lösung
Arbeitsablauf wird nie ausgeführt	Push ging zu einem anderen Zweig als `main`	Änderung `branches` in dem Arbeitsablauf oder Veröffentlichung zu `main`
`CAPGO_TOKEN` / Auth-Fehler	Geheime Schlüssel fehlen oder falscher Name	Geheime Schlüssel müssen genau `CAPGO_TOKEN` unter Aktionen Geheimnisse
Build fehlt bei `npm ci`	Lockdatei ist nicht synchron	Ausführen `npm install` lokal, commit `package-lock.json`, veröffentlichen
Upload erfolgreich, weiße Seite	Falsch `webDir` oder Vite `base`	Match `capacitor.config.ts` `webDir` um die Ausgabedatei zu bauen (`dist` für Vite) und festzulegen `base: './'`
Benutzer sehen die Aktualisierung nicht	Kanal ist nicht mit ihrem Build verbunden	In Capgo, verknüpfen Sie den Gerätebuild mit `production` oder setzen den Kanal auf öffentlich

Für weitere Workflowmuster (Featurezweige, PR-Kanäle, Verschlüsselung), siehe GitHub Actions-Integration.

Was Sie Ihrem Kunden sagen

Senden Sie ihnen diese Liste:

Sie bereits verbunden Lovable zu GitHub und Capgo auf dem mobilen App eingerichtet.
Sie fügen ein GitHub Geheimnis hinzu: CAPGO_TOKEN mit ihrem Capgo API Schlüssel (apikeys-Seite).
Sie klicken Veröffentlichen in Lovable, sobald sie möchten, dass Benutzer Änderungen erhalten.
Sie führen npx @capgo/cli nur lokal durch, wenn sie es wollen.

Das entspricht der Einfachheit, die sie gefordert haben: Veröffentlichen in Lovable ist der Knopf; GitHub Aktionen und Capgo erledigen den Rest.

Gehe weiter

iOS und Android für Lovable konvertieren — Vollständige Capacitor + Capgo-Einrichtung, wenn du das App noch nicht umgewickelt hast
Automatische Build- und Release-Verarbeitung mit GitHub Actions — Tag-basierte Releases und Versionshöhe
GitHub Actions-Integration — Mehrkanal- und PR-Vorschaukanäle
Capgo Live-Updates — Kanäle, Rollbacks und Adoption-Statistiken