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

Wuchale: herramienta i18n de código abierto que extrae mensajes del código y genera catálogos indexados para recuperación por índice en runtime. Soporta Svelte, React, Preact y TS/JS.

10 sept 2025 • 3 min de lectura • Equipo Q2BSTUDIO

Inteligencia-Artificial-

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.

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat