A cor de marca do seu produto está, provavelmente, espalhada em mais de quarenta lugares diferentes: arquivos CSS, componentes React, configurações do Figma, e até em valores hexadecimais hardcoded direto num botão que alguém criou às pressas seis meses atrás. Isso não é um detalhe estético sem importância. É dívida técnica disfarçada de decisão de design.
Design tokens resolvem exatamente esse problema — mas só quando estruturados em camadas certas. A maioria dos times implementa tokens de forma plana, sem hierarquia, e perde metade do valor do sistema.
As três camadas de um sistema de tokens maduro
Primitivas (primitive tokens)
São os valores brutos: blue-500, space-4, radius-md. Não carregam significado de uso — só existem para centralizar a escala de valores possíveis. Ninguém usa uma primitiva direto num componente.
Aliases (semantic tokens)
Dão significado às primitivas: color-action-primary aponta para blue-500. Quando a marca muda de azul para verde, você muda um único alias — e tudo que referenciava color-action-primary atualiza automaticamente, sem tocar em nenhum componente.
Component tokens
São específicos de um componente: button-primary-bg referencia o alias semântico, não a primitiva direto. Essa camada extra parece redundante no início, mas é o que permite que um botão específico tenha exceção visual sem quebrar o sistema semântico geral.
Token sem hierarquia é só uma variável CSS com nome bonito. O valor real do sistema está na cadeia primitiva → semântico → componente.
Por que o Figma sozinho não resolve
Variáveis do Figma cobrem a camada de design. Mas sem um pipeline que exporta esses valores automaticamente para código — via Style Dictionary, Tokens Studio ou similar — alguém vai, manualmente, copiar valores hex do Figma para o CSS. E nesse copy-paste manual é onde o sistema se quebra silenciosamente.