Fundamentos Visuais e Tokens
Contrato público de uso das cores da marca Qokit, tipografia, espaçamento, cantos arredondados e Tokens semânticos.
Fundamentos Visuais e Tokens
A interface da plataforma Qokit utiliza um sistema de azul claro, profissional e contido. Os desenvolvedores devem adaptar o tema por meio de Tokens semânticos, não copiando valores de cor, sombras, cantos arredondados ou fontes nos componentes de negócios.
Papéis Centrais
| Papel | Token Recomendado | Uso |
|---|---|---|
| Fundo da Página | --bg, --page-background | Cor de fundo da página e espaço geral |
| Superfície de Conteúdo | --panel, --card-surface | Painéis, cartões de conteúdo |
| Superfície de Controle | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Botões, pesquisa, campos de entrada e estados de interação |
| Superfície Flutuante | --dropdown-surface, --dialog-surface | Menu, Popover, Dialog |
| Bordas | --panel-border, --control-border, --input-border | Separação e limites de estado |
| Texto | --text, --muted | Informações principais e secundárias |
| Interação da Marca | --accent, --link-color, --link-hover-color | Links, seleção e destaque leve |
| Foco do Teclado | --focus-ring | Estado focus-visible |
| Cantos Arredondados | --card-radius, --button-radius, --button-pill-radius | Formato do Card e controles |
| Tamanho da Fonte do Botão | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Tipografia em nível de tamanho para botões compartilhados |
| Fonte | --font-heading, --font-body | Títulos e corpo/texto/controles |
Tipografia
- Space Grotesk para títulos da marca, títulos de página e números-chave;
- Manrope para corpo de texto, botões, formulários, tabelas e área de trabalho;
- A área de trabalho mantém-se compacta, sem usar títulos grandes de escala de páginas de marketing;
- O chinês não aumenta o espaçamento entre letras ao estilo inglês, e traduções longas não comprimem operações adjacentes.
Espaçamento e Dimensões
- Utilize ritmo de 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- A altura de clique de controles compactos não deve ser inferior a 40px;
- A altura padrão dos botões é 44px, e as ações principais no mobile não devem ser inferiores a 44px;
- Botões compartilhados usam textos de 14px, 15px e 16px respectivamente com
sm,md,lg, sem herdar o tamanho da fonte do container; - A largura do conteúdo da plataforma geralmente não excede 1160px, e o conteúdo do site gerado geralmente não excede 1120px.
Regras de Tema
- Os temas claro e escuro devem reutilizar os mesmos Tokens semânticos;
- Diálogos comuns utilizam
--dialog-surfacepara fornecer um leve gradiente vertical, com cantos arredondados compartilhados com o Card--card-radius; --accenté usado para links, foco, seleção e progresso, não para preenchimento de grande área;- Controles comuns não selecionados usam a superfície neutra
--control-surface-hoverno hover; estados pressionado, selecionado, atual e expandido usam a superfície de marca--control-surface-active.focus-visibleadiciona--focus-ringsobre a superfície neutra; inputs em foco ou ativos mantêm seus Tokens de estado; - As cores de estado expressam apenas sucesso, aviso e perigo;
- Sites gerados podem sobrescrever variáveis de tema, mas devem manter o contraste do corpo do texto e uma hierarquia clara de CTA.