Design systems · 11 min de leitura
Design systems na prática
Tokens, componentes, documentação e governança: como montar um design system que as pessoas usam de verdade, do Figma ao código. Com laboratórios.
Sete passos em ordem, depois cinco laboratórios e uma parte para quem lidera times de design. Um sistema fictício, o Harbour, atravessa todas as aulas, lado a lado com sistemas públicos que você pode abrir.
Passo 1 · Por que um design system
- O que um design system resolveUm design system resolve um problema que cresce a cada time: a mesma decisão tomada de novo e de novo, um pouco diferente. Quanto isso custa, o que um sistema devolve, o que ele não resolve, e a empresa fictícia de balsas cujo sistema, o Harbour, atravessa este curso.
- Quando você ainda não precisa de umUm design system custa um time, tempo e paciência, e só se paga quando o trabalho se repete por anos. Os sinais que dizem ainda não, comece pequeno ou invista, o que fazer em cada fase, e por que o menor sistema útil costuma ser um conjunto de tokens e cinco componentes.
- Anatomia de um design systemTokens, 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.
- O inventário de interfaceAntes de desenhar um sistema, junte o que já existe: uma captura de tela de cada botão, campo, cor e mensagem diferente nos seus produtos. Como funciona o inventário de interface de Brad Frost, como a Tidewater fez um em dois produtos, e como o resultado vira o primeiro rascunho do Harbour e o argumento a favor dele.
Passo 2 · Fundamentos e tokens
- Níveis de tokensO token primitivo diz o que um valor é, o semântico diz para que ele serve, o de componente diz onde ele entra. Por que a maioria dos sistemas usa esses três níveis, como os aliases ligam um ao outro, como o Material, o Carbon e o Spectrum dão nome à mesma ideia, e quantos níveis um sistema precisa de verdade.
- Como nomear tokensO nome de um token é um pedacinho de documentação que as pessoas leem centenas de vezes por dia. Como montar nomes do geral para o específico, nomear primitivos pelo que eles são e semânticos pelo que fazem, escolher uma escala que cresce, e manter um nome só entre Figma, JSON, CSS e código nativo.
- Cor, tipografia e espaçamento como tokensOs fundamentos de um sistema, transformados em tokens: papéis de cor desenhados em pares medidos, uma escala tipográfica em rem que aguenta o zoom, e uma escala de espaçamento com nomes para dentro e para entre. Os valores reais do Harbour e as razões de contraste, e o que documentar junto de cada token.
- Temas e modosClaro e escuro, confortável e compacto: um modo é um segundo conjunto de respostas para os mesmos tokens semânticos. Como o Harbour troca de modo e de densidade sem mexer num componente, o CSS exato de uma demo ao vivo, por que o modo escuro é medido e não invertido, e como o Figma e o resolver do DTCG tratam a mesma ideia.
- Tokens do Figma ao códigoTokens só servem se o design e o código lerem os mesmos. Onde deve morar a fonte da verdade, como as variáveis do Figma, os arquivos de tokens DTCG e uma ferramenta de build como o Style Dictionary se encaixam, como é um arquivo de tokens do Harbour, e o que já está estável no padrão hoje.
Passo 3 · Componentes
- Anatomia e API de um componenteUm componente é uma promessa: estas partes, estas opções, estas regras, iguais no Figma e no código. Como desmontar um componente em partes com nome, como escrever a API antes de desenhar, e por que a tabela de props é a página mais útil do sistema.
- Variantes, propriedades e slotsHá três jeitos de um componente cobrir muitos casos: variantes para um conjunto fixo de versões, propriedades para pequenos interruptores, slots para áreas abertas. Quando usar cada um, como eles se multiplicam, e como dar os mesmos nomes no Figma e no código.
- Estados e casos-limiteUm componente não está pronto quando a versão feliz fica bonita. Todo componente do Harbour tem estados de interação que o navegador define e estados de dados que o produto define, e mais os casos-limite que o conteúdo real traz: nomes longos, traduções, dados faltando, erros. Um botão de verdade com o CSS exato, os números de contraste e uma lista para desenhar contra ela.
- Composição em vez de configuraçãoUm componente com uma prop para cada caso fica mais difícil de usar a cada pedido. A composição dá aos times partes pequenas que se encaixam. Por que as props se acumulam, como o Ticket card do Harbour é montado com partes, os componentes, receitas e flocos de neve de Brad Frost, e onde a configuração ainda é a resposta certa.
- Componentes acessíveisA acessibilidade construída num componente chega a todas as telas que o usam; um erro nele também. Comece pelo HTML nativo, siga os padrões do WAI-ARIA Authoring Practices quando eles existem, e escreva o que o componente garante e o que continua sendo do produto. Com o Button, o Text field e o Ticket card do Harbour.
Passo 4 · Padrões e conteúdo
- De componentes a padrõesComponentes são as peças; padrões são o jeito como as peças resolvem uma tarefa. O que é um padrão num design system, como o padrão "Reservar uma travessia" do Harbour é montado com oito componentes, o que a página de documentação de um padrão precisa ter, e por que padrões mudam mais devagar que componentes.
- Conteúdo e voz no sistemaAs palavras de um componente fazem parte do componente. Como um design system mantém uma voz que não muda e um tom que muda, regras de conteúdo para botões, erros e rótulos, textos guardados com chaves, traduções e limites de tamanho, e quem cuida deles.
- Ícones e ilustração no sistemaÍcones são uma família de componentes com grade, tamanhos e nomes próprios; ilustrações são uma voz em imagens. Como o Harbour desenha ícones numa grade só, escolhe três tamanhos, dá nomes pelo significado, marca os ícones para leitores de tela e guarda a ilustração para os momentos que precisam dela.
Passo 5 · Figma e código
- Montar uma biblioteca no FigmaUma biblioteca do Figma é a metade de design do sistema: o arquivo de onde os outros arquivos puxam componentes, estilos e variáveis. Como dividir em arquivos e páginas, como os tokens do Harbour viram variáveis com modos, como dar aos componentes propriedades que batem com o código, e o que a publicação exige e em qual plano.
- Code Connect e a ponte entre design e códigoUm componente no Figma e um componente no código são duas coisas que deveriam ser uma só. Como manter os dois juntos: nomes compartilhados, um mapeamento escrito das propriedades do Figma para as props do código, e o Code Connect do Figma, que mostra o código real no Dev Mode. O que ele exige, em quais planos está e onde ele para.
- Storybook e documentação vivaDocumentação escrita uma vez fica velha. Documentação que desenha o componente real não tem como ficar. O que é o Storybook, o que é uma story, como as stories viram documentação, verificações de acessibilidade e testes visuais, e como ligar tudo ao Figma para o design ver o que foi construído de verdade.
- Versões e releasesUm design system é algo de que outros times dependem, então cada mudança é uma mudança no produto deles. Como funciona o versionamento semântico e o que conta como quebra num design system, como manter a biblioteca do Figma e o pacote de código no mesmo número, como escrever um changelog que as pessoas leem, e um ritmo de releases que os times conseguem planejar.
Passo 6 · Documentação e adoção
- Documentação de componentes que as pessoas usamA maior parte da documentação de design systems é escrita para quem construiu o sistema, não para quem está com prazo. O que a página de um componente precisa responder, em que ordem, onde cada parte mora (site de documentação, Figma, Storybook), como os melhores sistemas públicos organizam as suas, e como manter a documentação verdadeira.
- Trazer os times para o sistemaUm design system que ninguém usa é um arquivo do Figma muito bem organizado. Como os times passam de fato para um sistema: tratar o sistema como um produto com usuários, um piloto antes de qualquer obrigação, migração tela a tela, a ajuda que torna o certo o mais fácil, e o que fazer quando um time diz não.
- Medir a adoçãoDizer que todo mundo usa o sistema não é uma medida. O que contar no design e no código, o que as análises de biblioteca do Figma mostram e em quais planos estão, por que os detaches importam mais do que as inserções, quão atrasados os times estão nas versões, e como ler os números junto com o que as pessoas dizem.
Passo 7 · Governança e escala
- Modelos de contribuiçãoQuem pode mudar um design system, e como. Os três modelos de time por trás da maioria dos sistemas, um caminho de contribuição com uma régua que as pessoas conhecem antes de começar, e como dizer não sem perder quem pediu.
- Descontinuação e breaking changesComo mudar ou remover algo num design system sem quebrar os produtos que o usam. O que conta como mudança que quebra, como o Versionamento Semântico ordena descontinuação e remoção, e os avisos, a ajuda na migração e as linhas de changelog que levam os times até o outro lado.
- Sistemas multimarca e multiprodutoUm sistema para várias marcas e produtos, sem bifurcá-lo. O que uma marca pode mudar e o que ela nunca toca, como uma camada de tokens de marca funciona ao lado dos modos, e como separar um núcleo compartilhado do que pertence a um só produto.
Laboratórios
- Faça um inventário de interfaceUm laboratório guiado: capture cada botão, campo, cor e valor de espaçamento distinto de um ou dois produtos, agrupe por categoria, conte as variações e transforme a contagem numa proposta curta. Cerca de duas horas, com uma ferramenta de slides ou de quadro branco.
- Monte um conjunto de tokens com modosUm laboratório guiado: escreva um pequeno conjunto de tokens do Harbour no formato DTCG, com primitivos, tokens semânticos para claro e escuro, um eixo de densidade e um arquivo de resolver. Depois confira o contraste de cada par e espelhe tudo em variáveis do Figma. Cerca de duas horas, com um editor de texto e o Figma.
- Desenhe um componente com variantes no FigmaUm laboratório guiado: desenhe o botão do Harbour como um conjunto de componentes no Figma, começando pela API. Escreva a tabela de propriedades, monte uma base com auto layout e variáveis, acrescente propriedades de variante, booleana, de troca de instância e de texto, e teste o componente do jeito que as pessoas vão quebrá-lo. Cerca de duas horas no Figma.
- Escreva a página de documentação de um componenteUm laboratório guiado: escreva a página de documentação de um componente, na ordem em que as pessoas fazem as perguntas. Junte as perguntas reais, preencha um modelo, escreva regras de uso com motivo e teste a página com um designer e um dev que nunca usaram o componente. Cerca de duas horas.
- Conduza uma revisão de contribuiçãoUm laboratório guiado: leve uma contribuição pela triagem e pela revisão. Leia um pedido, decida se ele é útil e único, revise o trabalho pronto com um checklist publicado e escreva uma decisão com a qual quem contribuiu consiga agir. Cerca de duas horas, sozinho ou com duas pessoas fazendo os papéis.
Para quem lidera
- Financiar e montar o time de um design systemPara quem lidera: como conseguir para o design system as pessoas e o tempo de que ele precisa. Por que ele tem que ser financiado como um produto, que papéis ele pede em cada fase, as formas de pagar por ele e como escrever o pedido sem inventar números.
- Um roadmap para o sistemaPara quem lidera: como planejar o trabalho de um design system para que os times de produto consigam planejar em volta dele. Itens do roadmap como resultados para os produtos, as entradas que decidem a ordem, um equilíbrio entre trabalho novo e manutenção, e como publicar o roadmap e mantê-lo honesto.
- Mostrar o valor de um design systemPara quem lidera: como mostrar quanto vale um design system com números que você consegue defender. O que o único estudo cronometrado público encontrou e o que não encontrou, como medir velocidade, qualidade e consistência no seu time, e como apresentar o valor sem inventar ROI.
Referência
- Glossário141 termos definidos nas aulas deste curso, de A a Z.
- Frameworks15 frameworks e técnicas que as aulas deste curso usam, por área.
- Biblioteca117 livros, artigos, vídeos e cursos citados neste curso, pelo passo em que aparecem. Os títulos ficam no idioma original.
Salvo só neste dispositivo.