Tema 3 · Configuración & Directivas

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:

  1. 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!
  2. theme.extend: Permite agregar tus propios colores corporativos, tipografías personalizadas o espaciados sin sobreescribir la paleta por defecto de Tailwind.
  3. 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:

tailwind.config.js
Solo lectura
/** @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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.