Automatisieren Sie Capgo Live-Updates mit GitHub Actions

Ihr Kunde möchte eine einzelne Schaltfläche in Lovable haben, die Änderungen an jedem aktiven Benutzer schickt. Sie haben bereits den Update-Weg manuell bewiesen:

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-Synchronisierung aktiviert ist, Pushes werden in Ihrem Repository hochgeladen.. GitHub Actions führt die Build- und bundle upload für Sie durch.

In diesem Leitfaden wird die einzige manuelle Einrichtung behandelt, die Ihr Kunde einmal durchführen muss: CAPGO_TOKEN als GitHub-Geheimnis hinzufügen. Für das Workflow-File kopieren Sie die fertige AI-Anweisung in Lovable (Schritt 3).

Wie der Pipeline funktioniert

No SSH, no local CLI, no extra click after the secret is configured.

Verbindung des Lieblingsprojekts zu __CAPGO_KEEP_0__ (

• Lovable project connected to GitHub (__CAPGO_KEEP_0__ +)
• Capacitor @capgo/capacitor-updater im Repository (Lovable zu mobilen Geräten)
• App in Capgo registriert mit capacitor.config.ts der auf die richtige appId
• production ein Channel existiert und ist mit den Builds verbunden, die Ihre Benutzer ausführen

Warum --auto-bump

Jedes Capgo-Upload benötigt eine neue eindeutige Bundle-VersionLovable Publish erhöht diese nicht für Sie, daher würde CI auf dem zweiten Deploy fehlschlagen, wenn Sie die gleiche Version wiederholen. package.json liest die neueste Version auf dem Channel (oder App) und erhöht sie. Der Standardwert ist

--auto-bump Sie können minorpassen --auto-bump patch oder --auto-bump major falls Sie es bevorzugen.

Schritt 1 — Erstellen Sie eine Capgo API Schlüssel

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

Behandeln Sie diesen Schlüssel wie ein Passwort. Komitieren Sie ihn nicht in Git oder fügen Sie ihn 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.

1. Öffnen Sie das GitHub-Repository, das Lovable synchronisiert
2. Gehe zu Einstellungen → Gehe zu Geheimnisse und Variablen → Aktionen
3. Klicken Neues Repository-Geheimnis erstellen
4. Name: CAPGO_TOKEN
5. Wert: Füge den Capgo API-Schlüssel aus Schritt 1 ein
6. Speichern

GitHub fügt das Geheimnis in Workflows ein als ${{ secrets.CAPGO_TOKEN }}. Das unten stehende Workflow liest es als die CAPGO_TOKEN Capgo CLI-Umgebungsvariable.

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

Schritt 3 — Fügen Sie diesen Prompt in Lovable ein.

Kopieren Sie den folgenden Block in den Lovable-Chat. Wenn Ihr Standardzweig nicht mainersetzten Sie main den Workflow mit Ihrem Zweignamen.

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.

Nachdem Lovable die Änderung angewendet hat, klicken Sie auf Veröffentlichen damit der Workflow auf GitHub landet.

Manuelle Alternative

Wenn Sie den Lovable-Chat nicht verwenden möchten, erstellen Sie .github/workflows/capgo-live-updates.yml mit diesem YAML nur (nicht die Anfragesätze). Anpassen Sie die Installations-/Buildschritte 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 path: Lovable Vite-Anwendungen benötigen oft base: './' in vite.config.ts damit sich die Assets innerhalb des nativen Shells laden. Wenn Benutzer nach einer OTA-Update eine weiße Seite sehen, fragen Sie Lovable, base: './'wieder zu veröffentlichen und dem Workflow erneut zu deployen.

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

Schritt 4 — Bestätige Veröffentlichung startet einen Bereitstellungsprozess

1. In Lovable, füge einen kleinen sichtbaren Änderungsvorschlag hinzu (z.B. Button-Bezeichnungstext)
2. Klicken Sie Veröffentlichen
3. Öffnen Sie auf GitHub, Aktionen und beobachten Sie Capgo Live-Updates
4. Wenn der Job grün ist, öffnen Sie Ihr Capgo Konsole und bestätigen Sie eine neue Bundle auf dem production Kanal
5. Bestätigen Sie auf einem mit der App installierten Gerät, dass die Änderung eingetroffen ist (kann je nach Einstellungen im Kanal einige Minuten dauern)

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

Hilfe

Für weitere Workflow-Muster (Funktionszweige, Pull-Request-Kanäle, Verschlüsselung), siehe Aktivierungsintegration von GitHub.

Was Sie Ihrem Kunden sagen

Senden Sie ihnen diese Liste:

1. Sie already connected Lovable to GitHub and set up Capgo on the mobile app.
2. Sie fügen einem GitHub-Geheimnis hinzu: CAPGO_TOKEN mit ihrem Capgo-API-Schlüssel (apikeys-Seite).
3. Sie klicken auf Veröffentlichen in Lovable wann immer Benutzer Änderungen erhalten sollen.
4. Sie laufen nie npx @capgo/cli lokal, es sei denn, sie wollen das.

That matches the single-click experience they asked for: Publish in Lovable is the button; GitHub Actions and Capgo handle the rest.

Fortsetzen

• Lovable in iOS und Android umwandeln — Full Capacitor + Capgo setup if you have not wrapped the app yet
• Automatic build and release with GitHub Actions — Tag-basierte Releases und Versionshüpfe
• GitHub Actions integration Page/area: Capgo-Lösungen-Marketingseite. Rolle: Website-Text. Gesehen in: Seite Lösungen/qsr.astro. Capgo-Produkt-/Marken- und Entwicklertermen bleiben genau erhalten. Nachrichtenschlüssel `solutions_qsr_sol4_point1` (Lösungen Qsr Sol4 Point1).
• Capgo Live Updates --- Kanäle, Rückschritte und Akzeptanzstatistiken