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 | Ejecuta la CLI en tu pipeline de GitHub Actions mediante la Action oficial. |
| GitLab CI/CD | Ejecuta la CLI en los pipelines de GitLab mediante la imagen oficial de Docker. |
| Bitbucket Pipelines | Ejecuta la CLI en los pipelines de Bitbucket mediante el Pipe oficial. |
Salvo la GitHub App, todas las integraciones ejecutan la CLI de Lingo.dev, así que cualquier entorno de CI/CD con Node.js 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 de pipeline#
GitHub Action, GitLab CI/CD, Bitbucket Pipelines y la CLI independiente ejecutan la misma CLI de Lingo.dev como un paso dentro de tu pipeline actual. Solo necesitan dos cosas: tu configuración i18n.json y una clave API.
En cada ejecución, la integración:
- Descubre los archivos de origen - lee tu configuración del bucket para localizar el contenido traducible
- Detecta los cambios - compara con el lockfile
i18n.lockpara 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 en su ubicación
- Confirma o abre una PR - según el flujo de trabajo que elijas
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.
GitHub Action, GitLab CI, Bitbucket y CLI#
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.
