Automate gli aggiornamenti Capgo da Lovable con GitHub azioni

Vostro cliente desidera un singolo pulsante in Lovable che invia modifiche a ogni utente attivo. Avete già dimostrato che il percorso di 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 alla pubblicazione. Quando GitHub sincronizzazione è abilitata, La pubblicazione invia un commit al vostro repository. GitHub azioni eseguono la costruzione e bundle upload per voi.

Questa guida copre la configurazione manuale che il tuo cliente deve eseguire una volta: aggiungere CAPGO_TOKEN come un segreto GitHub. Per il file di flusso di lavoro, incolla l'istruzione AI pronta in Lovable (Passo 3).

How il pipeline funziona

Passo	Chi	Cosa succede
1	Cliente	Modifica l'app in Lovable e clicca su Pubblica
2	Lovable	Commessi e push a GitHub (di solito `main`)
3	GitHub (di solito	`npm ci`, `npm run build`, `bundle upload --auto-bump` Capgo Actions
4	su Capgo	Dispositivi attivi sul `production` il canale ricevono l'aggiornamento

Nessun SSH, nessun CLI, nessun clic extra dopo che la chiave segreta è configurata.

Prerequisiti

Progetto Lovable collegato a GitHub (guida all'esportazione)
Capacitor + @capgo/capacitor-updater nel repository (guida da Lovable a mobile)
L'app registrata in Capgo con capacitor.config.ts che punta al canale corretto appId
production il canale esiste e è collegato alle build che i tuoi utenti eseguono

Why `--auto-bump`

Tutti gli upload di Capgo richiedono una nuova versione univoca del pacchetto. Lovable Publish non aumenta automaticamente la versione, package.json così che il CI fallirebbe al secondo deploy se si utilizzasse la stessa versione.

--auto-bump Legge la versione più recente sul canale (o applicazione) 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

Apri console.capgo.app/apikeys/
Creare una chiave API con le autorizzazioni per caricare i pacchetti per il tuo'app
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 Lovable chat

Step 2 — Aggiungi `CAPGO_TOKEN` nel GitHub (l'unico passo ambiente)

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

Apre il repository GitHub sincronizzato da Lovable
Vai a Impostazioni → Segreti e variabili → Azioni
Clicca Nuovo segreto repository
Nome: CAPGO_TOKEN
Valore: incolla la chiave Capgo API dal passaggio 1
Salva

GitHub immette il segreto nei flussi di lavoro come ${{ secrets.CAPGO_TOKEN }}Il workflow riportato di seguito lo legge come il CAPGO_TOKEN variabile di ambiente per il Capgo CLI.

repository. Hai bisogno solo della chiave in __CAPGO_KEEP_0__, non in impostazioni Lovable. their repository. È necessario solo la chiave in GitHub, non nei impostazioni di Lovable.

Step 3 — Incolla questo prompt in Lovable

Copia il blocco sotto nella chat Lovable. Se la tua branch predefinita non è maine sostituisci main Nell'ambiente di lavoro con il nome della tua branch.

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.

Dopo che Lovable applica il cambiamento, clicca Pubblica così il flusso di lavoro si ferma su GitHub.

Alternativa manuale

Se preferisci non utilizzare il chat di Lovable, crea .github/workflows/capgo-live-updates.yml con questo YAML solo (non il testo della richiesta). 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: Le app Vite di Lovable spesso richiedono 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 reimmettere base: './'pubblica nuovamente e lascia che il workflow si ripubblichi.

Bundle criptati: Se utilizzi Capgo crittografiaaggiungi CAPGO_PRIVATE_KEY come un secondo segreto GitHub e passa --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" nel passaggio di caricamento.

Passo 4 — Conferma pubblicazione attiva un deploy

Fai una piccola modifica visibile (ad esempio il testo del pulsante)
Click Publish
On GitHub, apri azioni e guarda Capgo Aggiornamenti in tempo reale
Quando il lavoro è verde, apri Capgo console e confermare un nuovo bundle sul production channel
Confermare il cambiamento sul dispositivo con l'app installata (potrebbe richiedere un minuto a seconda delle impostazioni del canale).

✅ Success: Pubblica in Lovable → verde GitHub Azione → nuovo bundle in Capgo → gli utenti ricevono l'aggiornamento.

Troubleshooting

Sintomo	Causa probabile	Soluzione
Flusso non eseguito	La push è andata su una branca diversa da `main`	Modifica `branches` nel flusso di lavoro o pubblica su `main`
`CAPGO_TOKEN` Errore di autenticazione	Segreto mancante o nome sbagliato	Il segreto deve essere esattamente `CAPGO_TOKEN` sotto Segreti di Actions
La versione esiste già	Carica ripreso la stessa versione del pacchetto	Conserva `--auto-bump` nel passo di caricamento (o passa `--auto-bump patch`)
Fallisce la costruzione su `npm ci`	Lockfile fuori sincronia	Esegui `npm install` localmente, commit `package-lock.json`Esegui localmente, commit
, pubblica nuovamente	Wrong `webDir` Errato `base`	o Vite `capacitor.config.ts` `webDir` per costruire l'output (`dist` per Vite) e impostare `base: './'`
Gli utenti non vedono l'aggiornamento	Canale non collegato alla loro build	In Capgo, collega la build del dispositivo a `production` o impostare il canale come pubblico

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

Cosa raccontate ai vostri clienti

Inviagli questo checklist:

Tu già collegato Lovable a GitHub e impostato Capgo sull'app mobile.
Essi aggiungono un segreto GitHub: CAPGO_TOKEN con la loro Capgo API chiave (pagina apikeys).
Essi clicca Pubblica in Lovable ogni volta che desiderano che gli utenti ricevano le modifiche.
Non eseguono mai npx @capgo/cli localmente a meno che non lo vogliano.

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

Continua

Converti Lovable in iOS e Android — Configurazione completa Capacitor + Capgo se non hai ancora avvolto l'app
Costruzione e rilascio automatico con GitHub Actions — Rilasci e aumenti di versione basati su tag
GitHub Actions di integrazione — Canali multi-canale e canali di anteprima di PR
Capgo Live Updates __CAPGO_KEEP_0__ Aggiornamenti in tempo reale