Durante años fui un detractor de Tailwind. El argumento del tipo “es feo ver clases enormes en el HTML” me parecía razonable. Hasta que un proyecto real me obligó a usarlo y entendí lo que estaba mal en mi razonamiento: estaba confundiendo la estética del código con la productividad real del trabajo.
El argumento equivocado
“Clases utilitarias ensucian el HTML” — sí, pero ya está ensuciado por class="btn btn-primary btn-large". La diferencia es que con Tailwind no necesitas abrir tres archivos (button.css, variants.css, layout.css) para entender qué estilos tiene un botón. Lo ves en el sitio, en el elemento, sin cambiar de contexto.
<!-- Lo que tenías antes -->
<button class="btn btn-primary btn-lg">
<!-- Lo que tienes con Tailwind -->
<button class="px-4 py-2 rounded-md bg-teal-500 text-white font-semibold hover:-translate-y-0.5 transition-transform">
Las clases son más largas, sí. Pero también son auto-explicativas y no requieren mantener un diccionario de componentes paralelo.
Extracción de tokens de un sitio de referencia
Para este blog quise replicar la estética de craftzdog/craftzdog-homepage. El repo está en Next.js + Chakra UI, así que no podía copiar clases directamente. Lo que sí podía hacer era extraer los tokens de diseño del archivo lib/theme.js:
const styles = {
global: props => ({
body: { bg: mode('#f0e7db', '#202023')(props) }
})
}
const colors = { grassTeal: '#88ccca' }
const fonts = { heading: "'M PLUS Rounded 1c'" }
Y traducirlos directamente a mi tailwind.config.mjs:
colors: {
surface: {
light: '#f0e7db',
dark: '#202023',
},
grassTeal: '#88ccca',
link: {
light: '#3d7aed',
dark: '#ff63c3',
},
},
fontFamily: {
heading: ['"M PLUS Rounded 1c"', 'system-ui', 'sans-serif'],
},
borderRadius: {
craftz: '12px', // radio característico de las imágenes del sitio
},
Con eso, las clases bg-surface-light, text-link-dark, rounded-craftz o bg-grassTeal ya están disponibles en todo el proyecto y mantienen la coherencia visual con la referencia.
Dark mode con class strategy
Para el toggle de tema dark/light usé la estrategia class de Tailwind. Un script inline en el <head> define la clase dark en <html> antes del primer paint, evitando el temido “flash” de tema equivocado:
<script is:inline>
(function () {
const stored = localStorage.getItem('theme');
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
document.documentElement.classList.toggle('dark', stored === 'dark' || (!stored && prefersDark));
})();
</script>
Y las variantes dark: en las clases hacen el resto. Sin CSS custom, sin JavaScript extraño, sin frameworks de tema.
Imágenes Markdown con el radio correcto
Una de las cosas que más me gustó del sitio de craftzdog es el border-radius: 12px consistente en todas las imágenes. Para que el contenido Markdown también lo respetara, agregué una regla global en mi CSS sobre la capa prose:
.prose :where(img) {
@apply rounded-craftz;
@apply border border-black/5 dark:border-white/10;
}
Así, cada vez que inserto una imagen en un artículo Markdown, hereda automáticamente el radio característico del diseño.
Conclusión
Tailwind no es una solución universal, pero para proyectos medianos como un blog personal, su productividad es difícil de batir. La clave está en configurarlo bien desde el principio: extraer los tokens de tu referencia, definirlos en tailwind.config.mjs, y dejar que las clases utilitarias hagan el resto.