Communitygithub.com

coastdigitalgroup/coastai-skills

Projete um framework sistemático para interfaces prontas para o mundo, abordando layouts bidirecionais (RTL), tipografia localizada e iconografia cultural, garantindo uma experiência perfeita em diferentes idiomas e regiões.

O que é coastai-skills?

Esta skill fornece uma metodologia abrangente de Design System de Internacionalização (i18n) para construir interfaces de usuário que sejam verdadeiramente globais. Ela vai além da simples tradução de texto, focando nos aspectos espaciais, tipográficos e visuais necessários para suportar diversos idiomas e culturas. A skill é ideal para plataformas SaaS, sites de e-commerce e qualquer aplicação com planos de expansão multi-região, oferecendo orientação sobre espelhamento RTL (da direita para a esquerda), tipografia para scripts não latinos (como CJK, Árabe, Devanagari) e diretrizes de iconografia culturalmente sensíveis. O fluxo de trabalho inclui etapas como design para expansão de texto, implementação de lógica de espelhamento, localização tipográfica, auditoria de direcionalidade de ícones e padronização de formatos de dados, com regras de decisão claras como a 'Regra do Espelhamento' e a 'Regra do Buffer de 35%' para garantir layouts flexíveis e sem quebras.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Sistema de Design de Internacionalização

Propósito

A skill de Sistema de Design de Internacionalização (i18n) fornece uma metodologia para projetar interfaces prontas para um público global. Ela vai além da tradução simples para abordar as implicações espaciais, tipográficas e visuais de diferentes idiomas e culturas. Este sistema garante que os layouts sejam flexíveis o suficiente para acomodar comprimentos de texto variados, que layouts bidirecionais (da Direita para a Esquerda) sejam espelhados corretamente e que os sinais visuais permaneçam culturalmente apropriados.

Casos de Uso

  • Projetar uma plataforma SaaS global ou um site de e-commerce para lançamento em várias regiões.
  • Adaptar uma interface existente apenas em inglês para idiomas RTL (árabe, hebraico, persa).
  • Estabelecer padrões tipográficos para scripts não latinos (CJK, cirílico, devanagari).
  • Auditar componentes de UI quanto à "prontidão para expansão" (lidando com o crescimento de texto em alemão ou finlandês).
  • Criar conjuntos de ícones que evitem viés cultural ou direcional.

Quando NÃO Usar

  • Sites de Região Única/Idioma Único: Onde não há planos para expansão futura e as convenções locais são estritamente conhecidas.
  • Sites de Narrativa Puramente Visual: Onde o design é uma expressão artística que depende de relações espaciais fixas e sem refluir.
  • Tradução Apenas de Conteúdo: Se a tarefa é estritamente traduzir o texto sem alterar o comportamento da UI ou do layout.

Entradas

  1. Lista de Idiomas Alvo: Quais idiomas e scripts precisam ser suportados?
  2. Direção de Leitura: O idioma flui da Esquerda para a Direita (LTR) ou da Direita para a Esquerda (RTL)?
  3. Ativos Tipográficos: Pilhas de fontes localizadas que mantêm a voz da marca em diferentes scripts.
  4. Contexto Cultural: Convenções específicas da região para cores, símbolos e formatos de dados (datas, moedas).
  5. Pontos de Quebra de Layout: Do responsive-grid-system.

Saídas

  1. Especificação de Espelhamento Bidirecional (RTL): Um mapa de quais elementos invertem e quais permanecem fixos (por exemplo, barras de progresso vs. controles de mídia).
  2. Matriz de Escala Tipográfica: Tamanhos de fonte e alturas de linha ajustados para diferentes famílias de scripts.
  3. Blueprint de Expansão: Padrões de UI projetados para lidar com variação de comprimento de texto de +/- 40%.
  4. Lógica de Iconografia: Diretrizes para ícones espelhados vs. não espelhados.
  5. Tokens de Design de Localização: Propriedades lógicas (por exemplo, padding-inline-start) definidas na especificação de design.

Fluxo de Trabalho

1. Projetar para Expansão de Texto

Nunca presuma que um rótulo permanecerá curto. Idiomas como alemão ou italiano podem ser 30-50% mais longos que o inglês.

  • Contêineres Flexíveis: Evite botões ou cartões com largura fixa; use min-width ou fit-content.
  • Quebra de Texto: Garanta que elementos de UI (como abas ou itens de menu) possam quebrar graciosamente ou fazer a transição para um menu de "transbordo".
  • Centralização Dinâmica: Se o texto expandir, garanta que ele não se sobreponha a elementos adjacentes.

2. Implementar Lógica de Espelhamento RTL

