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.

TipoTempoObjetivoExemplo
Curta3 a 30 segundosAchar algo e sairLinktree, cardápio online
Média30 segundos a 5 minutosExplorar e decidirCatálogo, landing page
Longa5 minutos pra cimaFicar e consumirBlog, 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.

#BlocoO que éPor que importa
1IdentidadeQuem é, o que faz, pra quemVisitante precisa saber em 5 segundos
2CTA PrincipalA ação mais importanteVisitante precisa saber o que fazer primeiro
3ConteúdoO que se oferece de verdadeÉ aqui que o visitante decide
4Prova SocialDepoimentos, fotos, avaliaçõesGera confiança
5NavegaçãoComo se locomoverSem ela, o visitante fica preso
6RodapéContato, créditosOnde 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.

Quem éO que faz

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.

Uma açãoBotão visível

3. Conteúdo

Produtos, serviços, preços, fotos. Organizado por categoria. É o coração do site - onde o visitante decide.

OrganizadoVisível

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.

DepoimentosAvaliações

5. Navegação

Menu, links de categorias, âncoras. É como as placas do aeroporto - sem elas, o visitante fica perdido.

ClaraSimples

6. Rodapé

Contato, endereço, redes sociais, horário. É o cartão de visitas no balcão - quem quer mais informação vai lá.

CompletoAtualizado

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

ItemO que é
PersonalidadeQue sensação o site deve passar (caseiro, moderno, sério)
CoresAs 5 cores com a função de cada uma
TipografiaAs 2 fontes e os tamanhos
EspaçamentoA escala de espaço (8, 16, 24, 32, 48, 64)
TomComo 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.

TipoComo usarExemplo
ScreenshotsTirar print de sites que gostei"Use este layout como referência"
Trechos CSSCopiar CSS de um site que funcionou"Copie este estilo de botão"
Sites existentesApontar o link e explicar o que gostei"Adote a hierarquia visual daqui"
Paletas de corSalvar 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çãoO que fazExemplo
1PrimáriaIdentidade do siteAzul escuro, terracota
2SecundáriaComplementa a primáriaTom mais claro da primária
3FundoOnde o conteúdo viveBranco, bege claro
4TextoO que o visitante lêPreto, cinza escuro
5DestaqueAção mais importanteVerde, 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.

TokenValorQuando usar
--espaco-xs8pxEntre itens pequenos (ícone + texto)
--espaco-sm16pxEntre elementos de um card
--espaco-md24pxEntre seções próximas
--espaco-lg32pxEntre blocos maiores
--espaco-xl48pxEntre seções principais
--espaco-2xl64pxEntre 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ívelDesign AtômicoEquivalente
ÁtomosPeças unitáriasTokens CSS (cores, fontes, espaçamentos)
MoléculasCombinações de átomosBotão = cor + fonte + espaçamento
OrganismosBlocos complexos6 blocos de conteúdo
TemplatesEstrutura da páginaHTML semântico
PáginasTemplate + conteúdoO 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.