Automate Capgo Actualizaciones en vivo desde Lovable con GitHub Acciones

Su cliente quiere un solo botón en Lovable que envía cambios a cada usuario activo. Ya ha probado el camino de actualización manualmente:

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

La pieza faltante no es otro comando en la terminal dentro de Lovable. Lovable no puede ejecutar Capgo en Publicación. Cuando se habilita la sincronización de GitHub: Publicación envía un commit a su repositorio. GitHub Actions ejecuta la compilación y bundle upload lo hace por usted.

Esta guía cubre la única configuración manual que su cliente debe realizar una vez: agregar CAPGO_TOKEN como un secreto de GitHub. Para el archivo de flujo de trabajo, copie y pegue la instrucción de IA lista en Lovable (Paso 3).

Cómo funciona el pipeline

Paso	Quién	What happens
1	Cliente	Edita la aplicación en Lovable y hace clic en Publish
2	Lovable	Comitea y envía a GitHub (normalmente) `main`)
3	GitHub Acciones	`npm ci`, `npm run build`, `bundle upload --auto-bump` a Capgo
4	Capgo	Dispositivos activos en el `production` canal reciben la actualización

No SSH, no CLI local, no clic adicional después de configurar el secreto.

Requisitos previos

Proyecto amable conectado a GitHub (guía de exportación)
Capacitor + @capgo/capacitor-updater en el repositorio (Guía de amable a móvil)
La aplicación registrada en Capgo con capacitor.config.ts apuntando a la canalización correcta appId
production existe y está vinculada a las compilaciones que ejecutan tus usuarios

¿Por qué? `--auto-bump`

Cada carga de Capgo requiere una nueva versión de paquete únicaAutomatice las actualizaciones en vivo de Capgo desde GitHub Actions. package.json No publica Lovable para usted, por lo que la CI fallaría en el segundo despliegue si reutiliza la misma versión.

--auto-bump Lee la versión más reciente en el canal (o aplicación) y la incrementa. El nivel predeterminado es minorUsted puede pasar --auto-bump patch o --auto-bump major ¿Qué alternativas tiene Capgo para las actualizaciones en vivo?

Step 1 — Create a Capgo API key

¿Qué alternativas tiene Capgo para las actualizaciones en vivo? console.capgo.app/apikeys/
Create an API key with permission to upload bundles for your app
¿Qué alternativas tiene Capgo para las actualizaciones en vivo?

¿Qué alternativas tiene Capgo para las actualizaciones en vivo?

Paso 2 — Agregar `CAPGO_TOKEN` en GitHub (el único paso de entorno)

Este es el paso que envías a Kuldeep y a cualquier cliente que posea el repositorio.

Abre el repositorio GitHub que Lovable sincroniza
Ir a Configuración → Secretos y variables → Acciones
Hacer clic Nueva clave secreta de repositorio
Nombre: CAPGO_TOKEN
Valor: pega la clave Capgo API de Paso 1
Guardar

GitHub inyecta el secreto en flujos de trabajo como ${{ secrets.CAPGO_TOKEN }}. El flujo de trabajo a continuación lo lee como la CAPGO_TOKEN variable de entorno para el Capgo CLI.

Si el repositorio está bajo la organización de tu cliente, deben agregar el secreto en de su repositorio. Solo necesitas la clave en GitHub, no en las configuraciones de Lovable.

Paso 3 — Pega esta solicitud en Lovable

Copia el bloque a continuación en el chat de Lovable. Si tu rama por defecto no es main, reemplaza main en el flujo de trabajo 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 Publishar entonces el flujo de trabajo aterriza en GitHub.

Alternativa manual

Si prefieres no utilizar el chat de Lovable, crea .github/workflows/capgo-live-updates.yml con este YAML solo (no la prosa del prompt). Ajusta los pasos de instalación/compilación de la misma manera que las reglas anteriores si tu proyecto difiere, 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 aplicaciones Vite de Lovable a menudo necesitan base: './' en vite.config.ts para que los activos se carguen dentro de la caja nativa. Si los usuarios ven una pantalla blanca después de una actualización OTA, pide a Lovable que establezca base: './', publica de nuevo y deja que el flujo de trabajo vuelva a desplegar.

Paquetes cifrados: If usas Capgo cifrado, agrega CAPGO_PRIVATE_KEY como una segunda GitHub secreto y pasa --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" en el paso de carga.

4. — Confirmar Publicación desencadena un despliegue

En Lovable, haz un pequeño cambio visible (por ejemplo, texto de etiqueta de botón)
Haz clic Publica
En GitHub, abre Acciones y observa Actualizaciones en vivo Capgo
Cuando el trabajo es verde, abra su Capgo consola y confirme una nueva paquete en el production canal
En un dispositivo con la aplicación instalada, confirme que el cambio llega (puede tardar un minuto dependiendo de los ajustes del canal)

✅ Éxito: Publicar en Lovable → verde GitHub Acción → nuevo paquete en Capgo → los usuarios obtienen la actualización.

Solución de problemas

Síntoma	Causa probable	Solución
Flujo nunca se ejecuta	Se hizo un push a una rama distinta de `main`	Cambio `branches` en el flujo de trabajo o publicar a `main`
`CAPGO_TOKEN` / error de autenticación	La clave secreta falta o tiene un nombre incorrecto	La clave secreta debe ser exactamente `CAPGO_TOKEN` bajo secretos de Actions
La versión ya existe	Subir reutilizó la misma versión del paquete	Mantener `--auto-bump` en el paso de subir (o pasar por `--auto-bump patch`)
Fallas de construcción en `npm ci`	Lockfile desincronizado	Ejecutar `npm install` localmente, hacer commit `package-lock.json`, publicar de nuevo
Subir con éxito, pantalla blanca	Incorrecto `webDir` o Vite `base`	Coincidir `capacitor.config.ts` `webDir` con la salida de compilación (`dist` para Vite) y establecer `base: './'`
Los usuarios no ven la actualización	El canal no está vinculado a su construcción	In Capgo, vincule la construcción del dispositivo a `production` o establezca el canal como público

Para más patrones de flujo de trabajo (ramas de características, canales de PR, cifrado), consulte GitHub integración de Actions.

¿Qué le dice a su cliente

Envíeles este checklist:

Usted ya ha conectado Lovable a GitHub y configurado Capgo en la aplicación móvil.
Ellos agreguen una GitHub secreto: CAPGO_TOKEN con su Capgo API clave (apikeys página).
Ellos Hacer clic Publicar en Lovable cada vez que deseen que los usuarios reciban cambios.
Ellos nunca se ejecutan npx @capgo/cli localmente a menos que deseen hacerlo.

Eso coincide con la experiencia de un solo clic que pidieron: Publicar en Lovable es el botón; GitHub Acciones y Capgo manejan el resto.

Siga adelante

Convertir a Lovable a iOS y Android — Configuración completa de Capacitor + Capgo si aún no has envuelto la aplicación
Compilación y lanzamiento automáticos con GitHub Acciones — Lanzamientos y actualizaciones basadas en etiquetas
GitHub Integración de acciones — Canales múltiples y vistas previas de PR
Capgo Actualizaciones en vivo — Canales, retrocesos y estadísticas de adopción

Automatice Capgo actualizaciones en vivo desde Lovable con GitHub Acciones