Automatisieren Sie Capgo Live Updates mit liebenswerten GitHub Aktionen

Ihr Kunde möchte einen einzelnen Button in Lovable, der Änderungen an jeden aktiven Benutzer sendet. Sie haben bereits nachgewiesen, dass der Update-Path manuell funktioniert:

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

Der fehlende Teil ist nicht noch ein Terminal-Befehl innerhalb von Lovable. Lovable kann Capgo nicht auf Publish ausführen. Wenn GitHub-Sync aktiviert ist, Publish pusht einen Commit in Ihren Repository. GitHub-Aktionen führen den Build und bundle upload für Sie durch.

This guide covers the only manual setup your client must do once: add CAPGO_TOKEN als ein GitHub-Geheimnis. Für das Workflow-File fügen Sie die fertige AI-Anweisung in Lovable (Schritt 3) ein.

How funktioniert der Pipeline?

Schritt	Wer	Was passiert
1	Kunde	Ändert die App in Lovable und klickt auf Veröffentlichen
2	Lovable	Kommt und pusht zu GitHub (normalerweise) `main`)
3	GitHub Actions	`npm ci`, `npm run build`, `bundle upload --auto-bump` 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 geheimen Konfiguration.

Voraussetzungen

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

Why `--auto-bump`

Jeder Capgo Upload benötigt eine neue eindeutige Bundle-Version.Lovable Publish führt keine Bump durch package.json liest die neueste Version auf dem Kanal (oder App) und erhöht sie. Der Standardwert ist

--auto-bump liest die neueste Version auf dem Kanal (oder App) und erhöht sie um eins. Standardlevel ist minorSie können die folgenden Werte übergeben --auto-bump patch or --auto-bump major Schritt 1 — Erstellen Sie ein __CAPGO_KEEP_0__ __CAPGO_KEEP_1__-Schlüsselpaar

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

Open 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 nicht in Git oder füge ihn nicht in Lovable-Chat ein

Schritt 2 — Hinzufügen `CAPGO_TOKEN` im GitHub (der einzige Umgebungs-Schritt)

Dies ist der Schritt, den du an Kuldeep und jedem Kunden, der den Repository besitzt, sendest

Öffne das GitHub-Repository, das Lovable synchronisiert
Gehe zu Einstellungen → Geheimnisse und Variablen → Gehe zu
Klicke Neues Repository-Secret
Name: CAPGO_TOKEN
Wert: Fügen Sie den Capgo API-Schlüssel aus Schritt 1 ein
Speichern

GitHub fügt das Secret in Workflows ein 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 Secret auf ihrem repo. Sie benötigen nur den Schlüssel in GitHub, nicht in Lovable-Einstellungen.

Schritt 3 — Fügen Sie diesen Hinweis in Lovable ein

Kopieren Sie den Block unten in die Lovable-Chats. Wenn Ihr Default-Branch nicht main, replace main Ersetzen Sie in der Arbeitsablauf mit Ihrem Branch-Namen.

Add Capgo Live Updates CI with GitHub Actions.

Create `.github/workflows/capgo-live-updates.yml` (create folders if needed). Start from this YAML, then adapt install/build to this project while keeping Capgo upload + CAPGO_TOKEN secret behavior:

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 --auto-bump
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Rules:
- Do not hardcode any Capgo API key in the repo or in chat.
- The workflow must read CAPGO_TOKEN only from GitHub Actions secrets (`${{ secrets.CAPGO_TOKEN }}`).
- Keep `--auto-bump` on the upload command so each Publish gets a new unique bundle version.
- Prefer the project's real production build script from package.json (for example `npm run build` or `vite build`).
- If package-lock.json is missing, use `npm install` instead of `npm ci`.
- Do not modify app UI or Capacitor config for this task.
- Commit the workflow file so the next Publish pushes it to GitHub.

Klicken Sie nachdem Lovable die Änderung angewendet hat Veröffentlichen so dass der Arbeitsablauf auf GitHub landet.

Manuelle Alternative

Wenn Sie die Lovable-Chats nicht verwenden möchten, erstellen Sie .github/workflows/capgo-live-updates.yml mit diesem YAML nur (nicht die prompte Prosa). Anpassen Sie die Installations- und Build-Schritte auf die gleiche Weise wie die Regeln oben, wenn Ihr Projekt sich unterscheidet, dann committen und pushen.

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 --auto-bump
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Vite base Weg: Liebenswerte Vite-Anwendungen benötigen oft base: './' mit vite.config.ts so laden sich die Assets innerhalb des nativen Shells. Wenn Benutzer nach einer OTA-Update eine weiße Seite sehen, fragen Sie Lovable, base: './'publishen Sie erneut und lassen Sie das Workflow wieder bereitstellen.

Verschlüsselte Bundles: Wenn Sie Capgo Verschlüsselung, add CAPGO_PRIVATE_KEY als zweites GitHub Geheimnis und weitergeben --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" __CAPGO_KEEP_0__ Geheimnis hinzu und übergeben Sie

Schritt 4 — Veröffentlichung bestätigen

Schritt 4 — Bestätigen Sie die Veröffentlichung, die einen Bereitstellung auslöst
Click Publish
On GitHub, GitHub öffnen Actions und beobachten Capgo Live Updates
Wenn die Aufgabe grün ist, öffnen Sie Ihren Capgo Konsole und bestätigen Sie ein neues Bundle auf dem production channel
Auf einem Gerät mit der installierten App bestätigen Sie, dass die Änderung eingetroffen ist (kann einige Minuten dauern, je nach Kanal-Einstellungen).

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

Troubleshooting

Symptom	Wahrscheinliche Ursache	Lösung
Arbeitsablauf läuft nie	Push ging zu einem anderen Zweig als `main`	Änderung `branches` in dem Arbeitsablauf oder veröffentlichen Sie zu `main`
`CAPGO_TOKEN` Auth-Fehler	Geheimes fehlt oder falscher Name	Geheimes muss genau `CAPGO_TOKEN` unter Actions-Secrets
Version existiert bereits	Upload wiederverwendet die gleiche Bundle-Version	Keep `--auto-bump` der Upload-Schritt (oder passen Sie `--auto-bump patch`)
Beim Build schlägt `npm ci`	Lockfile ist nicht synchron	Laufen Sie `npm install` lokal, commit `package-lock.json`lokale, commit
, veröffentlichen Sie wieder	Wrong `webDir` Falsch `base`	oder Vite `capacitor.config.ts` `webDir` um die Ausgabe zu bauen (`dist` für Vite) und setzen `base: './'`
Benutzer sehen die Aktualisierung nicht	Kanal nicht mit ihrem Build verbunden	In Capgo, verknüpfen Sie den Gerätebuild mit `production` oder setzen Sie den Kanal auf öffentlich

Für weitere Workflowmuster (Funktionszweige, PR-Kanäle, Verschlüsselung), sehen Sie sich bitte an GitHub Actions-Integration.

Was Sie Ihrem Kunden erzählen

Senden Sie ihnen diesen Checklisten:

Sie bereits Lovable mit GitHub verbunden und Capgo auf der mobilen App eingerichtet haben
Sie fügen sie 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 die Benutzer Änderungen erhalten.
Sie laufen nie npx @capgo/cli lokale Anwendungen, es sei denn, sie wollen das.

Das entspricht der ein-klickigen Erfahrung, die sie sich gewünscht haben: Veröffentlichen in Lovable ist der Button; GitHub Actions und Capgo erledigen den Rest.

Weitermachen

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

Automatisieren Sie Capgo Live-Updates mit lieblichen GitHub Actions