Para idiomas da Direita para a Esquerda, o "modelo mental" da página inverte:

  • Espelhamento de Layout: A barra lateral se move da Esquerda para a Direita; o Logotipo se move do canto superior esquerdo para o canto superior direito.
  • Propriedades Lógicas: Anote os designs usando "Início" e "Fim" em vez de "Esquerda" e "Direita".
  • Fluxo de Navegação: Botões de Voltar em LTR (apontando para a esquerda) devem apontar para a direita em RTL para indicar "Voltar ao estado anterior".

3. Localizar Tipografia e Ritmo Vertical

Scripts não latinos têm diferentes alturas, densidades e requisitos de legibilidade:

  • CJK (Chinês, Japonês, Coreano): Requer tamanhos de base ligeiramente maiores e altura de linha (entrelinhamento) mais generosa devido à complexidade dos caracteres.
  • Árabe: Possui ascendentes altos e descendentes profundos; aumente o espaçamento vertical para evitar "choque" entre as linhas.
  • Pilhas de Fallback: Defina fallbacks de fontes do sistema que correspondam ao peso e à altura-x da sua fonte de marca primária o mais próximo possível.

4. Auditar Direcionalidade da Iconografia

Nem tudo inverte no RTL:

  • Espelhar: Ícones direcionais (setas, aviões, bicicletas), barras de progresso e ícones que representam movimento "para frente/para trás".
  • Não Espelhar: Ícones de sentido horário/anti-horário (relógios, recarregar), controles de reprodução de mídia (Play, Pause, Seek) e "marcas de verificação" (que são universais).
  • Números: A maioria das regiões RTL usa numerais arábicos ocidentais (1, 2, 3), que ainda são lidos LTR mesmo dentro de texto RTL.

5. Estabelecer Padrões de Formatação de Dados

  • Data e Hora: Defina claramente DD/MM/AAAA vs MM/DD/AAAA para evitar confusão.
  • Moeda: Defina se o símbolo precede ou segue o valor (por exemplo, R$ 10 vs 10 €).
  • Calendários: Algumas regiões usam dias de início da semana diferentes (segunda-feira vs domingo).

Regras de Decisão

  • A Regra do Espelhamento: Se um elemento de UI representa "direção" ou "tempo" (movendo-se para frente), ele DEVE ser espelhado em RTL. Se representa um objeto físico (como uma câmera ou um relógio), geralmente permanece fixo.
  • A Regra do "Buffer de 35%": Sempre deixe 35% de espaço vazio em botões e rótulos durante a fase de design em inglês para compensar a expansão.
  • Tamanho Específico de Script: Se um script for altamente complexo (por exemplo, Devanagari), aumente o tamanho da fonte em 10-15% em comparação com o equivalente latino para legibilidade.
  • Sensibilidade Cultural: Evite ícones que sejam ocidentalizados (por exemplo, um porquinho para economizar, o que é inadequado em muitas culturas).

Restrições

  • Acessibilidade: A expansão de texto não deve ocultar elementos interativos ou causar transbordo horizontal. As taxas de contraste devem ser mantidas em todas as versões localizadas.
  • Responsividade: Os layouts devem permanecer estáveis ao mudar de direção. Use padding-inline e margin-inline nas especificações.
  • Hierarquia: O CTA principal deve permanecer o elemento mais proeminente, independentemente da direção de leitura.

Padrões Comuns de Falha

  • "A Quebra por Expansão": Larguras codificadas que fazem com que o texto traduzido seja cortado ou sobreposto.
  • "Espelhamento Preguiçoso": Espelhar ícones que não deveriam ser (como um botão "Play" ou um relógio), o que confunde os usuários.
  • "A Armadilha do Inglês-Primeiro": Projetar uma UI enxuta e minimalista em inglês que se torna completamente inutilizável em idiomas com palavras longas.
  • "Fallbacks Ausentes": Não especificar fontes para scripts não latinos, resultando em "Tofu" (caixas de caracteres quebradas).
  • "Alinhamento Inconsistente": Misturar layout espelhado com alinhamento de texto não espelhado, criando uma sensação irregular e não polida.

Critérios de Validação

  • O layout é espelhado com sucesso para viewports RTL (troca de Barra Lateral/Logotipo).
  • Os componentes de UI lidam com expansão de texto de 40% sem quebrar ou sobrepor.
  • A escala tipográfica é ajustada para a complexidade do script (por exemplo, altura da linha aumenta para Árabe/CJK).
  • A iconografia segue a lógica de "Espelhamento vs. Fixo".
  • Os designs usam propriedades lógicas (Início/Fim) em vez de absolutas (Esquerda/Direita).
  • Os formatos de data, moeda e número são localizados corretamente.
  • Pilhas de fontes de fallback são definidas para todos os scripts alvo.

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.

Habilidades Relacionadas