Encontro 06 - Rede Daora
UI/UX: Design System
Design.md · Design Tokens
01
Diferentes Experiências
Seção 01 · Espectro
O espectro de experiências
Nem toda experiência precisa ser rápida. Nem toda precisa ser demorada. Existe um espectro - e o jeito que eu projeto o site muda dependendo de onde meu site tá nele.
| Tipo | Tempo | Objetivo | Exemplo |
|---|---|---|---|
| Curta | 3 a 30 segundos | Achar algo e sair | Linktree, cardápio online |
| Média | 30 segundos a 5 minutos | Explorar e decidir | Catálogo, landing page |
| Longa | 5 minutos pra cima | Ficar e consumir | Blog, curso, rede social |
Regra: eu projeto o site de acordo com o tipo de experiência que o visitante espera ter.
Seção 01 · Analogias
Experiências são contextos
Corredor
Experiência curta. Não tem nada pra ver, só pra passar. Um linktree é um corredor: entro, acho a porta, saio.
Loja
Experiência média. Preciso de organização, preços visíveis, caixa acessível. Um catálogo é uma loja.
Biblioteca
Experiência longa. Preciso de categorias, catalogação, conforto. Um blog é uma biblioteca.
Aeroporto
Experiência longa com muitos pontos de decisão. Precisa de sinalização forte e informação clara.
02
Os 6 blocos de conteúdo
Seção 02 · Visão geral
Quais são os blocos de conteúdo
Todo site de experiência média precisa por volta de 6 blocos pra funcionar bem.
| # | Bloco | O que é | Por que importa |
|---|---|---|---|
| 1 | Identidade | Quem é, o que faz, pra quem | Visitante precisa saber em 5 segundos |
| 2 | CTA Principal | A ação mais importante | Visitante precisa saber o que fazer primeiro |
| 3 | Conteúdo | O que se oferece de verdade | É aqui que o visitante decide |
| 4 | Prova Social | Depoimentos, fotos, avaliações | Gera confiança |
| 5 | Navegação | Como se locomover | Sem ela, o visitante fica preso |
| 6 | Rodapé | Contato, créditos | Onde vai quem quer mais info |
Seção 02 · Identidade, CTA, Conteúdo
Blocos 1, 2 e 3
1. Identidade
Nome, frase curta, foto. Em 5 segundos o visitante precisa saber se é pra ele. É a fachada da loja.
2. CTA Principal
UM botão grande e visível. Texto claro do que acontece quando clica. É o caixa da loja - precisa ser fácil de achar.
3. Conteúdo
Produtos, serviços, preços, fotos. Organizado por categoria. É o coração do site - onde o visitante decide.
Seção 02 · Prova Social, Navegação, Rodapé
Blocos 4, 5 e 6
4. Prova Social
Depoimentos, avaliações, número de clientes. É o que gera confiança - "outros compraram e gostaram". É a fila do restaurante.
5. Navegação
Menu, links de categorias, âncoras. É como as placas do aeroporto - sem elas, o visitante fica perdido.
6. Rodapé
Contato, endereço, redes sociais, horário. É o cartão de visitas no balcão - quem quer mais informação vai lá.
03
Consistência visual
Seção 03 · Definição
O que é consistência
Consistência é quando todas as páginas do site parecem ser do mesmo lugar. Mesmas cores, mesmas fontes, mesmo estilo.
Sem consistência
- Cada página parece um site diferente
- Visitante se perde entre páginas
- Parece amadorismo
- Cores e fontes mudam o tempo todo
Com consistência
- Todo o site parece um só
- Visitante se sente em "casa"
- Parece profissionalismo
- Cores e fontes são previsíveis
Seção 03 · Tokens intro
CSS com variáveis
A consistência vem de definir uma vez só as regras visuais e aplicar em todas as páginas. CSS com variáveis faz isso.
:root {
--cor-principal: #1a365d;
--cor-fundo: #ffffff;
--cor-texto: #333333;
--fonte-titulo: 'Montserrat', sans-serif;
--fonte-corpo: 'Open Sans', sans-serif;
}Variáveis CSS são como uma receita central: defino as cores e fontes uma vez, e todas as páginas usam as mesmas.
04
Documento de especificação
Seção 04 · Definição
O que é o design.md
O design.md é um documento que guarda as decisões de design do site. Não é código - é um arquivo de texto que explica por que o site é de um jeito.
Sem design.md
- Decisões ficam na minha cabeça
- Cada prompt a IA "reinventa" o estilo
- Explico o design de novo toda vez
Com design.md
- Tudo registrado num arquivo
- A IA segue o mesmo arquivo sempre
- Todo o site fica no mesmo padrão
Tokens CSS são o prato servido: o que o navegador mostra. O design.md é a receita escrita: o documento que explica como e por quê.
Seção 04 · Conteúdo
O que vai dentro do design.md
| Item | O que é |
|---|---|
| Personalidade | Que sensação o site deve passar (caseiro, moderno, sério) |
| Cores | As 5 cores com a função de cada uma |
| Tipografia | As 2 fontes e os tamanhos |
| Espaçamento | A escala de espaço (8, 16, 24, 32, 48, 64) |
| Tom | Como o site "fala" com o visitante |
Seção 04 · Referências
Materiais de referência
O design.md pode incluir materiais de referência - coisas que eu encontrei e quero usar como inspiração.
| Tipo | Como usar | Exemplo |
|---|---|---|
| Screenshots | Tirar print de sites que gostei | "Use este layout como referência" |
| Trechos CSS | Copiar CSS de um site que funcionou | "Copie este estilo de botão" |
| Sites existentes | Apontar o link e explicar o que gostei | "Adote a hierarquia visual daqui" |
| Paletas de cor | Salvar os hex das cores | "Use estas 5 cores com estas funções" |
Seção 04 · Exemplo
Exemplo de design.md
# Design - Catálogo Artesanal
## Personalidade
Caseiro, acolhedor, honesto.
## Cores
- Primária: terracota #C67A4B
- Secundária: bege #F5F0EB
- Fundo: branco suave #FAFAF8
- Texto: marrom escuro #3D2B1F
- Destaque: verde escuro #2d6a4f
## Tipografia
- Títulos: Montserrat (bold)
- Corpo: Open Sans
## Espaçamento
Escala de 8: 8, 16, 24, 32, 48, 64
## Tom
Fala como um artesão conversando com o cliente na feira.05
Design Tokens
Seção 05 · Cores
As 5 cores com função
Todo site precisa de 5 cores com função definida. Não é escolher "gosto de azul" - é definir o papel de cada cor.
| # | Função | O que faz | Exemplo |
|---|---|---|---|
| 1 | Primária | Identidade do site | Azul escuro, terracota |
| 2 | Secundária | Complementa a primária | Tom mais claro da primária |
| 3 | Fundo | Onde o conteúdo vive | Branco, bege claro |
| 4 | Texto | O que o visitante lê | Preto, cinza escuro |
| 5 | Destaque | Ação mais importante | Verde, laranja |
Seção 05 · Espaços
A escala de espaçamento
Espaçamento segue uma escala fixa: 8, 16, 24, 32, 48, 64. Cada número é múltiplo de 8.
| Token | Valor | Quando usar |
|---|---|---|
--espaco-xs | 8px | Entre itens pequenos (ícone + texto) |
--espaco-sm | 16px | Entre elementos de um card |
--espaco-md | 24px | Entre seções próximas |
--espaco-lg | 32px | Entre blocos maiores |
--espaco-xl | 48px | Entre seções principais |
--espaco-2xl | 64px | Entre header e conteúdo |
Regra: se o espaço tá estranho, arredonda pra múltiplo de 8. Nunca use 13px ou 27px.
Seção 05 · :root
Tokens no CSS
:root {
/* === CORES === */
--cor-primaria: #C67A4B;
--cor-secundaria: #F5F0EB;
--cor-fundo: #FAFAF8;
--cor-texto: #3D2B1F;
--cor-destaque: #2d6a4f;
/* === TIPOGRAFIA === */
--fonte-titulo: 'Montserrat', sans-serif;
--fonte-corpo: 'Open Sans', sans-serif;
/* === ESPAÇAMENTO === */
--espaco-xs: 8px;
--espaco-sm: 16px;
--espaco-md: 24px;
--espaco-lg: 32px;
--espaco-xl: 48px;
--espaco-2xl: 64px;
}Se eu quiser trocar a cor primária, mudo UMA linha eTODO o site muda.
06
Design Atômico
Seção 06 · Design Atômico
Como tudo se encaixa
Design Atômico organiza um design system em camadas - do mais simples ao mais complexo. Cada camada depende da anterior.
| Nível | Design Atômico | Equivalente |
|---|---|---|
| Átomos | Peças unitárias | Tokens CSS (cores, fontes, espaçamentos) |
| Moléculas | Combinações de átomos | Botão = cor + fonte + espaçamento |
| Organismos | Blocos complexos | 6 blocos de conteúdo |
| Templates | Estrutura da página | HTML semântico |
| Páginas | Template + conteúdo | O site final |
Troco uma cor no design.md → o token muda → a molécula muda → o organismo muda → a página muda. Tudo conectado.
07
Prompts
Seção 07 · Prompts
3 prompts pra criar o design system
Prompt 1
"Crie um arquivo design.md descrevendo o design deste site. Inclua: identidade, cores com hex, tipografia, espaçamentos, componentes."
Prompt 2
"Leia o design.md e gere um bloco CSS com variáveis :root contendo todos os Design Tokens definidos."
Prompt 3
"Revise este design.md e verifique: cores com hex? Espaçamentos em múltiplos de 8? Fontes com pesos e tamanhos?"
Links úteis
Referências
MDN Web Docs
Documentação de tags semânticas HTML5 e acessibilidade.
Nielsen Norman Group
Artigos sobre Experiência do Usuário (inglês).
Can I Use
Compatibilidade de recursos HTML/CSS entre navegadores.
OpenCode
Ferramenta de IA pra programação.
OpenDesign
Ferramenta open-source que usa design.md pra gerar protótipos.