# 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`.