Skip to Content
Diseño

Fundamentos visuales y Tokens

Contrato público de uso de los colores de marca, tipografías, espaciados, radios de borde y Tokens semánticos de Qokit.

Fundamentos visuales y Tokens

La interfaz de la plataforma Qokit utiliza un sistema de azules claro, profesional y contenido. Los desarrolladores deben adaptar el tema mediante Tokens semánticos, sin copiar valores de color, sombras, radios de borde o fuentes en los componentes de negocio.

Roles principales

RolToken recomendadoUso
Fondo de página--bg, --page-backgroundColor de fondo de la página y espacio general
Superficie de contenido--panel, --card-surfacePaneles, tarjetas de contenido
Superficie de controles--control-surface, --control-surface-hover, --control-surface-active, --input-surfaceBotones, búsqueda, campos de entrada y estados de interacción
Superficie de capas flotantes--dropdown-surface, --dialog-surfaceMenús, Popover, Dialog
Bordes--panel-border, --control-border, --input-borderSeparadores y límites de estado
Texto--text, --mutedInformación principal y secundaria
Interacción de marca--accent, --link-color, --link-hover-colorEnlaces, selección y énfasis ligero
Foco de teclado--focus-ringEstado focus-visible
Radio de borde--card-radius, --button-radius, --button-pill-radiusForma de Card y controles
Tamaño de fuente de botones--button-font-size-sm, --button-font-size-md, --button-font-size-lgTipografía a escala para botones compartidos
Fuentes--font-heading, --font-bodyTítulos y cuerpo/control

Tipografía

  • Space Grotesk se usa para títulos de marca, títulos de página y números clave;
  • Manrope se usa para cuerpo de texto, botones, formularios, tablas y áreas de trabajo;
  • El área de trabajo mantiene un diseño compacto, sin usar títulos grandes de escala de páginas de marketing;
  • El chino no aumenta el espaciado entre letras al estilo inglés, y las traducciones largas no comprimen las acciones adyacentes.

Espaciado y dimensiones

  • Utilizar ritmo de 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
  • La altura mínima de clic para controles compactos es de 40px;
  • La altura estándar de las acciones es de 44px, y las acciones principales en móvil no deben ser inferiores a 44px;
  • Los botones compartidos utilizan tamaños de texto de 14px, 15px y 16px respectivamente según sm, md, lg, sin heredar el tamaño de fuente del contenedor;
  • El ancho del contenido de la plataforma generalmente no supera los 1160px, y el contenido de sitios generados no suele superar los 1120px.

Reglas de tema

  • Los temas claro y oscuro deben reutilizar los mismos Tokens semánticos;
  • Los Dialog normales utilizan --dialog-surface para proporcionar un ligero degradado vertical, con radio de borde compartido con Card --card-radius;
  • --accent se usa para enlaces, foco, selección y progreso, no para cubrir grandes áreas;
  • Los controles normales no seleccionados usan la superficie neutra --control-surface-hover al pasar el cursor; los estados presionado, seleccionado, actual y expandido usan el lavado de marca --control-surface-active. focus-visible añade --focus-ring sobre la superficie neutra; los inputs con foco o activos mantienen sus Tokens de estado;
  • Los colores de estado solo expresan éxito, advertencia y peligro;
  • Los sitios generados pueden sobrescribir variables de tema, pero deben mantener el contraste del cuerpo de texto y una jerarquía clara de CTA.

En esta página