Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

vite-plugin-vuetify

vuetifyjs1.2mMIT2.1.1TypeScript support: included

A Vite plugin for treeshaking Vuetify components and more

readme

vite-plugin-vuetify

Automatic imports

// vite.config.js
plugins: [
  vue(),
  vuetify({ autoImport: true }), // Enabled by default
]
// plugins/vuetify.js
import 'vuetify/styles'
import { createVuetify } from 'vuetify'

export default createVuetify()

Include labs components

// vite.config.js
plugins: [
  vue(),
  vuetify({
    autoImport: { labs: true }
  }),
]

Ignoring components or directives

// vite.config.js
plugins: [
  vue(),
  vuetify({ 
    autoImport: {
      ignore: [
        'VAlert', // Component name
        'Ripple', // Directive name
      ]
    }
  }), 
]

Note ignore values are case-sensitive

Style loading

Customising variables

// vite.config.js
plugins: [
  vue(),
  vuetify({ styles: { configFile: 'src/settings.scss' } }),
]
// plugins/vuetify.js
import 'vuetify/styles'
import { createVuetify } from 'vuetify'

export default createVuetify()
// settings.scss
@forward 'vuetify/settings' with (
  $color-pack: false,
  $utilities: false,
);

settings.scss can be used in your own components to access vuetify's variables.

Remove all style imports

// vite.config.js
plugins: [
  vue(),
  vuetify({ styles: 'none' }),
]
// plugins/vuetify.js
import { createVuetify } from 'vuetify'

export default createVuetify()

Import sass from source

Vuetify 3 uses precompiled css by default, these imports can optionally be modified to point to sass files instead:

// vite.config.js
plugins: [
  vue(),
  vuetify({ styles: 'sass' }),
]

Image loading

https://github.com/vitejs/vite-plugin-vue/blob/main/packages/plugin-vue/README.md#asset-url-handling

// vite.config.js
import vuetify, { transformAssetUrls } from 'vite-plugin-vuetify'

export default {
  plugins: [
    vue({ 
      template: { transformAssetUrls }
    }),
    vuetify(),
  ],
}

changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

2.1.1 (2025-04-03)

Bug Fixes

  • styles: resolve new scss component styles (#345) (98ef110)

2.1.0 (2025-02-04)

Note: Version bump only for package vite-plugin-vuetify

2.0.4 (2024-08-04)

Bug Fixes

  • respect vue's include and exclude options (557713a)

2.0.3 (2024-03-10)

Note: Version bump only for package vite-plugin-vuetify

2.0.2 (2024-02-28)

Bug Fixes

2.0.1 (2023-12-12)

Bug Fixes

2.0.0 (2023-12-12)

⚠ BREAKING CHANGES

  • Requires node >18
  • Removed styles: 'expose' option

Features

Bug Fixes

  • add explicit vue peer dependency (6634db3), closes #292

1.0.2 (2023-01-28)

Bug Fixes

  • add leading slash to absolute paths on windows (3ecd8e2), closes #274

1.0.1 (2022-12-11)

Bug Fixes

1.0.0 (2022-10-13)

Features

Bug Fixes

  • ignore non-standard query parameters (183f9dc), closes #271

1.0.0-alpha.17 (2022-09-12)

Bug Fixes

  • resolve stylesheets when using configFile with optimizeDeps.exclude (79f51cf), closes #268

1.0.0-alpha.16 (2022-09-06)

Bug Fixes

1.0.0-alpha.15 (2022-08-31)

Features

1.0.0-alpha.14 (2022-07-25)

Bug Fixes

  • transform imports in script setup lang="ts" (322f6ba)

1.0.0-alpha.13 (2022-07-23)

Bug Fixes

1.0.0-alpha.12 (2022-06-16)

Features

1.0.0-alpha.11 (2022-05-21)

Features

Bug Fixes

  • add plugin order warning (1957398)

1.0.0-alpha.10 (2021-12-10)

Features

  • add stylesTimeout option (93e830d)

Bug Fixes

  • disable esModuleInterop (b3ae4d1), closes #222
  • wait for all other modules to resolve before writing styles (274ce9c), closes #225

1.0.0-alpha.9 (2021-11-17)

Note: Version bump only for package @vuetify/vite-plugin

1.0.0-alpha.8 (2021-11-15)

Note: Version bump only for package @vuetify/vite-plugin

1.0.0-alpha.7 (2021-11-11)

Bug Fixes

1.0.0-alpha.6 (2021-11-11)

Features

Bug Fixes

1.0.0-alpha.5 (2021-10-03)

Bug Fixes

1.0.0-alpha.4 (2021-09-17)

Bug Fixes

  • use find-cache-dir, normalise dos paths (990ee15), closes #202

1.0.0-alpha.3 (2021-09-11)

Bug Fixes

  • always use posix paths (7393eef)
  • support more import paths (4253e7b)
  • trigger HMR when adding new style imports (ad1637b), closes #196
  • update style import regexp (a6b5e26)

1.0.0-alpha.2 (2021-08-31)

Note: Version bump only for package @vuetify/vite-plugin

1.0.0-alpha.1 (2021-08-30)

Features

1.0.0-alpha.0 (2021-08-28)

Features