Automate Capgo Aggiornamenti in tempo reale con GitHub Actions

Vostro cliente vuole un solo pulsante in Lovable che invia le modifiche a ogni utente attivo. Avete già dimostrato che il percorso dell'aggiornamento funziona manualmente:

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

La parte mancante non è un altro comando del terminale all'interno di Lovable. Lovable non può eseguire Capgo all'atto della pubblicazione. Quando GitHub sincronizzazione è abilitata, La pubblicazione invia un commit al vostro repository. GitHub Actions esegue la costruzione e bundle upload per voi.

Questa guida copre la sola configurazione manuale che il vostro cliente deve eseguire una volta: aggiungere CAPGO_TOKEN come un segreto GitHub. Per il file di workflow, copiate e incollate l'istruzione AI pronta in Lovable (Step 3).

Come funziona il pipeline

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

Requisiti

• Progetto Lovable collegato a GitHub (guida all'esportazione)
• Capacitor + @capgo/capacitor-updater nel repository (Guida Lovable a mobile)
• L'app registrata in Capgo con capacitor.config.ts che punti verso la canale corretta appId
• production esiste e è collegata alle build che i tuoi utenti eseguono

Perché --auto-bump

Ogni caricamento di Capgo richiede una nuova versione del pacchetto univoca. Lovable Publish non aumenta package.json per te, quindi il CI fallirebbe al secondo deploy se riutilizzi la stessa versione.

--auto-bump legge la versione più recente sul canale (o app) e la incrementa. Il livello predefinito è minor. Puoi passare --auto-bump patch o --auto-bump major se preferisci.

Passo 1 — Crea una chiave Capgo API

1. Apre console.capgo.app/apikeys/
2. Crea una chiave API con le autorizzazioni per caricare i pacchetti per la tua app
3. Copia la chiave una volta. Non vedrai il valore completo di nuovo

Tratta questa chiave come una password. Non commetterla mai in Git o incollarla nel chat di Lovable.

Passo 2 — Aggiungi CAPGO_TOKEN in GitHub (l'unico passo di ambiente)

Questo è il passo che invii a Kuldeep e a ogni cliente che possiede il repository.

1. Aprite il repository GitHub che Lovable sincronizza
2. Vai a Impostazioni → Segreti e variabili → Azioni
3. Clicca Nuovo segreto repository
4. Nome: CAPGO_TOKEN
5. Valore: incolla la chiave Capgo API da Passo 1
6. Salva

GitHub inserisce il segreto nei flussi di lavoro come ${{ secrets.CAPGO_TOKEN }}. Il flusso di lavoro sotto legge come variabile di ambiente per il __CAPGO_KEEP_0__ __CAPGO_KEEP_1__. CAPGO_TOKEN environment variable for the Capgo CLI.

loro repository. Hai bisogno solo della chiave in __CAPGO_KEEP_0__, non nei Lovable settings. repo. You only need the key in GitHub, not in Lovable settings.

Copia il blocco sotto nei Lovable chat. Se il tuo branch predefinito non è

, sostituisci mainin il flusso di lavoro con il nome del tuo branch. main Dopo che Lovable applica il cambiamento, clicca

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.

Salva Pubblica così il workflow atterra su GitHub.

Alternativa manuale

Se preferisci non utilizzare il Lovable chat, crea .github/workflows/capgo-live-updates.yml con questo YAML solo (non il prosa del prompt). Adatta i passaggi di installazione/costruzione nello stesso modo delle regole sopra se il tuo progetto differisce, quindi commetta e pubblica.

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 percorso: Il Lovable Vite spesso richiede base: './' in vite.config.ts così i file caricano all'interno della shell nativa. Se gli utenti vedono uno schermo bianco dopo un aggiornamento OTA, chiedi a Lovable di impostare base: './', pubblica nuovamente e lascia che il workflow ripubblichi.

Pacchetti crittografati: If utilizzate Capgo encryption, aggiungete CAPGO_PRIVATE_KEY come un secondo segreto GitHub e passate --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" nel passo di caricamento.

Passo 4 — Conferma pubblicazione attiva un deploy

1. In Lovable, apportate una piccola modifica visibile (ad esempio il testo del pulsante di etichetta)
2. Cliccate Pubblica
3. Sul GitHub, aprire azioni e guardate Capgo Aggiornamenti in tempo reale
4. Quando il lavoro è verde, apri il tuo Capgo console e conferma una nuova raccolta sul production canale
5. Sul dispositivo con l'app installata, conferma che il cambiamento arrivi (potrebbe richiedere un minuto a seconda delle impostazioni del canale)

✅ Successo: Pubblica in Lovable → verde GitHub Action → nuova raccolta in Capgo → gli utenti ricevono l'aggiornamento.

Risolvere i problemi

Per ulteriori modelli di workflow (rami feature, canali PR, crittografia), vedi GitHub integrazione Actions.

Quello che racconti al tuo cliente

Inviagli questo checklist:

1. Tu già collegato Lovable a GitHub e configurato Capgo sull'app mobile.
2. Loro aggiungono un segreto GitHub: CAPGO_TOKEN con la loro Capgo API chiave (pagina delle chiavi API).
3. Essi cliccano Pubblica in Lovable ogni volta che desiderano che gli utenti ricevano le modifiche.
4. Essi non eseguono mai npx @capgo/cli localmente a meno che non lo desiderino.

Ciò corrisponde all'esperienza di un solo clic che hanno richiesto: Pubblica in Lovable è il pulsante; GitHub Azioni e Capgo si occupano del resto.

Continua

• Converti Lovable in iOS e Android — Configurazione completa di Capacitor + Capgo se non hai ancora avvolto l'app
• Costruzione e rilascio automatico con GitHub Azioni — Rilasci basati su tag e aumenti di versione
• GitHub Integrazione con le azioni — Canali multipli e anteprime dei canali PR
• Capgo Aggiornamenti in tempo reale — Canali, annullamenti e statistiche di adozione