Skip to Content
Design

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

PapelToken RecomendadoUso
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 Controle--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ções principais e secundárias
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-radiusFormato do Card e controles
Tamanho da Fonte do Botão--button-font-size-sm, --button-font-size-md, --button-font-size-lgTipografia em nível de tamanho para botões compartilhados
Fonte--font-heading, --font-bodyTí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-surface para 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-hover no hover; estados pressionado, selecionado, atual e expandido usam a superfície de marca --control-surface-active. focus-visible adiciona --focus-ring sobre 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.

Nesta página