4.9 KiB
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
- Ferramenta local, sem cerimônia: o conteúdo (conversa, modelo) domina e o cromo some.
- 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.
- 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(usanext/font/local; o app roda offline). Fallback: system-ui / ui-monospace. - Escala 1,2 com base 14 px:
text-xs12 ·text-sm14 ·text-lg17 ·text-xl20 ·text-2xl24 ·text-3xl29. 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-sm6 (chip, badge),rounded-md8 (botão, input),rounded-lg/rounded-xl12 (painel, card de mensagem, diálogo),rounded-fullsó 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.