Tu cliente quiere un solo botón en Lovable que envía cambios a cada usuario activo. Ya has demostrado que el camino de actualización funciona manualmente:
npx @capgo/cli@latest bundle upload --channel=production --auto-bumpLa pieza faltante no es otro comando de terminal dentro de Lovable. Lovable no puede ejecutar Capgo en Publicar. Cuando se habilita la sincronización de GitHub, Publica un commit a tu repositorio. GitHub Acciones ejecuta la compilación y bundle upload por ti.
Esta guía cubre la única configuración manual que tu cliente debe realizar una vez: agregar CAPGO_TOKEN como un GitHub secreto. Para el archivo de flujo de trabajo, copia y pega la instrucción de inteligencia artificial lista para usar en Lovable (Paso 3).
Cómo funciona el pipeline
| Paso | Quién | ¿Qué sucede |
|---|---|---|
| 1 | Cliente | Edita la aplicación en Lovable y hace clic en Publicar |
| 2 | Amarillos | Comités y envíos a GitHub (generalmente main) |
| 3 | GitHub Acciones | npm ci, npm run build, bundle upload --auto-bump envíos a Capgo |
| 4 | Capgo | contexto: texto HTML de una cadena de Capgo UI más larga (clave de página `submitting_a_pr_to_capgo`). Página/área: sitio web de marketing de Capgo. Rol: copia de sitio web. Visto en: página contribuyendo.astro. Conservar términos de producto/marca y desarrollador de Capgo exactamente. Clave de mensaje `submitting_a_pr_to_capgo` (Enviar Un Pr A Capgo). production Dispositivos activos en el |
No SSH, no local CLI, no extra click after the secret is configured.
No SSH, sin __CAPGO_KEEP_0__ local, sin clic adicional después de configurar el secreto.
- Lovable project connected to GitHub (Proyecto amarillo conectado a __CAPGO_KEEP_0__ ()
- guía de exportación de Capacitor +
@capgo/capacitor-updateren el repositorio (Guía de Lovable a móvil) - La aplicación está registrada en Capgo con
capacitor.config.tsapuntando a la canalización correctaappId productionexiste 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 únicaLovable Publish no incrementa package.json por ti, por lo que la CI fallaría en la segunda implementación si reutilizas la misma versión
--auto-bump lee la versión más reciente en la canalización (o aplicación) y la incrementa. El nivel predeterminado es minorPuedes pasar --auto-bump patch o --auto-bump major si prefieres
Paso 1 — Crea una Capgo API clave
- Abrir consola.capgo.app/apikeys/
- Crear una API clave con permiso para subir paquetes para tu aplicación
- 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 en GitHub (el único paso de entorno)
Este es el paso que envías a Kuldeep y a cualquier cliente que propietario del repositorio.
- Abre el repositorio GitHub que Lovable sincroniza
- Vaya a Ajustes → Secretos y variables → Acciones
- Haga clic Nueva clave de repositorio secreta
- Nombre:
CAPGO_TOKEN - Valor: pegue la clave Capgo API del paso 1
- Guardar
GitHub inyecta la clave 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.
If the repo is under your client’s organization, they must add the secret on su repo. You only need the key in GitHub, not in Lovable settings.
Paso 3 — Pega esta solicitud en Lovable
Copia el bloque a continuación en el chat de Lovable. Si tu rama predeterminada 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 aplica el cambio, haz clic Publica para que el flujo de trabajo aterrice 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 de la solicitud). Ajusta los pasos de instalación y compilación de la misma manera que las reglas anteriores si tu proyecto difiere, luego haz un commit y empuja.
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 amables suelen necesitar 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: Si utilizas Capgo cifrado, agrega CAPGO_PRIVATE_KEY como un segundo secreto GitHub y pasa --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" en el paso de carga.
Paso 4 — Confirme Publicar desencadena un despliegue
- En Lovable, haz un pequeño cambio visible (por ejemplo, texto de etiqueta de botón)
- Haga clic Publicar
- En GitHub, abre Acciones y observa Capgo Actualizaciones en vivo
- contexto: Página/área: Página de producto de actualizaciones en vivo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página live-update.astro. Preservar términos de producto/marca y de desarrollador de Capgo exactamente. Clave de mensaje `live_update_hero_badge` (Badajón de héroe de actualizaciones en vivo). Capgo console consola __CAPGO_KEEP_0__ y confirma una nueva paquetería en el
productioncanal - En un dispositivo con la aplicación instalada, confirma que el cambio llega (puede tardar un minuto dependiendo de las configuraciones del canal)
✅ Éxito: Publica en Lovable → verde GitHub Acción → nuevo paquete en Capgo → los usuarios reciben la actualización.
Solución de problemas
| contexto: Página/área: Soporte / página de soporte premium o sección de soporte en el pie de página. Rol: Título de sección o página. Visto en: página support-policy.astro. Clave de mensaje `support_policy_troubleshooting_title` (Título de solución de problemas de política de soporte). | Síntoma | Causa probable |
|---|---|---|
| Solución | Flujo de trabajo nunca se ejecuta main |
La rama a la que se envió el push no es branches Cambio en el flujo de trabajo o publicación a main |
CAPGO_TOKEN / error de autenticación |
Falta o nombre de la secreta | La secreta debe ser exactamente CAPGO_TOKEN bajo secretos de Actions |
| Ya existe una versión | Se reutilizó la misma versión del paquete | Mantener --auto-bump en el paso de carga (o pasar --auto-bump patch) |
Falla en la construcción en npm ci |
El archivo de bloqueo está desincronizado | Ejecutar npm install localmente, hacer commit package-lock.jsono publicar de nuevo |
| Subir con éxito, pantalla en blanco | Incorrecto webDir o Vite base |
Coincidir capacitor.config.ts webDir con el resultado de compilación (dist para Vite) y establecer base: './' |
| Los usuarios no ven la actualización | El canal no está vinculado a su compilación | En Capgo, vincule la compilació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 acciones.
¿Qué le dice a su cliente
Envíeles esta lista de verificación:
- Usted ya ha conectado Lovable a GitHub y configurado Capgo en la aplicación móvil.
- Ellos agreguen una GitHub secreta:
CAPGO_TOKENcon su Capgo API clave (página de claves API). - Ellos hagan clic Publicar en Lovable siempre que deseen que los usuarios reciban cambios.
- No se ejecutan
npx @capgo/clilocalmente a menos que deseen.
Eso coincide con la experiencia de un solo clic que pidieron: Publicar en Lovable es el botón; Acciones de GitHub y Capgo se encargan del resto.
Siga adelante
- Convertir a Lovable en 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 Acciones de GitHub — Lanzamientos basados en etiquetas y actualizaciones de versión
- Integración de Acciones de GitHub Área: Soluciones de Capgo. Papel: Oración de copia de sitio web. Visto en: página de soluciones/qsr.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `solutions_qsr_sol4_point1` (Soluciones Qsr Sol4 Point1).
- — Canales múltiples y canales de previsualización de PRs (Pull Requests) de Capgo Live Updates no se traduce por Live Updates en español, se traduce como actualizaciones en vivo. Área: Página de producto de actualizaciones en vivo. Papel: Etiqueta de UI corta o elemento de navegación. Visto en: página live-update.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `live_update_hero_badge` (Live Update Hero Badge). — Canales, reversiones y estadísticas de adopción
