Automatice 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 probó 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 Publicar. Cuando se habilita la sincronización de GitHub Publicar envía un commit a su repositorio. GitHub Actions ejecuta la compilación y bundle upload por usted.

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

Cómo funciona el pipeline

No SSH, no CLI local, no 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 Lovable a móvil)
• La aplicación registrada en Capgo con capacitor.config.ts apuntando al canal correcto appId
• production El canal existe y está vinculado a las compilaciones que ejecutan tus usuarios

Why --auto-bump

Todas las subidas de Capgo requieren una versión de paquete única nueva. Lovable Publish no incrementa package.json por ti, por lo que la CI fallaría en el segundo despliegue si reutilizas 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 minor. Puedes pasar --auto-bump patch o --auto-bump major si prefieres

Paso 1 — Crea una clave Capgo API

1. Open console.capgo.app/apikeys/
2. Crear una API clave con permiso para subir paquetes para tu aplicación
3. Copiar 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

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

Esta es la etapa que envías a Kuldeep y a cualquier cliente que propietario del repositorio

1. Abre el repositorio GitHub que Lovable sincroniza
2. Ir a Ajustes → Secretos y variables → Acciones
3. Hacer clic Nuevo repositorio secreto
4. Nombre: CAPGO_TOKEN
5. Valor: pegar la Capgo API clave desde el paso 1
6. 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 su repositorio. Solo necesitas la clave en GitHub, no en configuraciones de Lovable.

Paso 3 — Pegar esta prompeta en Lovable

Copiar el bloque a continuación en el chat de Lovable. Si tu rama por defecto no es main, reemplaza main con tu nombre de rama en el flujo de trabajo.

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 aplica el cambio, haz clic Publica así que 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 solo YAML (no la prosa de la solicitud). Ajusta los pasos de instalación y construcció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 Los activos se cargan dentro de la shell nativa. Si los usuarios ven una pantalla blanca después de una actualización OTA, pida a Lovable que configure base: './'y permita que el flujo de trabajo vuelva a desplegar.

Paquetes cifrados: Si utiliza Capgo cifradoagregue CAPGO_PRIVATE_KEY como una segunda clave secreta GitHub y pase --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" en el paso de carga.

Paso 4 — Confirme Publicar desencadena un despliegue

1. Hág un pequeño cambio visible (por ejemplo, texto de etiqueta de botón)
2. Click Publish
3. On GitHub, abra Acciones y observa Capgo Actualizaciones en vivo
4. Cuando el trabajo está verde, abre Capgo consola y confirmar un nuevo paquete en el production channel
5. En un dispositivo con la aplicación instalada, confirme que el cambio llega (puede tardar un minuto dependiendo de las configuraciones del canal).

✅ Success: Publica en Lovable → verde GitHub Acción → nuevo paquete en Capgo → los usuarios obtienen la actualización.

Troubleshooting

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

¿Qué le explican a su cliente

Lo que le dice a su cliente

1. You Usted ya ha conectado Lovable a GitHub y configurado Capgo en la aplicación móvil.
2. Ellos agregan un secreto GitHub: CAPGO_TOKEN con su Capgo API clave (página de apikeys).
3. Ellos haz clic Publica en Lovable cada vez que deseen que los usuarios reciban cambios.
4. Jamás ejecutan npx @capgo/cli localmente a menos que deseen hacerlo.

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

Sigue adelante

• Convertir Lovable a iOS y Android — Completa configuración de Capacitor + Capgo si aún no has envuelto la aplicación
• Automatización de compilación y lanzamiento con Acciones de GitHub — Lanzamientos y actualizaciones basados en etiquetas
• GitHub Actions de integración — Canales múltiples y canales de vista previa de PR
• Capgo Live Updates __CAPGO_KEEP_0__ Actualizaciones en vivo