Marcus Andrey Estudo
Read in English Biblioteca

Design systems · Passo 1 · 7 min de leitura

Anatomia de um design system

Tokens, componentes, padrões, diretrizes e as pessoas em volta: as camadas de um design system, o que mora em cada uma, a regra que segura tudo junto, e como o ecossistema de Brad Frost acrescenta código por framework, receitas e componentes inteligentes. Tudo aplicado ao Harbour.

Um design system são camadas que apontam umas para as outras, mais as pessoas que mantêm essas setas no lugar certo. Um produto usa componentes. Componentes usam tokens. As diretrizes explicam tudo isso. E um time decide o que muda e quando. Tire qualquer camada e as outras voltam a divergir. Conhecer as camadas diz onde um problema mora, e isso já é metade da solução.

O que você vai conseguir fazer depois de ler:

  • Nomear as camadas de um design system e o que mora em cada uma
  • Explicar a regra que mantém todas trabalhando juntas
  • Aplicar o ecossistema de Brad Frost a um sistema real
  • Dizer a qual camada um pedido ou um bug pertence

1. As camadas

  1. TokensDecisões com nome: color.action.primary, space.inset.md, radius.control. O claro, o escuro e o compacto moram aqui.
  2. ComponentesBotão, campo de texto, card de viagem, linha de passageiro. Desenhados no Figma e construídos no código, com os mesmos nomes e as mesmas propriedades.
  3. PadrõesComponentes combinados para uma tarefa: fazer o check-in de um passageiro, escolher uma viagem, mostrar um atraso.
  4. Diretrizes e documentaçãoQuando usar o quê, e quando não usar. As regras de conteúdo, acessibilidade, movimento e imagem ficam junto das partes.
  5. ProdutosO app de reservas e o console da equipe: o que os passageiros e a equipe do porto usam de fato.
Pessoas e processo Quem é dono do Harbour, como um time pede uma parte nova, como as mudanças são lançadas e anunciadas, como as partes antigas são aposentadas. Sem esta coluna, a pilha de partes é um UI kit que fica desatualizado.
O Harbour, das menores decisões aos produtos. Cada camada se apoia na anterior desta lista, sem pular nenhuma: um produto não escolhe uma cor hexadecimal, ele usa um componente, que usa um token. A coluna tracejada acompanha todas as camadas.Camadas adaptadas de Brad Frost, The Design System Ecosystem (2023), e NN/g, Design Systems 101 (2021). Diagrama: Marcus Andrey, CC BY 4.0.

Em O que é um design system você conheceu quatro partes: tokens, componentes, diretrizes e governança. Aqui elas aparecem como camadas, com os padrões entre os componentes e as diretrizes, e a governança desenhada como uma coluna, porque ela toca em tudo.

A NN/g descreve o repositório de um sistema como algo que costuma ter "a style guide, a component library, and a pattern library" (um guia de estilo, uma biblioteca de componentes e uma biblioteca de padrões), e reforça que as pessoas que cuidam dele também fazem parte do sistema (NN/g, Design Systems 101, 2021).


2. O que mora em cada camada

Camada No Harbour Mora em Visto no
Tokens color.action.primary, space.inset.md, radius.control, com claro, escuro e compacto Variáveis do Figma, arquivos de tokens, custom properties do CSS Passo 2
Componentes Botão, campo de texto, select, checkbox, card de viagem Uma biblioteca no Figma e um pacote de código, com os mesmos nomes Passos 3 e 5
Padrões Fazer o check-in de um passageiro, escolher uma viagem, mostrar um atraso Documentação, exemplos, às vezes modelos de código Passo 4
Diretrizes e documentação Quando usar cada parte, regras de conteúdo, notas de acessibilidade Um site de documentação Passos 4 e 6
Pessoas e processo Um responsável, um caminho de contribuição, releases, descontinuação Documentação, um changelog, um formulário de pedido, reuniões Passos 6 e 7

Algumas diretrizes têm lições inteiras em outros cursos deste site: movimento em Documentar o movimento num design system e Tokens de movimento, imagem em Um guia de estilo de imagem no seu design system.


3. A regra que segura tudo junto

Cada camada só usa a camada em que se apoia, e nunca passa por cima dela. Um produto não escolhe #1F5FAE; ele usa um botão do Harbour. O botão também não escolhe #1F5FAE; ele lê button.primary.background, que aponta para color.action.primary, que aponta para color.blue.600.

