Automate Capgo Actualizaciones en vivo desde Lovable con GitHub Acciones

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

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

La pieza faltante no es otro comando de terminal dentro de Lovable. Lovable no puede ejecutar Capgo en Publicación. Cuando GitHub sincronización está habilitada, Publica un commit a tu repositorio. GitHub Acciones ejecuta la compilación y bundle upload para ti.

Esta guía cubre la única configuración manual que tu cliente debe realizar una vez: agregar CAPGO_TOKEN como un GitHub secreto. Todo lo demás se puede agregar con una solicitud de Lovable o un pequeño archivo de flujo de trabajo.

Cómo funciona el pipeline

Sin SSH, sin CLI local, sin clic adicional después de configurar el secreto.

Requisitos previos

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

Paso 1 — Crea una Capgo API clave

1. Abrir consola.capgo.app/apikeys/
2. Crea una API clave con permiso para subir paquetes para tu aplicación
3. Copia la clave una vez. No verás el valor completo de nuevo

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

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

Este es el paso que se envía a Kuldeep y a cualquier cliente que propietario del repositorio.

1. Abra el repositorio GitHub que Lovable sincroniza
2. Vaya a Ajustes → Secretos y variables → Acciones
3. Haga clic Nuevo secreto de repositorio
4. Nombre: CAPGO_TOKEN
5. Valor: pegue la Capgo API clave de Step 1
6. Guardar

GitHub inyecta la clave secreta en flujos de trabajo como ${{ secrets.CAPGO_TOKEN }}. El flujo de trabajo a continuación la 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 la clave secreta en su repositorio. Solo necesitas la clave en GitHub, no en ajustes de Lovable.

Paso 3 — Agregar el GitHub flujo de trabajo de Acciones

Opción A — Preguntar a Lovable que cree el archivo

Pegar esto en el chat de Lovable (ajustar el nombre de rama si tu default no es 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 agregará el YAML y lo empujará en la próxima Publicación.

Opción B — Agregar el archivo tú mismo

Crear .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 y envía. La primera ejecución comienza tan pronto como GitHub reciba el envío.

Vite base ruta: Las aplicaciones Vite agradables a menudo necesitan base: './' en vite.config.ts así que los activos se cargan dentro del concha nativa. Si los usuarios ven una pantalla blanca después de una actualización OTA, corrige base, publica de nuevo y deja que el flujo de trabajo vuelva a desplegar.

Paquetes cifrados: Si utilizas Capgo cifrado, agrega CAPGO_PRIVATE_KEY como un segundo GitHub secreto y pasa --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" en el paso de carga.

Paso 4 — Confirmar Publicación desencadena un despliegue

1. En Lovable, haz un pequeño cambio visible (por ejemplo, texto de etiqueta de botón)
2. Hacer clic Publicar
3. Abre GitHub Acciones y observa Capgo Actualizaciones en vivo
4. Cuando el trabajo está verde, abre tu Capgo consola y confirma una nueva paquetería en production canal
5. 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

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

Lo que le dice a su cliente

Envíeles este checklist:

1. Usted ya están conectados a Lovable a GitHub y han configurado Capgo en la aplicación móvil.
2. Ellos agregan una GitHub clave secreta: CAPGO_TOKEN con su Capgo API clave (página de apikeys).
3. Ellos hacen clic Publicar en Lovable cada vez que desean que los usuarios reciban cambios.
4. Nunca ejecutan npx @capgo/cli localmente a menos que deseen.

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

Sigue adelante

• Convertir Lovable a iOS y Android — Configuración completa de Capacitor + Capgo si aún no has envuelto la aplicación
• Generación y publicación automática con GitHub Actions — Lanzamientos basados en etiquetas y actualizaciones de versión
• Integración de GitHub Actions — Canales múltiples y vistas previas de PR
• Capgo Live Updates — Canales, retrocesos y estadísticas de adopción