Saltar al contenido principal
CI/CD

Automatiza Capgo Live Updates desde Lovable con GitHub Actions

Publica desde Lovable a producción con un clic: sincroniza con GitHub, guarda tu clave Capgo API como secreto y deja que GitHub Actions construya y suba en cada push.

Automatiza Capgo Live Updates desde Lovable con GitHub Actions Capgo ilustración de blog

Tu cliente quiere un solo botón en Lovable para enviar cambios a todos los usuarios activos. Ya comprobaste que el flujo de actualización funciona manualmente:

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

Lo que falta no es otro comando de terminal dentro de Lovable. Lovable no puede ejecutar Capgo al publicar. Cuando la sincronización de GitHub está activada, Publish envía un commit a tu repo. GitHub Actions ejecuta el build y bundle upload por ti.

Esta guía cubre la única configuración manual que tu cliente debe hacer una vez: añadir CAPGO_TOKEN como un secreto de GitHub. Para el archivo de workflow, copia y pega la instrucción de IA lista en Lovable (Paso 3).

Cómo funciona el pipeline

Paso Quién Qué sucede
1 Cliente Edita la app en Lovable y hace clic en Publicar
2 Lovable Hace commit y push a GitHub (normalmente main)
3 Acciones de GitHub npm ci, npm run build, bundle upload --auto-bump a Capgo
4 Capgo Los dispositivos activos en el production canal reciben la actualización

Sin SSH, sin CLI local, sin clics extra tras configurar el secreto.

Requisitos

  • Proyecto de Lovable conectado a GitHub (guía de exportación)
  • Capacitor + @capgo/capacitor-updater en el repo (guía de Lovable a móvil)
  • App registrada en Capgo con capacitor.config.ts que apunte al correcto appId
  • production channel correcto que existe y está vinculado a los builds que ejecutan tus usuarios

Por qué --auto-bump

Cada upload de Capgo requiere una nueva versión de bundle única. Lovable Publish no incrementa package.json para ti, así el CI fallaría en el segundo deploy si reutilizas la misma versión.

--auto-bump lee la última versión del channel (o app) y la incrementa. El nivel por defecto es minor. Puedes pasar --auto-bump patch o --auto-bump major si lo prefieres.

Paso 1 — Crea una clave Capgo API

  1. Abrir console.capgo.app/apikeys/
  2. Crea una clave API con permiso para subir bundles de tu app
  3. Copia la clave una sola vez. No volverás a ver el valor completo

Trata esta clave como una contraseña. Nunca la subas a Git ni la pegues en el chat de Lovable.

Paso 2 — Añadir CAPGO_TOKEN en GitHub (el único paso de env)

Este es el paso que envías a Kuldeep y a cualquier cliente que sea dueño del repo.

  1. Abre el repositorio de GitHub con el que sincroniza Lovable
  2. Ve a Configuración → Secrets y variables → Acciones
  3. Haz clic Nuevo secreto de repositorio
  4. Nombre: CAPGO_TOKEN
  5. Valor: pega la clave Capgo API del Paso 1
  6. Guardar

GitHub inyecta el secreto en los workflows como ${{ secrets.CAPGO_TOKEN }}. El siguiente workflow lo lee como la CAPGO_TOKEN variable de entorno para Capgo CLI.

Si el repo está bajo la organización de tu cliente, deben añadir el secret en su repo. Solo necesitas la clave en GitHub, no en la configuración de Lovable.

Paso 3 — Pega este prompt en Lovable

Copia el bloque siguiente en el chat de Lovable. Si tu rama predeterminada no es main, reemplaza main en el workflow con el nombre de tu rama.

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.

Después de que Lovable aplique el cambio, haz clic Publicar para que el workflow llegue a GitHub.

Alternativa manual

Si prefieres no usar el chat de Lovable, crea .github/workflows/capgo-live-updates.yml solo con este YAML (no con el texto del prompt). Adapta los pasos de instalación/build de la misma forma que las reglas anteriores si tu proyecto difiere, y luego haz commit y push.

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 ruta: Las apps de Vite de Lovable a menudo necesitan base: './' en vite.config.ts para que los assets se carguen dentro del shell nativo. Si los usuarios ven una pantalla en blanco tras una actualización OTA, pide a Lovable que configure base: './', vuelve a publicar y deja que el workflow vuelva a desplegar.

Bundles cifrados: Si usas Cifrado de Capgo, añade CAPGO_PRIVATE_KEY como un segundo secreto de GitHub y pásalo --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" en el paso de upload.

Paso 4 — Confirma que Publish dispara un deploy

  1. En Lovable, haz un cambio visible pequeño (por ejemplo, el texto de una etiqueta de botón)
  2. Haz clic Publicar
  3. En GitHub, abre Acciones y observa Live Updates de Capgo
  4. Cuando el trabajo esté en verde, abre tu consola de Capgo y confirma un nuevo bundle en la production canal
  5. En un dispositivo con la app instalada, confirma que el cambio llega (puede tardar un minuto según la configuración del canal)

✅ Éxito: Publicar en Lovable → Action GitHub en verde → nuevo bundle en Capgo → los usuarios reciben la actualización.

Solución de problemas

Síntoma Causa probable Solución
El workflow nunca se ejecuta El push se hizo a una rama distinta de main Cambio branches en el workflow o publicar en main
CAPGO_TOKEN / error de auth Secret ausente o nombre incorrecto El secret debe ser exactamente CAPGO_TOKEN en Actions secrets
La versión ya existe El upload reutilizó la misma versión del bundle Mantén --auto-bump en el paso de upload (o pasa --auto-bump patch)
El build falla en npm ci Lockfile desincronizado Ejecuta npm install localmente, haz commit package-lock.json, vuelve a publicar
Subida correcta, pantalla en blanco Incorrecto webDir o Vite base Coincidir capacitor.config.ts webDir con el output de build (dist para Vite) y configura base: './'
Los usuarios no ven la actualización El Channel no está vinculado a su build En Capgo, vincula el build del dispositivo a production o configura el channel como público

Para más patrones de workflow (feature branches, PR channels, cifrado), consulta Integración con GitHub Actions.

Lo que le dices a tu cliente

Envíales esta lista de verificación:

  1. Usted ya conectó Lovable con GitHub y configuró Capgo en la app móvil.
  2. Ellos añaden un secreto de GitHub: CAPGO_TOKEN con su clave de Capgo API (página de apikeys).
  3. Ellos hacen clic Publicar en Lovable cuando quieren que los usuarios reciban cambios.
  4. Nunca ejecutan npx @capgo/cli localmente a menos que quieran.

Coincide con la experiencia de un solo clic que pedían: Publicar en Lovable es el botón; GitHub Actions y Capgo se encargan del resto.

Continuar

Live updates para apps Capacitor

Cuando un bug de la capa web está en producción, publica el fix a través de Capgo en lugar de esperar días a la aprobación de la app store. Los usuarios reciben la actualización en segundo plano mientras los cambios nativos siguen el flujo de revisión habitual.

Lo último de nuestro blog

Capgo te da la información clave que necesitas para crear una app móvil realmente profesional.