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
| Rol | Token recomendado | Uso |
|---|---|---|
| Fondo de página | --bg, --page-background | Color de fondo de la página y espacio general |
| Superficie de contenido | --panel, --card-surface | Paneles, tarjetas de contenido |
| Superficie de controles | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Botones, búsqueda, campos de entrada y estados de interacción |
| Superficie de capas flotantes | --dropdown-surface, --dialog-surface | Menús, Popover, Dialog |
| Bordes | --panel-border, --control-border, --input-border | Separadores y límites de estado |
| Texto | --text, --muted | Información principal y secundaria |
| Interacción de marca | --accent, --link-color, --link-hover-color | Enlaces, selección y énfasis ligero |
| Foco de teclado | --focus-ring | Estado focus-visible |
| Radio de borde | --card-radius, --button-radius, --button-pill-radius | Forma de Card y controles |
| Tamaño de fuente de botones | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Tipografía a escala para botones compartidos |
| Fuentes | --font-heading, --font-body | Tí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-surfacepara proporcionar un ligero degradado vertical, con radio de borde compartido con Card--card-radius; --accentse usa para enlaces, foco, selección y progreso, no para cubrir grandes áreas;- Los controles normales no seleccionados usan la superficie neutra
--control-surface-hoveral pasar el cursor; los estados presionado, seleccionado, actual y expandido usan el lavado de marca--control-surface-active.focus-visibleañade--focus-ringsobre 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.