Skip to content

Archivo de Configuración

Recomendamos encarecidamente usar un archivo dedicado uno.config.ts para configurar tu UnoCSS, con el fin de obtener la mejor experiencia con IDEs y otras integraciones.

Un archivo de configuración con todas las características se ve así:

ts
import {
  defineConfig,
  presetAttributify,
  presetIcons,
  presetTypography,
  presetWebFonts,
  presetWind3,
  transformerDirectives,
  transformerVariantGroup
} from 'unocss'

export default defineConfig({
  shortcuts: [
    // ...
  ],
  theme: {
    colors: {
      // ...
    }
  },
  presets: [
    presetWind3(),
    presetAttributify(),
    presetIcons(),
    presetTypography(),
    presetWebFonts({
      fonts: {
        // ...
      },
    }),
  ],
  transformers: [
    transformerDirectives(),
    transformerVariantGroup(),
  ],
})

En comparación con la configuración en línea dentro de tu vite.config.ts u otras configuraciones de herramientas, el archivo de configuración dedicado funcionará mejor con IDEs e integraciones, con otras herramientas como el plugin ESLint, además de hacer que HMR funcione mejor.

Por defecto, UnoCSS buscará automáticamente uno.config.{js,ts,mjs,mts} o unocss.config.{js,ts,mjs,mts} en el directorio raíz de tu proyecto. También puedes especificar el archivo de configuración manualmente, por ejemplo en Vite:

ts
import UnoCSS from 'unocss/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    UnoCSS({
      configFile: '../my-uno.config.ts',
    }),
  ],
})

Para la lista completa de opciones de configuración soportadas, consulta la referencia de Configuraciones.

Released under the MIT License.