É essa regra que deixa a mudança barata. Quando o console precisa de um modo escuro, só a camada de tokens muda. Quando o botão precisa de um anel de foco melhor, só o componente muda. Quando um time de produto pula uma camada, fixando uma cor no código ou desconectando um componente, cria um lugar aonde a próxima mudança não chega.

Ela também diz onde um pedido mora:

  • "Este azul está escuro demais no modo escuro" → camada de tokens.
  • "O botão precisa de um estado de carregando" → camada de componentes.
  • "A gente vive construindo o mesmo aviso de atraso" → camada de padrões.
  • "Ninguém sabe quando usar o botão fantasma" → diretrizes.
  • "Pedimos um seletor de data há três meses" → pessoas e processo.

4. O ecossistema de Brad Frost

Frost descreve as camadas com mais detalhe para organizações maiores (Frost, The Design System Ecosystem, 2023):

  1. Um design system central, com design tokens ("think of them as brand variables", pense neles como variáveis da marca), ícones, componentes de interface e um site de referência.
  2. Implementações por tecnologia: os mesmos componentes empacotados para React, iOS ou Android.
  3. Receitas: "composed UI components to be used consistently across specific contexts (like a product or product family)" (componentes combinados para usar de forma consistente em contextos específicos, como um produto ou uma família de produtos). Não são compartilhadas pela empresa inteira.
  4. Componentes inteligentes: componentes "wrapped in logic, functionality, or other smarts" (envolvidos em lógica ou funcionalidade), como validação de formulário ou uma tabela de dados.
  5. O produto: "the actual websites and apps that we ship" (os sites e apps que de fato entregamos).

Ele deixa claro que a maioria dessas camadas é opcional. Para o Harbour de hoje, o núcleo basta. A tabela de passageiros do console pode virar um componente inteligente mais tarde; os cards de tarifa do app de reservas podem ser uma receita que só esse app usa. Saber que essas camadas existem deixa você dizer "isso é uma receita, mora no código do console, não no Harbour", e poupa o time central de ser dono de tudo.


5. Design e código são gêmeos

Cada componente e cada token existe duas vezes: uma no Figma, outra no código. O sistema funciona quando os dois têm os mesmos nomes, as mesmas propriedades e o mesmo comportamento. Quando o botão do Figma tem uma propriedade "size" com small, medium e large, e o botão do código tem size="sm" | "md" | "lg", o handoff vira uma consulta, não uma tradução (veja Handoff para desenvolvedores). O Passo 5 é sobre manter os gêmeos no mesmo passo.


6. Erros comuns

  • Chamar uma biblioteca do Figma de "o design system", sem gêmeo no código e sem responsável.
  • Deixar os produtos usarem as cores primitivas direto, pulando a camada de tokens.
  • Colocar no núcleo cada parte avulsa de cada time, até o núcleo virar uma gaveta de bagunça.
  • Escrever as diretrizes num lugar separado que ninguém visita, longe dos componentes que elas descrevem.
  • Esquecer a coluna das pessoas: ninguém a quem perguntar, nenhum jeito de contribuir.

7. Vocabulário

Termo Significado
Camada Um nível do sistema: tokens, componentes, padrões, diretrizes
Padrão Componentes combinados para resolver uma tarefa recorrente
Núcleo As partes compartilhadas pela organização inteira
Receita Uma combinação compartilhada dentro de um produto ou família, não da empresa inteira (Frost)
Componente inteligente Um componente com lógica embutida, como validação (Frost)
Site de referência O site de documentação onde o sistema é explicado

8. Experimente (sem ferramentas)

  1. Anote cinco coisas que o seu time pediu ao sistema (ou pediria, se ele existisse).
  2. Coloque cada uma numa camada: token, componente, padrão, diretriz, ou pessoas e processo.
  3. Procure a camada com mais pedidos. É ali que o sistema está mais fraco.

Perguntas para refletir: Qual camada o seu time pula com mais frequência? O que tornaria esse atalho desnecessário?


9. Se você já pratica

  • Marque cada item do backlog do sistema com a camada dele. O desenho dessas marcas é um mapa de onde investir.
  • Escreva quais partes são núcleo e quais são receitas. Levar uma receita para o núcleo deve ser uma decisão, não um acidente.
  • Confira se cada componente tem o seu gêmeo, com os mesmos nomes de propriedade, e liste os que não têm.

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo

Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.

Relacionadas

O que é um design system · O inventário de interface · Níveis de tokens · Anatomia e API de um componente · De componentes a padrões · Modelos de contribuição · Handoff para desenvolvedores

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar