Capgo Live Updates mit GitHub Actions automatisieren

Dein Kunde möchte in Lovable einen einzigen Button, der Änderungen an alle aktiven User ausrollt. Du hast bereits manuell bewiesen, dass der Update-Pfad funktioniert:

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

Das fehlende Puzzleteil ist kein weiterer Terminal-Befehl innerhalb von Lovable. Lovable cannot run Capgo on Publish. Wenn der GitHub Sync aktiviert ist, Publish pusht einen Commit in dein Repo. GitHub Actions führt den Build aus und bundle upload für dich.

Dieser Guide beschreibt das einzige manuelle Setup, das dein Client einmalig machen muss: Füge CAPGO_TOKEN als GitHub Secret hinzu. Kopiere die fertige AI-Anweisung für die Workflow-Datei in Lovable (Schritt 3).

So funktioniert die Pipeline

Schritt	Wer	Was passiert
1	Client	Bearbeitet die App in Lovable und klickt auf Veröffentlichen
2	Lovable	Commits und Pushes an GitHub (meistens `main`)
3	GitHub Aktionen	`npm ci`, `npm run build`, `bundle upload --auto-bump` an Capgo)
4	Capgo	Aktive Geräte im `production` Channel erhalten das Update

Kein SSH, kein lokales CLI, kein Klick nach der Konfiguration des Secrets.

Voraussetzungen

Lovable-Projekt mit GitHub verbunden (Export-Guide)
Capacitor + @capgo/capacitor-updater in the repo (Lovable-zu-Mobile-Guide)
App in Capgo registriert mit capacitor.config.ts zeigt auf den richtigen appId
production Channel existiert und ist mit den Builds deiner User verknüpft

Warum `--auto-bump`

Jeder Capgo Upload benötigt eine neue, eindeutige Bundle-Version. Lovable Publish erhöht diese nicht package.json automatisch, weshalb die CI beim zweiten Deploy fehlschlagen würde, wenn du dieselbe Version wiederverwendest.

--auto-bump liest die neueste Version des Channels (oder der App) und inkrementiert sie. Das Standardlevel ist minor. Du kannst --auto-bump patch oder --auto-bump major wenn du möchtest.

Schritt 1 — Erstelle einen Capgo API Key

Öffne console.capgo.app/apikeys/
Erstelle einen API Key mit Berechtigung zum Upload von Bundles für deine App
Kopiere den Key einmalig. Du wirst den vollständigen Wert nie wieder sehen

Behandle diesen Key wie ein Passwort. Committe ihn niemals in Git und füge ihn nicht in den Lovable Chat ein.

Schritt 2 — Hinzufügen `CAPGO_TOKEN` in GitHub (der einzige Env-Schritt)

Dies ist der Schritt, den du an Kuldeep und alle Kunden weitergibst, die das Repo besitzen.

Öffne das GitHub Repository, mit dem Lovable synchronisiert
Gehe zu Einstellungen → Secrets und Variablen → Actions
Klicken Neues Repository-Secret
Name: CAPGO_TOKEN
Wert: Füge den Capgo API Key aus Schritt 1 ein
Speichern

GitHub injiziert das Secret in die Workflows als ${{ secrets.CAPGO_TOKEN }}. Der folgende Workflow liest es als CAPGO_TOKEN Umgebungsvariable für das Capgo CLI.

Gehört das Repo zur Organisation Ihres Kunden, muss dieser das Secret in seinem Repo hinzufügen. Sie benötigen nur den Key aus GitHub, nicht in den Lovable-Einstellungen.

Schritt 3 — Diesen Prompt in Lovable einfügen

Kopieren Sie den folgenden Block in den Lovable-Chat. Falls Ihr Default-Branch nicht mainist, ersetzen Sie main im Workflow durch Ihren 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.

Sobald Lovable die Änderung angewendet hat, klicke auf Veröffentlichen damit der Workflow auf GitHub landet.

