Por qué construí Wuchale: i18n Protobuf desde código plano

Seamos honestos: la internacionalización suele dar pereza. A muchos nos pasa lo mismo. Entre catálogos, plantillas repetitivas y casos borde, lo que debería ser sencillo se vuelve un laberinto y preferimos posponerlo. Esa fue mi experiencia al añadir i18n a un proyecto grande con más de 1K mensajes.

Probé herramientas existentes y Lingui me ahorró mucho trabajo al generar catálogos automáticamente y mantener los mensajes en el código, pero con el tiempo el proyecto empezó a acumular boilerplate y cada mensaje nuevo añadía fricción. La herramienta ayudaba, pero también entorpecía la legibilidad del código.

De esa frustración nació Wuchale, una caja de herramientas de i18n que busca simplificar dos cosas clave. Primero escanea código plano para localizar mensajes visibles por el usuario, los extrae y opcionalmente los traduce. Luego compila esos catálogos en versiones compactas sin claves, solo arreglos indexados al estilo Protobuf, optimizados para uso en tiempo de ejecución. Segundo reescribe automáticamente el código para que recupere los mensajes por índice, sin necesidad de claves manuales.

Wuchale usa análisis estático sobre AST del código, por lo que encuentra mensajes dondequiera que estén. El resultado: código fuente limpio y legible y toda la complejidad gestionada tras bambalinas. En tiempo de compilación se genera un catálogo compilado optimizado; en tiempo de ejecución la carga de mensajes es una simple lectura por índice, sin operaciones costosas ni reemplazos de cadenas.

Empezó con soporte para Svelte y, tras casi tres meses de dedicación intensa y mejoras impulsadas por la comunidad, amplió soporte para React, Preact, SolidJS y JavaScript/TypeScript, incluyendo mensajes del lado servidor. La experiencia de desarrollo es fluida gracias a un cuidado especial en HMR: escribes como siempre y Wuchale mantiene los catálogos sincronizados en segundo plano. Además puede integrarse con traducción automática por IA para obtener traducciones rápidas que se puedan revisar después.

Una de las prioridades fue mantener las dependencias al mínimo. A diferencia de otras herramientas con paquetes pesados, Wuchale tiene menos de 10 dependencias y comparte muchas librerías ya presentes en proyectos con Vite y los frameworks, por lo que la carga adicional suele ser de menos de 5 dependencias.

Probé Wuchale en el proyecto original y lo internacionalicé totalmente en menos de 30 minutos usando traducción automática. La mayor parte del tiempo se fue en la interfaz de selección de idioma. El resultado fue una experiencia de desarrollo mucho más agradable: la internacionalización dejó de ser un lastre y pasó a ser una capa transparente.

En Q2BSTUDIO, empresa dedicada al desarrollo de software y aplicaciones a medida, vimos en Wuchale una filosofía alineada con nuestros servicios. Entregamos soluciones de software a medida y aplicaciones a medida con enfoque en calidad, rendimiento y escalabilidad. Si buscas externalizar el desarrollo de una aplicación o necesitas asesoría técnica, visita nuestra página dedicada al desarrollo de aplicaciones a medida.

Además de desarrollo, en Q2BSTUDIO ofrecemos servicios especializados en inteligencia artificial, ciberseguridad, servicios cloud aws y azure y servicios de inteligencia de negocio. Podemos ayudarte a integrar ia para empresas, agentes IA y soluciones de Power BI para explotar tus datos y mejorar la toma de decisiones. Conoce nuestros servicios de inteligencia artificial para empresas y descubre cómo acelerar procesos y obtener ventaja competitiva.

Wuchale es open source y recibe contribuciones de la comunidad. Si te interesa probar una alternativa a los flujos tradicionales de i18n que reduce boilerplate, mejora la legibilidad y mantiene el runtime ligero, dale una oportunidad. Y si necesitas apoyo para integrar i18n en proyectos empresariales, nuestros expertos en Q2BSTUDIO están listos para colaborar, incluyendo soluciones en ciberseguridad y pentesting, migraciones a cloud, automatización de procesos y servicios de Business Intelligence con Power BI.

Gracias por leer. Si te interesa colaborar o probar Wuchale en un proyecto real, estaremos encantados de ayudarte y recibir feedback. En Q2BSTUDIO combinamos experiencia técnica y enfoque en negocio para entregar software a medida y soluciones innovadoras de inteligencia artificial, ciberseguridad y servicios cloud para tu empresa.