Regras de Uso e Pontos Críticos

info

Conteúdo adaptado da documentação oficial do Tokens Studio (TS), disponível aqui.

Não exportar como Text Styles no Figma
Exportar Typography Tokens como estilos cria dependências difíceis de manter. No Opala DS, usamos variáveis refletindo os valores dos tokens, garantindo flexibilidade e gestão centralizada.
Aplicar sempre pelo Tokens Studio
Alterações feitas na barra lateral do Figma não atualizam o token no plugin. Isso gera inconsistências no Inspect e dificulta a manutenção. Sempre aplique e edite pelo Tokens Studio.
Não alterar propriedades individuais isoladamente
Ao aplicar um Typography Token, evite mudar apenas fontSize ou fontWeight. Isso quebra a coesão do token composto, causando inconsistências entre elementos.

Bug de fontFamily
Às vezes, a família de fonte não é associada corretamente ao aplicar o token.
🔎 Sempre verifique após a aplicação. Se necessário, revalide no plugin para garantir que a variável foi reconhecida.
Uso de referências em tokens
Prefira criar Typography Tokens baseados em referências. Assim, mudanças em tokens principais (como fontSize.base) se propagam automaticamente para todos os lugares.
Evitar propriedades incompletas
Defina todas as propriedades tipográficas no token, mesmo que algumas sejam none ou null. Isso evita lacunas que podem causar erros ou inconsistências visuais.
Testar exportação antes de integrar no código
Use o @tokens-studio/sd-transforms para validar a exportação dos tokens. Isso garante que todas as propriedades tipográficas sejam convertidas corretamente em variáveis utilizáveis no desenvolvimento.

dica

Mais detalhes sobre Typography Token estão aqui.

Regras de Uso e Pontos Críticos​