Automatiser les mises à jour en temps réel de Capgo avec les actions de GitHub

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

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

La pièce manquante n'est pas une autre commande de terminal à l'intérieur de Lovable. Lovable ne peut pas exécuter Capgo lors de la publication. Lorsque la synchronisation GitHub est activée, Publiez les modifications dans 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 : ajoutez CAPGO_TOKEN comme un GitHub secret. Tout le reste peut être ajouté avec un prompt Lovable ou un petit fichier de workflow.

Comment fonctionne le pipeline

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

Aucun SSH, pas de CLI local, pas de clic supplémentaire après la configuration du secret.

Prérequis

Projet Lovable connecté à GitHub (guide d'exportation)
Capacitor + @capgo/capacitor-updater dans le dépôt (Guide de l'amour pour les appareils mobiles)
L'application est enregistrée dans Capgo avec capacitor.config.ts pointant vers la bonne appId
production Le canal existe et est lié aux builds que vos utilisateurs exécutent

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

Ouvrez 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 pas à nouveau dans sa valeur complète

Traitez cette clé comme un mot de passe. Ne la commettez jamais dans Git ou ne la collez pas dans le chat de Lovable.

Étape 2 — Ajoutez `CAPGO_TOKEN` In GitHub (la seule étape de l'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.
Aller à Paramètres → Secrets et variables → Actions
Cliquez Nouveau secret de dépôt
Nom : CAPGO_TOKEN
Valeur : coller la clé Capgo API de l'étape 1
Enregistrer

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

Si le dépôt est 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 de Lovable.

Étape 3 — Ajoutez le GitHub workflow Actions

Option A — Demandez à Lovable de créer le fichier

Collez cela dans le chat Lovable (ajuste le nom de branch si votre nom par défaut n'est pas main):

Create `.github/workflows/capgo-live-updates.yml` that runs on every push to `main`:

1. Checkout code
2. Setup Node.js 24 with npm cache
3. Run `npm ci` and `npm run build`
4. Run `npx @capgo/cli@latest bundle upload --channel=production`
5. Use environment variable `CAPGO_TOKEN` from GitHub Actions secrets (do not hardcode the API key)

Use `actions/checkout@v6` and `actions/setup-node@v6`. Commit the workflow file to the repo.

Lovable ajoutera le YAML et le poussera sur la prochaine Publication.

Option B — Ajoutez le fichier vous-même

Créez .github/workflows/capgo-live-updates.yml:

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
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Commit and push. The first run starts as soon as GitHub receives the push.

Vite base chemin : Les applications Vite aimables ont souvent besoin base: './' dans vite.config.ts pour que les assets se chargent à l'intérieur du shell natif. Si les utilisateurs voient une page blanche après une mise à jour OTA, corrigez base, publiez à nouveau et laissez le flux de travail se rédeployer.

Fichiers encapsulés : Si vous utilisez Capgo encryption, ajoutez CAPGO_PRIVATE_KEY comme un deuxième secret GitHub et passez --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" à l'étape de téléchargement.

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

Dans Lovable, apportez une petite modification visible (par exemple, le texte du label du bouton)
Cliquez Publier
Ouvrez GitHub Actions et regardez Capgo Mises à jour en temps réel
Lorsque le job est vert, ouvrez votre Capgo console et confirmez une nouvelle archive sur 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 : Publier dans Lovable → vert GitHub Action → nouveau bundle dans Capgo → les utilisateurs reçoivent la mise à jour.

Résolution des problèmes

Symptôme	Cause probable	Solution
Le workflow ne s'exécute jamais	La push a été envoyée à une branche autre que `main`	Mise à jour `branches` dans le workflow ou de publication à `main`
`CAPGO_TOKEN` / erreur d'authentification	Le secret est manquant ou porte un nom incorrect	Le secret doit être exactement `CAPGO_TOKEN` sous Actions secrets
La construction échoue sur `npm ci`	Le fichier de verrouillage est hors synchronisation	Exécuter `npm install` localement, puis commiter `package-lock.json`et publier à nouveau
L'upload réussit, écran blanc	Erreur `webDir` ou Vite `base`	Match `capacitor.config.ts` `webDir` pour construire la sortie (`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 dispositif à `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.
Ils ajoutent une clé secrète GitHub : CAPGO_TOKEN avec leur Capgo API clé (page des apikeys).
Ils cliquent Publier dans Lovable chaque fois qu'ils veulent que les utilisateurs reçoivent des mises à jour.
Ils ne lancent jamais npx @capgo/cli localement à moins qu'ils ne le veuillent.

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 — Configuration complète Capacitor + Capgo si vous n'avez pas encore enveloppé l'application
Construction et publication automatique avec GitHub Actions — Lancement basé sur des tags et mises à jour de version
GitHub Actions intégration — Canaux multiples et prévisualisation de PR
Capgo Mises à jour en direct — Canaux, retours en arrière et statistiques d'adoption

Automate Capgo Mises à jour en direct de Lovable avec GitHub Actions