Files
OllaHub/DESIGN.md
T

4.9 KiB
Raw Blame History

OllaHub — sistema visual

Derivado de specs/DESIGN-familia.md (família visual dos apps de IA local, 2026-11-16). Em caso de dúvida, a família manda.

Leitura: refino · Operate · web (Next 16 + Tailwind v4 + shadcn). Identidade, comportamento, copy e layout continuam os mesmos: muda o sistema, não a estrutura das telas.

Princípios

  1. Ferramenta local, sem cerimônia: o conteúdo (conversa, modelo) domina e o cromo some.
  2. Acento num lugar só por tela: ação primária, foco, item ativo e o indicador de "gerando". Nunca em fundo grande, gradiente ou decoração.
  3. Dados técnicos (modelo, endpoint, porta, tokens, tempo) em mono; todo o resto em sans.

Cor (OKLCH)

Neutros com leve tom frio, matiz 265.

Papel Escuro (padrão) Claro
bg oklch(0.16 0.008 265) oklch(0.99 0.003 265)
surface oklch(0.20 0.009 265) oklch(0.97 0.004 265)
elevated (menu, modal) oklch(0.24 0.010 265) oklch(1 0 0)
hover oklch(0.28 0.010 265) oklch(0.94 0.005 265)
border oklch(0.32 0.010 265) oklch(0.90 0.006 265)
text oklch(0.96 0.004 265) oklch(0.20 0.010 265)
text-2 oklch(0.76 0.008 265) oklch(0.42 0.010 265)
text-3 (rótulo, meta) oklch(0.64 0.010 265) oklch(0.54 0.010 265)
success oklch(0.74 0.15 150) oklch(0.52 0.14 150)
warning oklch(0.82 0.15 85) oklch(0.60 0.13 75)
danger oklch(0.68 0.19 25) oklch(0.55 0.20 25)

Acento (accent-fg = texto sobre o acento; accent-soft = acento a 14% sobre bg, misturado em oklab para não desviar o matiz, usado em seleção e item ativo):

accent escuro accent claro accent-fg Origem
oklch(0.80 0.16 70) âmbar oklch(0.62 0.15 60) oklch(0.20 0.04 60) o #FE9A00 do OllaHubBackend

Contraste: text-3 sobre bg e surface ≥ 4,5:1; accent-fg sobre accent ≥ 4,5:1.

Tipografia

  • Geist e Geist Mono, empacotadas localmente pelo pacote geist (usa next/font/local; o app roda offline). Fallback: system-ui / ui-monospace.
  • Escala 1,2 com base 14 px: text-xs 12 · text-sm 14 · text-lg 17 · text-xl 20 · text-2xl 24 · text-3xl 29. Corpo 14; mensagem do usuário 17.
  • Pesos: 400 corpo, 500 rótulo de controle, 600 título. Sem caixa alta em rótulo. Entrelinha 1,5 no corpo, 1,25 nos títulos. Mensagens até 72ch.

Espaço, raio, sombra

  • Espaçamento só da escala 4 · 8 · 12 · 16 · 20 · 24 · 32 · 40 · 48 · 64.
  • Raio: rounded-sm 6 (chip, badge), rounded-md 8 (botão, input), rounded-lg/rounded-xl 12 (painel, card de mensagem, diálogo), rounded-full só em avatar, ponto e pill de status.
  • Sombra só no que flutua (menu, popover, modal, toast): shadow-float = 0 1px 2px oklch(0.10 0.01 265 / 0.30), 0 8px 24px oklch(0.10 0.01 265 / 0.35). Cards e painéis usam borda.

Estados

hover (bg-hover), foco visível (outline de 2 px em accent com 2 px de offset), ativo/selecionado (bg-accent-soft + text-foreground), desabilitado (opacidade 0,45, sem hover), carregando/gerando (spinner/barra em text-primary/bg-primary, prefers-reduced-motion respeitado), vazio (frase com o próximo passo), erro (text-destructive com causa e ação).

Movimento

150–200 ms, ease-out (--ease-out), só opacidade e transform. Sem animação decorativa, sem transition-all, sem transição de largura.

Fora

Gradiente decorativo, glow, glassmorphism (backdrop-blur), sombra em card, emoji como ícone, o mesmo raio em tudo, cinza neutro puro, cores de paleta fixas (green-500, blue-500…).

Mapa de tokens (migração shadcn → família)

Os papéis da família são variáveis CSS em app/globals.css; os nomes do shadcn apontam para eles, sem alias extra.

shadcn / antigo Papel da família
background bg
foreground text
card surface
popover elevated
primary accent
primary-foreground accent-fg
secondary hover
muted surface
muted-foreground text-3
destructive danger
border, input border
ring accent
accent antigo (fundo de hover do shadcn) hover (bg-hover); accent agora é o acento da família
accent-foreground removido; usar text-foreground
sidebar-* removidos; a lista usa surface/border/hover/text
chart-*, message-* removidos (exceto message-high-contrast)
--radius removido; radius-sm/md/lg/xl = 6/8/12/12 (lg era 10, xl era 14)
tamanhos de texto ajustados à escala 12/14/17/20/24/29; text-[10px] → text-xs
fonte next/font/google → pacote geist (local)
green/red/yellow/orange/blue-* success / danger / warning / neutro ou accent-soft
bg-black/50 em overlays bg-scrim

Utilitários novos do tema: bg-surface, bg-elevated, bg-hover, text-text-2, text-success, text-warning, bg-accent-soft, text-accent-fg, bg-scrim, shadow-float.