style(ui): família visual de IA local
This commit is contained in:
1 parent
f0b7db8c12
commit
07b0eaadca
62 files changed
+918
-853
No files matched your search
@@ -0,0 +1,82 @@
|
||||
# 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`.
|
||||
Reference in new issue
Block a user