Automatiser les mises à jour en temps réel de Capgo avec Lovable et GitHub Actions

Votre client souhaite un seul bouton dans Lovable qui envoie les modifications à chaque utilisateur actif. Vous avez déjà prouvé que le chemin de mise à jour fonctionne manuellement :

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

La pièce manquante n'est pas une autre commande de terminal à l'intérieur de Lovable. Lovable cannot run Capgo on Publish. Lorsque la synchronisation GitHub est activée, La publication envoie un commit vers votre dépôt. GitHub Actions exécute la construction et bundle upload pour vous.

Cette guide couvre la seule configuration manuelle que votre client doit effectuer une fois : ajouter CAPGO_TOKEN comme un secret GitHub . Pour le fichier de flux de travail, copiez-coller l'instruction AI prête dans Lovable (Étape 3).

How le pipeline fonctionne

Étape	Qui	Ce qui se passe
1	Client	Édite l'application dans Lovable et clique sur Publier
2	Lovable	Commits et pousses vers GitHub (généralement `main`)
3	GitHub Actions	`npm ci`, `npm run build`, `bundle upload --auto-bump` à Capgo
4	Capgo	Appareils actifs sur le `production` recevront la mise à jour

Aucun SSH, aucune CLI, pas de clic supplémentaire après la configuration secrète.

Prerequisites

Projet Lovable connecté à GitHub (guide d'exportation)
Capacitor + @capgo/capacitor-updater dans le dépôt (guide Lovable vers mobile)
Application enregistrée dans Capgo avec capacitor.config.ts pointant vers la bonne appId
production un canal existe et est lié aux builds que vos utilisateurs exécutent

Why `--auto-bump`

Tout Capgo téléchargement nécessite un nouvelle version de bundle uniqueune nouvelle version unique de paquet package.json pour vous, afin que la CI faille lors du deuxième déploiement si vous réutilisez la même version.

--auto-bump pour vous, donc la CI échouerait au deuxième déploiement si vous réutilisez la même version. minorVous pouvez passer --auto-bump patch or --auto-bump major si vous préférez

Étape 1 — Créez une paire de clés Capgo API

Open console.capgo.app/apikeys/
Créez une clé API avec les permissions d'upload des bundles pour votre application
Copiez la clé une fois. Vous ne la verrez plus dans sa valeur complète.

Traitez cette clé comme un mot de passe. N'y commit jamais dans Git ni ne la collez dans le chat Lovable.

Étape 2 — Ajoutez `CAPGO_TOKEN` dans GitHub (la seule étape d'environnement)

C'est l'étape que vous envoyez à Kuldeep et à tout client qui possède le dépôt

Ouvrez le dépôt GitHub que Lovable synchronise
Allez à Paramètres → Secrets et variables → Actions
Cliquez Répertoire secret nouveau
Nom : CAPGO_TOKEN
Valeur : collez la clé Capgo API de l'étape 1
Enregistrer

GitHub injecte le secret dans les workflows comme ${{ secrets.CAPGO_TOKEN }}. Le workflow ci-dessous le lit comme la CAPGO_TOKEN variable d'environnement pour le Capgo CLI.

Si le dépôt se trouve sous l'organisation de votre client, ils doivent ajouter le secret sur leur dépôt. Vous n'avez besoin que de la clé dans GitHub, pas dans les paramètres Lovable.

Étape 3 — Collez cette invite dans Lovable

Copiez le bloc ci-dessous dans le chat Lovable. Si votre branch par défaut n'est pas mainremplacez main dans le workflow avec votre nom de 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.

Après que Lovable a appliqué la modification, cliquez Publier afin que le workflow se termine par GitHub.

Alternative manuelle

Si vous préférez ne pas utiliser le chat Lovable, créez .github/workflows/capgo-live-updates.yml avec ce YAML uniquement (pas la prose du prompt). Adaptsez les étapes d'installation/ de construction de la même manière que les règles ci-dessus si votre projet diffère, puis commitez et publiez.

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 chemin : Applications Vite aimables ont souvent besoin base: './' en vite.config.ts Les assets chargent à l'intérieur du shell natif. Si les utilisateurs voient une page blanche après une mise à jour OTA, demandez à Lovable de configurer base: './'républiez à nouveau, et laissez le workflow se rédeployer.

Les ensembles chiffrés : Si vous utilisez l'Capgo chiffrementajoutez CAPGO_PRIVATE_KEY comme un deuxième secret GitHub et passez --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" sur l'étape de téléchargement.

Étape 4 — Confirmer la publication déclenche un déploiement

Sur Lovable, apportez une petite modification visible (par exemple le texte du label du bouton)
Cliquez Publiez
Ouvrez GitHub. Actions et observez Capgo Live Updates
Lorsque le job est vert, ouvrez votre Capgo console et confirmer un nouveau bundle sur le production canal
Sur un appareil avec l'application installée, confirmez que la mise à jour arrive (ce qui peut prendre une minute en fonction des paramètres du canal).

✅ Succès : Publiez dans Lovable → vert GitHub Action → nouveau bundle dans Capgo → les utilisateurs obtiennent la mise à jour.

Troubleshooting

Symptôme	Cause probable	Réparation
Flux de travail ne s'exécute jamais	Push a été envoyé vers une branche autre que `main`	Modification `branches` dans le flux de travail ou de publier à `main`
`CAPGO_TOKEN` Erreur d'authentification	Secret manquant ou nom incorrect	Secret doit être exactement `CAPGO_TOKEN` sous Secrets d'Actions
Version existe déjà	Upload a la même version de bundle	Conservation `--auto-bump` sur l'étape d'upload (ou passer `--auto-bump patch`)
Échec de la construction sur `npm ci`	Lockfile hors synchronisation	Démarrez `npm install` Localement, commit `package-lock.json`publier à nouveau
L'upload est réussi, écran blanc	Wrong `webDir` ou Vite `base`	Match `capacitor.config.ts` `webDir` pour construire l'output (`dist` pour Vite) et définir `base: './'`
Les utilisateurs ne voient pas la mise à jour	Le canal n'est pas lié à leur build	Dans Capgo, reliez le build du appareil à `production` ou définissez le canal en public

Pour plus de modèles de workflow (branches de fonctionnalités, canaux PR, encryption), voir GitHub Actions intégration.

Ce que vous dites à votre client

Envoyez-leur ce checklist :

Vous déjà connecté Lovable à GitHub et configuré Capgo sur l'application mobile.
They ajoutent une clé secrète GitHub : CAPGO_TOKEN avec leur clé Capgo API (page des API).
They cliquer Publier lorsque les utilisateurs veulent recevoir des mises à jour.
Ils ne lancent jamais npx @capgo/cli localement à moins qu'ils ne le souhaitent.

Cela correspond à l'expérience d'un clic unique qu'ils ont demandé : Publier dans Lovable est le bouton ; GitHub Actions et Capgo s'occupent du reste.

Continuez

Convertir Lovable en iOS et Android — Tout le Capacitor + Capgo si vous n'avez pas encore enveloppé l'application
Construction et mise en production automatique avec GitHub Actions — Sorties basées sur des tags et mises à jour de version
GitHub Actions intégration — Canaux multiples et prévisualisation de PR
Capgo Live Updates __CAPGO_KEEP_0__ Mises à jour en direct

Automatiser les mises à jour Live de Capgo avec les actions de GitHub