CodeForge

Maquetación Web Dinámica / Arquitectura CSS y design tokens

De tus tokens a Tailwind: el mismo sistema

Teoría18 min20 XP

Aquí viene la revelación del módulo: el sistema de tokens que acabas de construir a mano ES, casi exactamente, la configuración de Tailwind. Cuando llegues al curso de Tailwind no vas a aprender un concepto nuevo — vas a reconocer TU sistema, aplicado de otra forma. Entender esto ahora convierte Tailwind de "clases raras en el HTML" a "mis tokens, con superpoderes".

La misma cocina, ya organizada

Utility-first: los tokens, aplicados en el HTML

En vez de escribir una clase de componente que lee tokens, Tailwind te da UTILIDADES —una clase por decisión— que aplicas directo:

tu-css.css
/* TU enfoque: una clase de componente que usa tokens */
.boton {
padding: var(--espacio-3);        /* 16px */
background: var(--color-primary); /* violeta */
border-radius: var(--radio-md);   /* 12px */
font-weight: 600;
}
tailwind.html
<!-- TAILWIND: las MISMAS decisiones, como utilidades en el HTML -->
<button class="p-4 bg-violet-600 rounded-xl font-semibold">Acción</button>
<!-- p-4 = padding de la escala · bg-violet-600 = color de la paleta · rounded-xl = radio -->

Cada utilidad (p-4, bg-violet-600, rounded-xl) es UN token aplicado. p-4 no es "16px mágicos": es el paso 4 de la escala de espaciado —la MISMA escala base-4 que definiste—. No hay valores sueltos: si no está en el sistema, no hay clase para él.

Tu sistema ES el theme de Tailwind

Y aquí está el puente literal: la configuración de Tailwind (theme) es un sistema de tokens idéntico al tuyo, solo que en un objeto de JavaScript:

tailwind.config.js
export default {
theme: {
  extend: {
    colors: { primary: "#6d28d9" },        // ← tu --color-primary
    spacing: { /* escala base 4 */ },       // ← tu --espacio-1..6
    borderRadius: { xl: "12px" },           // ← tu --radio-md
    fontSize: { xl: "28px" },               // ← tu --texto-xl
  },
},
};

Definir el theme de Tailwind es exactamente el ejercicio que hiciste en la lección 3: decidir tu paleta, tus escalas, tus radios. La diferencia es que Tailwind genera las UTILIDADES a partir de ese theme y las aplicas en el HTML. Por eso quien entiende tokens aprende Tailwind en una tarde: ya tiene la mentalidad; solo cambia la sintaxis de aplicación.

El trade-off, con honestidad

En Tailwind escribes la clase p-4 en un botón. ¿Qué representa realmente ese p-4?

Mini-reto

Toma la tarjeta de tokens que construiste en la lección 3 y "tradúcela" mentalmente a Tailwind: por cada declaración que usa un token, escribe al lado qué utilidad sería (background: var(--color-primary)bg-primary; padding: var(--espacio-4)p-6, etc.). No necesitas Tailwind instalado — el ejercicio es VER que tu sistema y sus utilidades son la misma cosa. Llegarás al curso de Tailwind reconociendo tu propio trabajo.

Qué sigue

Cierras el módulo de arquitectura con el reto que lo une todo: tomar la landing con scrollytelling que construiste con GSAP en el módulo 16 y darle un sistema de tokens completo con tema claro/oscuro. De una landing con valores a mano a una con arquitectura de diseño real.