Manuelle Alternative

Falls Sie den Lovable-Chat nicht nutzen möchten, erstellen Sie .github/workflows/capgo-live-updates.yml nur mit diesem YAML (nicht dem Prompt-Text). Passe die Install-/Build-Schritte genauso an wie oben in den Regeln, falls dein Projekt abweicht, 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 Pfad: Lovable Vite-Apps brauchen oft base: './' in vite.config.ts damit Assets in der Native Shell geladen werden. Wenn Nutzer nach einem OTA-Update einen White Screen sehen, Lovable bitten, das zu setzen, base: './', erneut zu veröffentlichen und den Workflow neu deployen zu lassen.

Verschlüsselte Bundles: Wenn du Capgo-Verschlüsselung, füge CAPGO_PRIVATE_KEY als zweites GitHub-Secret hinzu und übergib --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" beim Upload-Schritt.

Schritt 4 — Confirm Publish löst ein Deployment aus

Mache in Lovable eine kleine sichtbare Änderung (z. B. den Button-Text)
Klicken Veröffentlichen
Öffne auf GitHub Actions und beobachte Capgo Live Updates
Sobald der Job grün ist, öffne deine Capgo Console und bestätige das neue Bundle im production Channel
Auf einem Gerät mit installierter App prüfen, ob die Änderung ankommt (je nach Channel-Einstellungen kann dies eine Minute dauern)

✅ Erfolg: In Lovable veröffentlichen → grüne GitHub Action → neues Bundle in Capgo → User erhalten das Update.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Lösung
Workflow wird nie ausgeführt	Push erfolgte auf einen anderen Branch als `main`	Änderung `branches` im Workflow oder Veröffentlichung an `main`
`CAPGO_TOKEN` / Auth-Fehler	Secret fehlt oder Name ist falsch	Secret muss exakt sein: `CAPGO_TOKEN` unter Actions secrets
Version existiert bereits	Upload nutzt dieselbe Bundle-Version	Behalten `--auto-bump` beim Upload-Schritt (oder übergebe `--auto-bump patch`)
Build fehlgeschlagen bei `npm ci`	Lockfile nicht synchron	Ausführen `npm install` lokal, commit `package-lock.json`, erneut veröffentlichen
Upload erfolgreich, aber weißer Bildschirm	Falsch `webDir` oder Vite `base`	Match `capacitor.config.ts` `webDir` mit dem Build-Output (`dist` für Vite) und setze `base: './'`
User sehen das Update nicht	Channel nicht mit ihrem Build verknüpft	Verknüpfe in Capgo den Device-Build mit `production` oder setze den Channel auf public

Weitere Workflow-Patterns (Feature Branches, PR Channels, Verschlüsselung) findest du unter GitHub Actions-Integration.

Was du deinem Kunden sagst

Schick ihnen diese Checkliste:

Du hat Lovable bereits mit GitHub verbunden und Capgo in der mobilen App eingerichtet.
Sie müssen ein GitHub Secret hinzufügen: CAPGO_TOKEN mit ihrem Capgo API Key (apikeys Seite).
Sie müssen klicken Veröffentlichen in Lovable, wann immer Nutzer Änderungen erhalten sollen.
Sie führen sie nie npx @capgo/cli lokal aus, außer sie wollen es.

Das entspricht genau dem Single-Click-Erlebnis, das sie sich gewünscht haben: „Publish in Lovable“ ist der Button; GitHub Actions und Capgo erledigen den Rest.

Weiter

Lovable in iOS- und Android-Apps umwandeln — Komplettes Capacitor + Capgo Setup, falls du die App noch nicht gewrappt hast
Automatischer Build und Release mit GitHub Actions — Tag-basierte Releases und Version-Bumps
GitHub Actions-Integration — Multi-Channel- und PR-Preview-Channels
Capgo Live Updates — Channels, Rollbacks und Adoptions-Statistiken