Arquivo de Configuração

Recomendamos fortemente usar um arquivo dedicado uno.config.ts para configurar seu UnoCSS, a fim de obter a melhor experiência com IDEs e outras integrações.

Um arquivo de configuração completo se parece com este:

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(),
  ],
})

Em comparação com a configuração inline dentro do seu vite.config.ts ou outras configurações de ferramentas, o arquivo de configuração dedicado funcionará melhor com IDEs e integrações, com outras ferramentas como o plugin ESLint, além de tornar o HMR (Hot Module Replacement) mais eficiente.

Por padrão, o UnoCSS procurará automaticamente por uno.config.{js,ts,mjs,mts} ou unocss.config.{js,ts,mjs,mts} no diretório raiz do seu projeto. Você também pode especificar o arquivo de configuração manualmente, por exemplo, no Vite:

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

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

Para a lista completa de opções de configuração suportadas, consulte a Referência de Configurações.