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
- TokensDecisões com nome:
color.,action. primary space.,inset. md radius.. O claro, o escuro e o compacto moram aqui.control - 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.
- PadrõesComponentes combinados para uma tarefa: fazer o check-in de um passageiro, escolher uma viagem, mostrar um atraso.
- 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.
- ProdutosO app de reservas e o console da equipe: o que os passageiros e a equipe do porto usam de fato.
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):
- 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.
- Implementações por tecnologia: os mesmos componentes empacotados para React, iOS ou Android.
- 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.
- 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.
- 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)
- Anote cinco coisas que o seu time pediu ao sistema (ou pediria, se ele existisse).
- Coloque cada uma numa camada: token, componente, padrão, diretriz, ou pessoas e processo.
- 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
- Brad Frost: The Design System Ecosystem (2023)
- NN/g, Therese Fessenden: Design Systems 101 (2021)
- Como sistemas públicos organizam as camadas: IBM Carbon · Atlassian Design System · Adobe Spectrum
Livros, cursos e vídeos para ir mais fundo
- Atomic DesignBrad Frost2016, grátis na internet (Amazon)
- Design SystemsAlla KholmatovaLivro · Smashing Media, 2017 (Amazon)
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