Marcus Andrey Estudo
Read in English Biblioteca

Fundamentos de UX · Passo 8 · 7 min de leitura

Handoff para desenvolvedores

Um design é um conjunto de decisões, e os desenvolvedores só conseguem construir as que você deixou visíveis. O que especificar (estados, casos-limite, comportamento, espaçamento por tokens, notas de acessibilidade), por que trabalhar com os desenvolvedores desde cedo é melhor do que um grande handoff no fim, e como ferramentas como o Dev Mode do Figma podem ajudar.

Os desenvolvedores constroem o que você decidiu, e adivinham o resto. Um mock-up mostra um momento só: a tela feliz, com um nome curto e dados perfeitos. O produto precisa funcionar em todos os outros momentos também: carregando, com a lista vazia, com um nome de 60 caracteres, com alguém usando só o teclado. Um bom handoff responde a essas perguntas antes que alguém precise fazê-las. Um handoff melhor ainda é uma conversa que começou semanas antes.

O que você vai conseguir fazer depois de ler:

  • Listar o que um handoff precisa especificar além do mock-up
  • Escrever estados, casos-limite e comportamento em palavras simples
  • Indicar espaçamento, cor e tipografia por meio de design tokens
  • Trazer os desenvolvedores cedo, para que o handoff não tenha surpresas

1. Handoff é uma conversa, não uma entrega

A palavra "handoff" (passar adiante) sugere jogar um arquivo por cima do muro. Na prática, os times que funcionam bem conversam o tempo todo. Kelley Gordon, da NN/g, descreve a falha mais comum: "If developers see the design only after user testing and stakeholder validation, it's already too late." (se os desenvolvedores só veem o design depois do teste com usuários e da validação dos stakeholders, já é tarde demais). Ela sugere tratar design e desenvolvimento como "coowners of the product experience" (coproprietários da experiência do produto) e "Establish a shared vocabulary early" (estabelecer um vocabulário comum cedo) (NN/g, Gordon, From Confrontation to Collaboration: The Developer-Designer Relationship, 2025).

Na prática: mostre os esboços a um desenvolvedor na primeira semana, pergunte o que é difícil de construir e combinem nomes para as coisas. Quando chegar a hora do "handoff", o desenvolvedor já viu o design crescer.

Uma planta arquitetônica de 1913, em branco sobre azul, com cada cômodo marcado pelo nome, como Chambre, Bain e Palier, e pelo tamanho em metros.
Cada cômodo tem o nome e o tamanho escritos, para que quem constrói nunca precise adivinhar. Um bom handoff faz o mesmo por uma interface. Cópia heliográfica, 1913, arquiteto desconhecido, Cooper Hewitt, Smithsonian Design Museum (recortada), Wikimedia Commons, domínio público.

2. O que especificar

1Estados

Vazio, carregando, erro, sucesso, desabilitado.

Não só a tela feliz
2Casos-limite

Nomes longos, sem dados, 999+ itens, sem conexão.

O que quebra o layout?
3Comportamento

O que acontece ao tocar, ao passar o mouse, depois de salvar.

Escreva em palavras
4Tokens

Espaçamento, cor e tipo pelo nome, não pelo pixel.

space-16, não "uns 16"
5Acesso

Rótulos, ordem de foco, o que o leitor de tela fala.

Decidido no design, não deixado para o código
Cinco coisas que um handoff deve responder, para que os desenvolvedores não precisem adivinhar. Diagrama: Marcus Andrey, CC BY 4.0.
  • Estados. Cada tela e componente em cada estado possível: vazio, carregando, parcial, erro, sucesso, desabilitado. Veja Estados da interface.
  • Casos-limite. O que acontece com texto muito longo, sem dados, com um item, com mil itens, com conexão lenta ou perdida, em outro idioma.
  • Comportamento. O que acontece ao tocar, ao passar o mouse, ao receber o foco, depois de salvar, depois de um erro. Escreva em palavras; uma tela estática não consegue mostrar isso.
  • Espaçamento, cor e tipografia por tokens. Dê nome à decisão ("space-16", "text-danger") em vez de medir pixels. O W3C Design Tokens Community Group descreve os tokens como "a methodology for expressing design decisions in a platform-agnostic way so that they can be shared across different disciplines, tools, and technologies" (uma metodologia para expressar decisões de design de forma independente de plataforma, para que possam ser compartilhadas entre disciplinas, ferramentas e tecnologias); o formato deles chegou à primeira versão estável em outubro de 2025 (W3C DTCG, Design Tokens specification reaches first stable version, 2025).
  • Notas de acessibilidade. Rótulos, níveis de título, ordem de foco, o que o leitor de tela deve anunciar, textos alternativos para imagens. O W3C avisa que "When accessibility is left until late in a project, the responsibility often falls on developers" (quando a acessibilidade fica para o fim do projeto, a responsabilidade costuma cair nos desenvolvedores), que acabam "selecting colors, describing images, and writing headings" (escolhendo cores, descrevendo imagens e escrevendo títulos) (W3C WAI, Accessibility Roles and Responsibilities Mapping, rascunho, atualizado em 2026).

