Fundamentos Visuais e Tokens
Contrato público de uso das cores da marca Qokit, tipografia, espaçamentos, 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 através de tokens semânticos, não copiando valores de cor, sombras, cantos arredondados ou fontes nos componentes de negócio.
Papéis Centrais
| Papel | Token Recomendado | Utilização |
|---|---|---|
| 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 Controlo | --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ção principal e secundária |
| 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 | Forma do Card e dos controlos |
| Tamanho da Fonte do Botão | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Tipografia em escala de tamanho para botões partilhados |
| Fonte | --font-heading, --font-body | Títulos e corpo/texto/controlos |
Tipografia
- Space Grotesk é usado para títulos da marca, títulos de página e números chave;
- Manrope é usado para corpo de texto, botões, formulários, tabelas e áreas de trabalho;
- A área de trabalho mantém-se compacta, sem usar títulos grandes na escala de páginas de marketing;
- O chinês não aumenta o espaçamento entre letras ao estilo inglês; traduções longas não devem comprimir operações adjacentes.
Espaçamento e Dimensões
- Utilize um ritmo de 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- A altura de clique de controlos compactos não deve ser inferior a 40px;
- A altura padrão da ação é 44px; a ação principal móvel não deve ser inferior a 44px;
- Os botões partilhados utilizam respetivamente 14px, 15px e 16px de texto para
sm,mdelg, sem herdar o tamanho da fonte do seu container; - A largura do conteúdo da plataforma geralmente não excede 1160px; 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 normais utilizam
--dialog-surfacepara fornecer um gradiente vertical ligeiro, com cantos arredondados partilhados com o Card usando--card-radius; --accenté usado para links, foco, seleção e progresso, não sendo usado para preenchimento de grandes áreas;- Os controlos comuns não selecionados usam a superfície neutra
--control-surface-hoverno hover; os estados premido, selecionado, atual e expandido usam a superfície de marca--control-surface-active.focus-visibleadiciona--focus-ringsobre a superfície neutra; os campos em foco ou ativos mantêm os Tokens de estado de entrada; - As cores de estado expressam apenas sucesso, aviso e perigo;
- Os sites gerados podem substituir as variáveis de tema, mas devem manter o contraste do corpo de texto e uma hierarquia clara de CTA.