Processo de Pull e Push com o Provedor
Conteúdo adaptado da documentação oficial do Token Studio (TS), disponível aqui.
Após conectar o provedor de sincronização, o Tokens Studio permite manter os Design Tokens atualizados entre Figma e o repositório remoto.
Esse fluxo garante alinhamento contínuo entre design e desenvolvimento, estabelecendo uma única fonte de verdade para as equipes.
Push (Enviar alterações para o repositório)
O push envia as mudanças feitas no Figma para o repositório remoto.
O plugin detecta alterações locais e sinaliza quando há itens pendentes de envio.
Etapas recomendadas:
- Adicionar mensagem de commit: breve e descritiva.
- Revisar o diff: itens adicionados aparecem em verde e os removidos em vermelho.
- Validar o JSON final: visualizar os dados antes do envio.
Isso garante que as modificações locais sejam incorporadas ao repositório principal, mantendo todos os colaboradores atualizados.
Pull (Receber alterações do repositório)
O pull traz para o Figma as alterações feitas no repositório remoto.
É útil para manter os tokens sincronizados ou restaurar versões originais após mudanças indevidas.
Etapas recomendadas:
- Revisar mudan ças listadas pelo plugin:
- Tokens removidos → indicados com etiqueta de remoção.
- Tokens alterados → mostram valor anterior e novo.
- Alterações de tema/metadados → exibidas como atualizações extras.
- Aceitar alterações: confirmar a atualização e aplicar ao Figma.
- Exportar para Styles/Variables, se necessário: usando a opção Export styles & variables to Figma.
Boas Práticas
- Sempre revisar diffs antes do push/pull para evitar inconsistências.
- Utilizar mensagens de commit claras para rastrear mudanças.
- Executar pulls regulares antes de iniciar ajustes locais.
- Confirmar exportação no Figma para garantir que os tokens sejam refletidos em Styles/Variables.
Para detalhes sobre pull/push, consulte esta documentação.
Para detalhes sobre exportação para o Figma, veja estas opções e este guia.