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 Kunde 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 | Kunde | Bearbeitet die App in Lovable und klickt auf Veröffentlichen |
| 2 | Lovable | Commits und Pushes zu GitHub (meistens main) |
| 3 | GitHub Aktionen | npm ci, npm run build, bundle upload --auto-bump zu Capgo |
| 4 | Capgo | Aktive Geräte im production Channel erhalten das Update |
Kein SSH, kein lokales CLI, kein extra Klick nach der Konfiguration des Secrets.
Voraussetzungen
- Lovable-Projekt mit GitHub verbunden (Export-Guide)
- Capacitor +
@capgo/capacitor-updaterin the repo (Lovable-zu-Mobile-Guide) - In Capgo registrierte App mit
capacitor.config.tsdas auf den richtigenappId productionChannel zeigt, 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 für dich, sodass die CI beim zweiten Deploy fehlschlagen würde, wenn du dieselbe Version wiederverwendest.
--auto-bump liest die neueste Version im Channel (oder in 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 oder füge ihn 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 sendest, die das Repo besitzen.
- Öffne das GitHub Repository, mit dem Lovable synchronisiert
- Gehe zu Einstellungen → Secrets und Variablen → Aktionen
- Klicken Neues Repository-Secret
- Name:
CAPGO_TOKEN - Wert: Füge den Capgo API Key aus Schritt 1 ein
- Speichern
GitHub injiziert das Secret als ${{ secrets.CAPGO_TOKEN }}. Der folgende Workflow liest es als CAPGO_TOKEN Umgebungsvariable für die Capgo CLI.
Wenn das Repo zur Organisation Ihres Kunden gehört, 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 — Bestätigen, dass Publish einen Deploy auslöst
- Mache in Lovable eine kleine sichtbare Änderung (z. B. den Button-Text)
- Klicken Veröffentlichen
- Öffne auf GitHub Aktionen und beobachte Capgo Live Updates
- Sobald der Job grün ist, öffne deine Capgo Console und bestätige ein neues Bundle im
productionChannel - Auf einem Gerät mit installierter App prüfen, ob die Änderung ankommt (kann je nach Channel-Einstellungen 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 ging auf einen anderen Branch als main |
Änderung branches im Workflow oder veröffentliche auf 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, weißer Bildschirm | Falsch webDir oder Vite base |
Abgleichen 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 Sie Ihrem Kunden sagen
Schick ihnen diese Checkliste:
- Du haben Lovable bereits mit GitHub verbunden und Capgo in der mobilen App eingerichtet.
- Sie fügen ein GitHub Secret hinzu:
CAPGO_TOKENmit ihrem Capgo API Key (apikeys-Seite). - Sie klicken Veröffentlichen in Lovable, wann immer Nutzer Änderungen erhalten sollen.
- Sie führen sie nie
npx @capgo/clilokal 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