Communitygithub.com

Sistema de Diseño para Internacionalización

Diseña un marco de trabajo sistemático para interfaces preparadas para un público global, abordando diseños bidireccionales (RTL), tipografía localizada e iconografía cultural para garantizar una experiencia fluida en todos los idiomas y regiones.

¿Qué es Sistema de Diseño para Internacionalización?

Este skill proporciona una metodología completa para diseñar interfaces de usuario que sean verdaderamente globales y robustas ante los desafíos de internacionalización (i18n). Va más allá de la simple traducción, abordando la expansión de texto (hasta un 40% en idiomas como alemán o finlandés), el espejado correcto de layouts para idiomas de derecha a izquierda (RTL) como el árabe o hebreo, y la adaptación tipográfica para scripts no latinos como CJK o Devanagari. Es útil para equipos de producto y desarrolladores que trabajan en plataformas SaaS, sitios de comercio electrónico o cualquier aplicación con audiencia multirregional. El skill define flujos de trabajo prácticos, como el diseño para expansión de texto, la implementación de lógica de espejado RTL, la auditoría de iconografía direccional y el establecimiento de estándares de formato de datos. Incluye reglas de decisión clave, como la 'Regla del 35% de Búfer' para contenedores flexibles y la guía sobre qué iconos espejar y cuáles no. El resultado es un conjunto de artefactos de diseño: tokens de diseño con propiedades lógicas (start/end), especificaciones de espejado y escalas tipográficas ajustadas por familia de script.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/internationalization-design-system

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sistema de Diseño para Internacionalización (i18n)

Propósito

El skill del Sistema de Diseño para Internacionalización (i18n) proporciona una metodología para diseñar interfaces preparadas para una audiencia global. Va más allá de la simple traducción para abordar las implicaciones espaciales, tipográficas y visuales de diferentes idiomas y culturas. Este sistema garantiza que los layouts sean lo suficientemente flexibles para adaptarse a longitudes de texto variables, que los diseños bidireccionales (de derecha a izquierda) se reflejen correctamente y que las señales visuales sigan siendo culturalmente apropiadas.

Casos de Uso

  • Diseñar una plataforma SaaS global o un sitio de comercio electrónico para su lanzamiento en múltiples regiones.
  • Adaptar una interfaz existente solo en inglés para idiomas RTL (árabe, hebreo, persa).
  • Establecer estándares tipográficos para scripts no latinos (CJK, cirílico, devanagari).
  • Auditar componentes de UI para su "preparación para expansión" (manejar el crecimiento de texto en alemán o finlandés).
  • Crear conjuntos de iconos que eviten sesgos culturales o direccionales.

Cuándo NO Usarlo

  • Sitios de Una Sola Región/Idioma: Donde no hay un plan para futura expansión y las convenciones locales se conocen estrictamente.
  • Sitios de Narrativa Puramente Visual: Donde el diseño es una expresión artística que se basa en relaciones espaciales fijas y no reajustables.
  • Traducción Solo de Contenido: Si la tarea es estrictamente traducir el texto sin cambiar el comportamiento de la UI o el layout.

Entradas

  1. Lista de Idiomas Objetivo: ¿Qué idiomas y scripts necesitan soporte?
  2. Dirección de Lectura: ¿El idioma fluye de Izquierda a Derecha (LTR) o de Derecha a Izquierda (RTL)?
  3. Activos Tipográficos: Pilas de fuentes localizadas que mantengan la voz de la marca en todos los scripts.
  4. Contexto Cultural: Convenciones específicas de la región para colores, símbolos y formatos de datos (fechas, moneda).
  5. Puntos de Quiebre de Layout: Del sistema-de-cuadricula-responsive.

Salidas

  1. Especificación de Espejado Bidireccional (RTL): Un mapa de qué elementos se voltean y cuáles permanecen fijos (por ejemplo, barras de progreso vs. controles multimedia).
  2. Matriz de Escala Tipográfica: Tamaños de fuente y alturas de línea ajustados para diferentes familias de scripts.
  3. Plano de Expansión: Patrones de UI diseñados para manejar una variación de longitud de texto de +/- 40%.
  4. Lógica de Iconografía: Directrices para iconos espejados vs. no espejados.
  5. Tokens de Diseño de Localización: Propiedades lógicas (por ejemplo, padding-inline-start) definidas en la especificación de diseño.

Flujo de Trabajo

1. Diseñar para la Expansión de Texto

Nunca asuma que una etiqueta se mantendrá corta. Idiomas como el alemán o el italiano pueden ser un 30-50% más largos que el inglés.

  • Contenedores Flexibles: Evite botones o tarjetas de ancho fijo; use min-width o fit-content.
  • Ajuste de Texto: Asegúrese de que los elementos de la UI (como pestañas o elementos de menú) puedan ajustarse correctamente o transicionar a un menú de "desbordamiento".
  • Centrado Dinámico: Si el texto se expande, asegúrese de que no se superponga a elementos adyacentes.

