Files
OllaHub/DESIGN.md
T

83 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`.