3. Directivas (@tailwind / @import), Capas (base, components, utilities) y Configuración
Estructura tu hoja de estilos principal con @tailwind base/components/utilities y personaliza colores, fuentes y plugins en tailwind.config.js.
Las Tres Directivas Sagradas de Tailwind CSS
Toda integración de Tailwind comienza con un archivo CSS de entrada (habitualmente input.css o app.css). En su interior se definen tres directivas especiales que le indican al compilador qué capas inyectar y en qué orden:
@tailwind base;
@tailwind components;
@tailwind utilities;
1. @tailwind base
Inyecta el Preflight: un reseteo de estilos estricto basado en modern-normalize que elimina márgenes por defecto en encabezados, resetea listas y estandariza botones en todos los navegadores.
2. @tailwind components
Inyecta clases complejas de componentes provistas por plugins oficiales o definidas manualmente mediante la directiva @layer components.
3. @tailwind utilities
Inyecta todas las clases atómicas generadas bajo demanda por el motor JIT (espaciados, colores, flex, grid, etc.), asegurando que tengan mayor especificidad.
Anatomía de tailwind.config.js
El archivo de configuración principal gobierna tres aspectos cruciales de tu arquitectura:
content(Fundamental): Una matriz de rutas glob que le indica al compilador qué archivos PHP, HTML o JS escanear en busca de nombres de clases. ¡Si olvidas una ruta aquí, esas clases no se compilarán en tu CSS final!theme.extend: Permite agregar tus propios colores corporativos, tipografías personalizadas o espaciados sin sobreescribir la paleta por defecto de Tailwind.plugins: Registra extensiones como formularios, tipografía y relaciones de aspecto.
La Regla de Oro: Extender vs Sobrescribir
Ten mucho cuidado al modificar la propiedad theme. Si defines theme: { colors: { azul: '#00f' } } fuera de extend, reemplazarás por completo todos los colores nativos de Tailwind (red, slate, emerald, etc.). Coloca siempre tus agregados dentro de theme: { extend: { ... } } para conservar todo el ecosistema base.
⚡ Archivo Completo de Configuración tailwind.config.js para un Proyecto PHP/Laravel
Configuración estándar optimizada con escaneo de vistas Blade/PHP, colores de marca y fuentes:
/** @type {import('tailwindcss').Config} */
module.exports = {
// Rutas donde Tailwind buscará clases utilizadas para purgar en producción
content: [
"./app/views/**/*.php",
"./resources/**/*.blade.php",
"./resources/**/*.js",
"./public/**/*.html",
],
// Activa el modo oscuro mediante la presencia de la clase 'dark' en la etiqueta <html>
darkMode: 'class',
theme: {
extend: {
colors: {
// Colores de identidad de Kilopolis
brand: {
50: '#ecfeff',
100: '#cffafe',
500: '#06b6d4',
600: '#0891b2',
900: '#164e63',
},
},
fontFamily: {
sans: ['Inter', 'system-ui', '-apple-system', 'sans-serif'],
mono: ['Fira Code', 'monospace'],
},
},
},
plugins: [],
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué sucede si defines colores personalizados en "theme: { colors: { ... } }" en lugar de "theme: { extend: { colors: { ... } } }"?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Tailwind CSS: Framework Utility-First Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.