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, Publish sendet einen Commit an deinen Repository. GitHub Actions führt den Build und bundle upload für dich durch.

Diese Anleitung behandelt die einzige manuelle Einrichtung, die dein Client einmal durchführen muss: das 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 der Pipeline funktioniert

Schritt	Wer	Was passiert
1	Client	Bearbeitet die App in Lovable und klickt auf Veröffentlichen
2	Liebenswerte	Commits und Pushes an GitHub (üblicherweise `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 guide)
Capacitor + @capgo/capacitor-updater im Repository (Lovable zu mobilen Anleitung)
App in Capgo registriert mit capacitor.config.ts auf die richtige appId
production Kanal existiert und ist mit den Builds verbunden, die deine Benutzer ausführen

Schritt 1 — Erstelle ein Capgo API-Schlüssel

Öffnen console.capgo.app/apikeys/
Erstelle einen API-Schlüssel mit Berechtigung, um Pakete für deine App hochzuladen
Kopiere den Schlüssel einmal. Du wirst den vollständigen Wert nicht wiedersehen

Behandle diesen Schlüssel wie ein Passwort. Kommitiere ihn nie in Git oder füge ihn nicht in Lovable-Chat ein

Schritt 2 — Hinzufügen `CAPGO_TOKEN` in GitHub (die einzige Umgebungsvariable)

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 → Geheimnisse und Variablen → Aktionen
Klicken Sie Neues Repository-Geheimnis
Name: CAPGO_TOKEN
Wert: Fügen Sie die Capgo API-Schlüssel aus Schritt 1 ein
Speichern

GitHub injiziert das Geheimnis in Workflows als ${{ secrets.CAPGO_TOKEN }}. Das unten stehende Workflow liest es als das CAPGO_TOKEN Umgebungsvariable 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 das GitHub Actions-Workflow hinzu

Option A — Bitten Sie Lovable, das Datei zu erstellen

Fügen Sie dies in Lovable Chat ein (Anpassen Sie die Zweigname, wenn Ihr Standard nicht Lovable ist) 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 .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: Vite-Anwendungen, die man liebt, 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 wieder und lassen Sie den Workflow neu 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, füge einen kleinen sichtbaren Änderung hinzu (z.B. Button-Label-Text)
Klicken Sie Veröffentlichen
Öffnen Sie auf GitHub 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.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Lösung
Workflow läuft nie	Push ging zu einem anderen Zweig als `main`	Änderung `branches` in der Workflow- oder Veröffentlichung zu `main`
`CAPGO_TOKEN` / Auth-Fehler	Geheimer Schlüssel fehlt oder falscher Name	Geheimer Schlüssel muss 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 Sie noch einmal
Upload gelingt, weiße Seite	Falsch `webDir` oder Vite `base`	Übereinstimmen `capacitor.config.ts` `webDir` um die Ausgabedatei (`dist` für Vite) und setzen `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 Sie den Kanal auf öffentlich

Zum Verständnis weiterer Workflowmuster (Funktionszweige, PR-Kanäle, Verschlüsselung) siehe GitHub Actions-Integration.

Was Sie Ihrem Kunden sagen

Senden Sie ihnen diesen Checklisten-Überblick:

Sie bereits verbunden Lovable zu GitHub und Capgo auf der 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 sie nie npx @capgo/cli lokal, es sei denn, sie möchten es.

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

Geht weiter

iOS und Android für Lovable konvertieren — Vollständige Capacitor + Capgo-Einrichtung, wenn das App-Wrapper noch nicht erfolgt ist
Automatische Build- und Release-Verarbeitung mit GitHub Actions — Tag-basierte Releases und Versions-Updates
GitHub Actions-Integration — Mehrkanal- und PR-Vorschau-Kanäle
Capgo Live-Updates — Kanäle, Rollbacks und Adoption-Statistiken