Automate Capgo Aggiornamenti in tempo reale con GitHub Actions

Il tuo cliente vuole un solo pulsante in Lovable che invia le modifiche a ogni utente attivo. Hai 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 tuo repository. GitHub Actions esegue la costruzione e bundle upload per te.

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

Come funziona il pipeline

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

Requisiti preliminari

• 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 punta al canale corretto appId
• production esiste un canale e è collegato alle build che i tuoi utenti eseguono

Perché --auto-bump

Ogni caricamento di Capgo richiede una nuova versione del pacchetto univoca . Lovable Publish non incrementa automaticamente 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 Lovable chat.

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 del Passo 1
6. Salva

GitHub inserisce il segreto nei flussi di lavoro come ${{ secrets.CAPGO_TOKEN }}. Il flusso di lavoro sotto legge il suo valore come l' CAPGO_TOKEN variabile di ambiente per il Capgo CLI.

Se il repository è sotto l'organizzazione del tuo cliente, loro devono aggiungere il segreto sul loro repository. Hai bisogno solo della chiave in GitHub, non in impostazioni Lovable.

Passo 3 — Incolla questo prompt in Lovable

Copia il blocco sotto nella chat Lovable. Se il tuo branch predefinito non è main, sostituisci main in il flusso di lavoro con il nome del tuo 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 workflow si ferma su GitHub.

Alternativa manuale

Se preferisci non utilizzare il Lovable chat, 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: Il Lovable applicazioni Vite spesso richiedono base: './' in vite.config.ts così che 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 you use Capgo encryption, aggiungi CAPGO_PRIVATE_KEY come un secondo segreto GitHub e passa --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" nel passo di caricamento.

Passo 4 — Conferma pubblicazione attiva un deploy

1. In Lovable, fai una piccola modifica visibile (ad esempio il testo del pulsante di etichetta)
2. Clicca Pubblica
3. Sul GitHub, apri azioni e guarda 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 Azione → 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 di 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 gli utenti desiderano ricevere 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 incrementi di versione
• GitHub Integrazione con Actions Page/area: Soluzioni di Capgo, ruolo: testo del sito web, visto in: pagina soluzioni/qsr.astro. Preservare i termini di prodotto e marchio di Capgo esattamente. Chiave del messaggio `solutions_qsr_sol4_point1` (Soluzioni Qsr Sol4 Point1).
• Capgo Live Updates __CAPGO_KEEP_0__ Aggiornamenti in tempo reale