README.md
March 15, 2026 ยท View on GitHub
Zero-config Nuxt Module for Vuetify
๐ Features
๐ Full documentation & guides
- ๐ Zero-Config: sensible built-in default Vuetify configuration for common use cases
- โก Fully Tree Shakable: by default, only the Vuetify components you use are imported
- ๐ช Auto-Import: Vuetify components and composables are auto-imported โ no manual imports needed
- ๐ Extensible: customize the Vuetify configuration via Nuxt Runtime Hooks, Nuxt Layers, the
vuetify:registerModulemodule hook, or a dedicatedvuetify.configfile - ๐ฅ SSR: automatic SSR detection and configuration, including HTTP Client Hints
- โจ Configurable Styles: configure your variables using Vuetify SASS Variables
- ๐ ๏ธ Directives & Labs: optional directives and labs components registration
- ๐ญ Icons: pure-CSS icons (UnoCSS), icon fonts (CDN or local), SVG packs (@mdi/js, FontAwesome), and multiple icon sets
- ๐ I18n: integrate @nuxtjs/i18n for Vuetify internationalization, with auto-imported Vuetify locale messages
- ๐ Date Components: use Vuetify date components via the @date-io adapters
- ๐จ Blueprints: scaffold quickly with Vuetify Blueprints
- ๐ฆพ Type Strong: written in TypeScript
๐ฆ Install
Requires Vite, will not work with Webpack
vuetify is a peer dependency (Vuetify 3 or 4) โ install it alongside the module:
npm install -D vuetify
npx nuxt module add vuetify-nuxt-module
๐ฆ Usage
vuetify-nuxt-moduleis strongly opinionated and has a built-in default configuration out of the box. You can use it without any configuration, and it will work for most use cases.
Add vuetify-nuxt-module module to nuxt.config.ts and configure it:
// Nuxt config file
import { defineNuxtConfig } from 'nuxt/config'
export default defineNuxtConfig({
modules: [
'vuetify-nuxt-module'
],
vuetify: {
moduleOptions: {
/* module specific options */
},
vuetifyOptions: {
/* vuetify options */
}
}
})
Read the ๐ documentation for a complete guide on how to configure and use this module.
๐ Full config
Check out the types.
The virtual modules can be found in configuration.d.ts file.
๐ License
MIT License ยฉ 2023-PRESENT Vuetify, LLC