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-updateren el repo (guía de Lovable a móvil) - App registrada en Capgo con
capacitor.config.tsque apunte al correctoappId productionchannel 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
- Abrir console.capgo.app/apikeys/
- Crea una clave API con permiso para subir bundles de tu app
- 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.
- Abre el repositorio de GitHub con el que sincroniza Lovable
- Ve a Configuración → Secrets y variables → Acciones
- Haz clic Nuevo secreto de repositorio
- Nombre:
CAPGO_TOKEN - Valor: pega la clave Capgo API del Paso 1
- 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
- En Lovable, haz un cambio visible pequeño (por ejemplo, el texto de una etiqueta de botón)
- Haz clic Publicar
- En GitHub, abre Acciones y observa Live Updates de Capgo
- Cuando el trabajo esté en verde, abre tu consola de Capgo y confirma un nuevo bundle en la
productioncanal - 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:
- Usted ya conectó Lovable con GitHub y configuró Capgo en la app móvil.
- Ellos añaden un secreto de GitHub:
CAPGO_TOKENcon su clave de Capgo API (página de apikeys). - Ellos hacen clic Publicar en Lovable cuando quieren que los usuarios reciban cambios.
- Nunca ejecutan
npx @capgo/clilocalmente 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
- Convierte Lovable a iOS y Android — Configuración completa de Capacitor + Capgo si aún no has envuelto la app
- Compilación y publicación automáticas con GitHub Actions — Lanzamientos por etiquetas y actualizaciones de versión
- Integración con GitHub Actions — Canales multi y canales de vista previa de PR
- Live Updates de Capgo — Canales, rollbacks y estadísticas de adopción