Automate Capgo Actualizaciones en vivo desde Lovable con GitHub Acciones

Su cliente quiere un solo botón en Lovable que envíe cambios a cada usuario activo. Ya probó 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 en tu repositorio. GitHub Acciones ejecuta la compilación y bundle upload para ti.

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

Cómo funciona el pipeline

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

Requisitos previos

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

Paso 1 — Crea una Capgo API clave

1. Abrir console.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 o 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 (ajusta el nombre de rama si tu rama predeterminada 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 }}

Haz el commit y empuja. La primera ejecución comienza tan pronto como GitHub recibe el empuje.

Vite base ruta: Las aplicaciones Vite agradables a menudo necesitan base: './' dentro vite.config.ts de modo que los activos se carguen 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 secreto GitHub y pasa --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" On el paso de carga.

Step 4 — Confirma Publicación desencadena un despliegue

1. Haga un pequeño cambio visible en Lovable (por ejemplo, el texto del etiqueta de botón)
2. Haga clic Publica
3. En GitHub, abra Acciones y observe Capgo Actualizaciones en vivo
4. Cuando el trabajo esté verde, abra su Capgo consola y confirme una nueva paquete en el production canal
5. En un dispositivo con la aplicación instalada, confirma que la actualización llega (puede tardar un minuto dependiendo de los ajustes del canal)

✅ Éxito: Publica en Lovable → verde GitHub Acción → nuevo paquete en Capgo → los usuarios reciben 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 manejan el resto.

Sigue adelante

• Convertir a Lovable a iOS y Android — Configuración completa de Capacitor + Capgo si aún no has envuelto la aplicación
• Generación y liberació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
• Actualizaciones en vivo de Capgo — Canales, retrocesos y estadísticas de adopción