3. Um exemplo completo

Um formulário "Salvar endereço", especificado em palavras ao lado do mock-up:

Tema O que a especificação diz
Estados Padrão; salvando (o botão mostra um indicador de carregamento e fica desabilitado); salvo (mensagem "Endereço salvo" por 4 segundos); erro (mensagem acima do formulário, os campos mantêm os valores)
Casos-limite Nomes de rua de até 120 caracteres quebram em duas linhas; o campo de CEP aceita hífen; sem conexão, mostrar "Você está sem conexão. Vamos salvar quando a conexão voltar."
Comportamento Validar cada campo quando a pessoa sai dele, não enquanto digita; Enter envia o formulário
Tokens Espaço entre campos: space-16; texto de erro: text-danger; rótulos: body-small
Acessibilidade Todo campo tem rótulo visível; as mensagens de erro ficam ligadas ao seu campo e são anunciadas; o foco vai para o primeiro campo com erro

Nada disso aparece num mock-up isolado, e tudo isso é decisão de design.


4. Ferramentas ajudam, mas não substituem a especificação

As ferramentas de design hoje têm recursos de handoff. No Figma, por exemplo, o Dev Mode é descrito como "a developer-focused workspace for inspecting designs, viewing properties and generated code, downloading assets, comparing changes, and managing design handoff" (um espaço de trabalho voltado para desenvolvedores, para inspecionar designs, ver propriedades e código gerado, baixar assets, comparar mudanças e gerenciar o handoff), e os designs podem ser marcados como "ready for dev" (prontos para desenvolvimento) (Figma Help Center, Guide to Dev Mode). O Dev Mode não está em todos os planos: a página de ajuda lista Professional, Education, Organization, Government e Enterprise. A inspeção mostra o que você desenhou; ela não mostra por quê, nem o que acontece nos estados que você não desenhou. Para escrever especificações que ferramentas de IA também consigam usar, veja Especificações de design para IA.


5. Erros comuns

  • Entregar só o caminho feliz, com dados perfeitos.
  • Medir pixels na mão em vez de nomear tokens ou componentes.
  • Deixar a acessibilidade "para o desenvolvimento".
  • Mostrar o design aos desenvolvedores pela primeira vez no handoff.
  • Tratar o handoff como o fim: não conferir a versão construída antes do lançamento.

6. Vocabulário

Termo Significado
Handoff Passar um design para quem vai construí-lo, com tudo o que a pessoa precisa
Especificação (spec) As decisões escritas por trás de um design: estados, comportamento, regras
Estado Uma condição de uma tela ou componente (vazio, carregando, erro…)
Caso-limite Uma situação incomum que pode quebrar o design
Design token Uma decisão de design com nome, como uma cor ou um valor de espaçamento
Design QA Conferir o produto construído contra o design antes do lançamento

7. Experimente (sem ferramentas)

  1. Escolha uma tela de um app que você usa: um login, uma busca, um carrinho.
  2. No papel, liste todos os estados que você acha que ela tem. Depois tente provocar cada um no app real (senha errada, busca sem resultado, carrinho vazio).
  3. Escreva três casos-limite que os designers talvez tenham esquecido, e o que deveria acontecer em cada um.

Perguntas para refletir: que estado faltava ou confundia no app real? Um desenvolvedor saberia o que fazer ali sem perguntar?


8. Se você já pratica

  • Forme dupla com um desenvolvedor por projeto desde o primeiro esboço; a NN/g sugere construir uma relação com uma pessoa do "outro" time.
  • Mantenha um checklist de handoff no seu design system e revise-o nas retrospectivas.
  • Façam o design QA juntos: sente com o desenvolvedor e teste a versão construída, inclusive com teclado e leitor de tela.

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo (em inglês)

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

Relacionadas

Estados da interface · Especificações de design para IA · O que é um design system · Fundamentos de acessibilidade · Quem faz o quê num time de produto

Salvo só neste dispositivo.

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