Sistema de diseño · v2

Un sistema, una fuente.

Todo lo que ves en esta página se genera desde design/tokens.json y src/styles/components.css. Ningún valor está escrito a mano aquí, así que esta documentación no puede quedar desactualizada respecto del código que se despliega.

Arquitectura de tokens

Tres capas. Cada una solo puede referenciar a la anterior. La regla que sostiene el sistema: los componentes nunca consumen primitivos.

1 · Primitivo

La paleta cruda: color.ink.900, space.5. Sin significado asignado. No se usa en UI.

2 · Semántico

El rol: semantic.fg.default. Describe la función, no el color. Esta es la capa que se usa.

3 · Componente

Decisiones de una pieza concreta: component.button.primary-bg. Solo cuando el valor define el contrato visual del componente.

Por qué importa

El build emite los alias como var(), no como el valor plano. Es decir, --ak-semantic-bg-canvas: var(--ak-color-ink-0). Cambiar un primitivo reencamina toda la cascada en runtime, sin recompilar.

Color

Blanco domina. El negro es acción. El rojo es puntuación: si ocupa más del ~5% de una pantalla, sobra. Cada muestra indica su contraste sobre blanco.

Roles semánticos

La flecha indica a qué primitivo apunta cada rol. Esta indirección es el motivo por el que la marca puede cambiar de color sin tocar un componente.

Tipografía

Escala fluida con clamp(): no hay una sola media query de tipografía en el sitio. Redimensiona la ventana y observa. El valor que se muestra es la referencia desktop, que es la que importa Figma.

Reglas

A mayor tamaño, menor peso y tracking más negativo. Los titulares van en weight.medium (500), nunca en bold. El leading.tight es 0.95: bajo 1, para que las líneas del h1 se traben entre sí.

Espaciado

Escala base 4px. En un sitio minimalista el espaciado es el diseño: nunca inventes un valor fuera de esta escala.

Los dos tokens fluidos

space.section gobierna el ritmo vertical de toda sección y space.gutter el margen lateral de todo contenedor. Dos tokens gobiernan la respiración del sitio entero.

Componentes

Render en vivo, más el HTML y el CSS real de cada pieza — extraído de components.css durante el build, no copiado a mano. La pestaña «Tokens» lista lo que consume cada componente.

Iconografía

Lucide — ~1600 iconos SVG de trazo, licencia ISC. El trazo va en 1.5 y no en el 2 por defecto: acompaña la tipografía de peso medium del sistema. Cada icono hereda currentColor, así que nunca se le pinta un color a mano. Haz clic en un nombre para copiar su markup. Ver design/ICONS.md.

Tabla de tokens

El mapa completo: nombre del token, variable CSS, valor resuelto y su lugar en la arquitectura. Generada desde tokens.json en cada build.

Token Variable CSS Valor Capa Descripción / uso recomendado