2. Implementar la Lógica de Espejado RTL

Para los idiomas de derecha a izquierda, el "modelo mental" de la página se voltea:

  • Espejado de Layout: La barra lateral se mueve de izquierda a derecha; el logotipo se mueve de la esquina superior izquierda a la superior derecha.
  • Propiedades Lógicas: Anote los diseños usando "Inicio" y "Fin" en lugar de "Izquierda" y "Derecha".
  • Flujo de Navegación: Los botones de retroceso en LTR (apuntando a la izquierda) deben apuntar a la derecha en RTL para indicar "Volver al estado anterior".

3. Localizar la Tipografía y el Ritmo Vertical

Los scripts no latinos tienen diferentes alturas, densidades y requisitos de legibilidad:

  • CJK (Chino, Japonés, Coreano): Requiere tamaños base ligeramente más grandes y una altura de línea más generosa (interlineado) debido a la complejidad de los caracteres.
  • Árabe: Presenta ascendentes altos y descendentes profundos; aumente el espaciado vertical para evitar "choques" entre líneas.
  • Pilas de Respaldo: Defina respaldos de fuentes del sistema que coincidan lo más posible con el peso y la altura-x de su fuente de marca principal.

4. Auditar la Direccionalidad de la Iconografía

No todo se voltea en RTL:

  • Espejar: Iconos direccionales (flechas, aviones, bicicletas), barras de progreso e iconos que representan movimiento "adelante/atrás".
  • No Espejar: Iconos de sentido horario/antihorario (relojes, recargar), controles de reproducción multimedia (Reproducir, Pausa, Buscar) y "marcas de verificación" (que son universales).
  • Números: La mayoría de las regiones RTL usan numerales arábigos occidentales (1, 2, 3), que aún se leen de izquierda a derecha incluso dentro de texto RTL.

5. Establecer Estándares de Formato de Datos

  • Fecha y Hora: Defina claramente DD/MM/AAAA vs MM/DD/AAAA para evitar confusiones.
  • Moneda: Defina si el símbolo precede o sigue al monto (por ejemplo, $10 vs 10 €).
  • Calendarios: Algunas regiones usan diferentes días de inicio de la semana (lunes vs domingo).

Reglas de Decisión

  • La Regla del Espejado: Si un elemento de la UI representa "dirección" o "tiempo" (avanzar), DEBE espejarse en RTL. Si representa un objeto físico (como una cámara o un reloj), generalmente permanece fijo.
  • La Regla del "Búfer del 35%": Deje siempre un 35% de espacio vacío en botones y etiquetas durante la fase de diseño en inglés para tener en cuenta la expansión.
  • Tamaño Específico por Script: Si un script es altamente complejo (por ejemplo, devanagari), aumente el tamaño de fuente en un 10-15% en comparación con el equivalente latino para mejorar la legibilidad.
  • Sensibilidad Cultural: Evite iconos que sean céntricos occidentales (por ejemplo, una alcancía para ahorros, que es inapropiada en muchas culturas).

Restricciones

  • Accesibilidad: La expansión de texto no debe ocultar elementos interactivos ni causar desbordamiento horizontal. Los ratios de contraste deben mantenerse en todas las versiones localizadas.
  • Adaptabilidad: Los layouts deben permanecer estables al cambiar las direcciones. Use padding-inline y margin-inline en las especificaciones.
  • Jerarquía: La CTA principal debe seguir siendo el elemento más prominente, independientemente de la dirección de lectura.

Patrones de Falla Comunes

  • La "Rotura por Expansión": Anchuras codificadas que hacen que el texto traducido se corte o se superponga.
  • Espejado Perezoso: Espejar iconos que no deberían (como un botón de "Reproducir" o un reloj), lo que confunde a los usuarios.
  • La Trampa del "Inglés-Primero": Diseñar una UI ajustada y minimalista en inglés que se vuelve completamente inutilizable en idiomas con palabras largas.
  • Falta de Respaldo: No especificar fuentes para scripts no latinos, lo que resulta en "Tofu" (cuadros de caracteres rotos).
  • Alineación Inconsistente: Mezclar un layout espejado con una alineación de texto no espejada, creando una sensación irregular y poco pulida.

Criterios de Validación

  • El layout se espeja correctamente para las vistas RTL (intercambio de barra lateral/logotipo).
  • Los componentes de la UI manejan una expansión de texto del 40% sin romperse ni superponerse.
  • La escala tipográfica se ajusta por complejidad del script (por ejemplo, la altura de línea aumenta para árabe/CJK).
  • La iconografía sigue la lógica de "Espejado vs. Fijo".
  • Los diseños usan propiedades lógicas (Inicio/Fin) en lugar de absolutas (Izquierda/Derecha).
  • Los formatos de fecha, moneda y número están localizados correctamente.
  • Las pilas de fuentes de respaldo están definidas para todos los scripts objetivo.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Skills relacionados