Skip to Content
Design

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

PapelToken RecomendadoUtilização
Fundo da Página--bg, --page-backgroundCor de fundo da página e espaço geral
Superfície de Conteúdo--panel, --card-surfacePainéis, cartões de conteúdo
Superfície de Controlo--control-surface, --control-surface-hover, --control-surface-active, --input-surfaceBotões, pesquisa, campos de entrada e estados de interação
Superfície Flutuante--dropdown-surface, --dialog-surfaceMenu, Popover, Dialog
Bordas--panel-border, --control-border, --input-borderSeparação e limites de estado
Texto--text, --mutedInformação principal e secundária
Interação da Marca--accent, --link-color, --link-hover-colorLinks, seleção e destaque leve
Foco do Teclado--focus-ringEstado focus-visible
Cantos Arredondados--card-radius, --button-radius, --button-pill-radiusForma do Card e dos controlos
Tamanho da Fonte do Botão--button-font-size-sm, --button-font-size-md, --button-font-size-lgTipografia em escala de tamanho para botões partilhados
Fonte--font-heading, --font-bodyTí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, md e lg, 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-surface para 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-hover no hover; os estados premido, selecionado, atual e expandido usam a superfície de marca --control-surface-active. focus-visible adiciona --focus-ring sobre 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.

Nesta página