Lingo.dev mantiene las traducciones sincronizadas con tu código. Con cada cambio, detecta qué contenido se ha modificado, lo traduce con tu motor de localización conectado —aplicando de forma coherente las reglas del glosario, la voz de marca y la configuración del modelo por idioma—, y confirma los resultados o abre una pull request. Las traducciones incompletas nunca llegan a producción.
Elige tu integración#
Cada integración tiene su propia guía. Elige la que mejor encaje con tu configuración:
| Integración | Cómo se ejecuta |
|---|---|
| GitHub App | Instálala una vez. Lingo.dev ejecuta la localización por ti en los pushes a la rama por defecto y, si lo activas, también en las pull requests, sin runner, sin secretos de clave API y sin lockfile. |
| GitHub Actions | Instala @lingo.dev/cli y ejecuta lingo push en tu pipeline de GitHub Actions; después, confirma los resultados o abre una PR. |
| GitLab CI/CD | Instala @lingo.dev/cli y ejecuta lingo push en un job de pipeline de GitLab. |
| Bitbucket Pipelines | Instala @lingo.dev/cli y ejecuta lingo push en un paso del pipeline de Bitbucket. |
La GitHub App se ejecuta en los servidores de Lingo.dev. El resto de integraciones ejecutan Lingo.dev CLI, así que cualquier entorno de CI/CD con Node.js 22+ puede ejecutar la localización directamente, incluso sin una integración nativa.
Cómo funciona la GitHub App#
Instala la app una sola vez y añade un .lingo/config.json al repositorio. A partir de ahí, Lingo.dev ejecuta la localización por ti, sin pipeline, sin secretos de clave API y sin lockfile:
- Supervisa los cambios - responde de forma predeterminada a los pushes sobre la rama por defecto y, una vez activado
onPullRequest, también a las pull requests, comprobando los archivos modificados con los patrones de origen que configures - Traduce el delta - envía el contenido de origen modificado a través del motor indicado por
engineId - Devuelve los resultados a GitHub - en los pushes a la rama por defecto, abre o actualiza una pull request de traducción; en las pull requests, confirma los archivos traducidos en la rama de la PR y publica un comentario de estado
- Recupera y agrupa - detecta cambios que una ejecución anterior haya pasado por alto y divide actualizaciones muy grandes en varios commits
Puedes hacer que las ejecuciones dependan de un paso de aprobación o lanzar las traducciones manualmente con comandos /lingo en una pull request. Consulta la guía de GitHub App para ver toda la configuración.
Cómo funcionan las integraciones con CLI#
Las integraciones de GitHub Actions, GitLab CI/CD y Bitbucket ejecutan la misma Lingo.dev CLI como un paso dentro de tu pipeline actual. Necesitan dos cosas: tu configuración de .lingo/config.json y un LINGO_API_KEY para autenticarse.
En cada ejecución, el job instala la CLI (npm install -g @lingo.dev/cli) y ejecuta lingo push, que:
- Descubre los archivos de origen - lee tu configuración del bucket para localizar el contenido traducible
- Detecta cambios: compara con el archivo de bloqueo
.lingo/lock.jsonpara identificar cadenas nuevas o modificadas, de modo que solo se traduzca el delta. - Traduce - envía el contenido modificado a través de tu motor de localización configurado, con todas las reglas aplicadas: glosario, voz de marca y ajustes del modelo por idioma
- Escribe los resultados: actualiza los archivos del idioma de destino directamente y refresca
.lingo/lock.json
Después, tu pipeline confirma los resultados o abre un pull request con las herramientas de tu propia plataforma. Como solo se traducen las cadenas modificadas, las ejecuciones son rápidas y rentables, incluso en decenas de idiomas.
Opciones de flujo de trabajo#
GitHub App#
El comportamiento de la App se configura en .lingo/config.json:
| Opción | Qué hace |
|---|---|
Push a la rama por defecto (onPushToDefaultBranch) | Activado por defecto. Abre o actualiza una PR de traducción cuando los cambios de origen llegan a la rama por defecto. |
Traducción de pull request (onPullRequest) | Desactivado por defecto. Confirma las traducciones en la rama de la PR a medida que la PR cambia. |
Aprobación previa (requireApproval) | Desactivada por defecto. Requiere Aprobar/Denegar en la ejecución de comprobación, o /lingo approve en una PR, antes de que las ejecuciones automáticas traduzcan. |
Comandos manuales (/lingo translate) | Rellena huecos o fuerza traducciones para archivos concretos desde un comentario en una PR, en cualquier momento. |
Consulta la guía de GitHub App para ver la configuración completa y la referencia de comandos.
CLI en CI/CD (GitHub Actions, GitLab CI, Bitbucket)#
Cuatro patrones de flujo de trabajo cubren la mayoría de configuraciones de equipo:
| Flujo de trabajo | Desencadenante | Resultado |
|---|---|---|
| Confirmar en main | Push a main | Traducciones confirmadas directamente en main |
| PR desde main | Push a main | Pull request con traducciones |
| Confirmar en la rama de funcionalidad | Push a la rama de funcionalidad | Traducciones confirmadas en la rama |
| PR desde la rama de funcionalidad | Push a la rama de funcionalidad | Pull request desde la rama |
La primera opción —confirmar en main— es la más sencilla. Las traducciones aparecen automáticamente, sin intervención de los desarrolladores. Las opciones basadas en PR añaden un paso de revisión antes de que las traducciones se incorporen.
Si quieres más detalles para elegir entre estas opciones, consulta Patrones avanzados.
