Skip to content

vuetifyjs/nuxt-module

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vuetify-nuxt-module - Zero-config Nuxt Module for Vuetify

Zero-config Nuxt Module for Vuetify

NPM version NPM Downloads Docs & Guides
GitHub stars


🚀 Features

  • 📖 Documentation & guides
  • 👌 Zero-Config: sensible built-in default Vuetify configuration for common use cases
  • 🔌 Extensible: expose the ability to customize the Vuetify configuration via Nuxt Runtime Hooks
  • Fully Tree Shakable: by default, only the needed Vuetify components are imported
  • 🛠️ Versatile: custom Vuetify directives and labs components registration
  • Configurable Styles: configure your variables using Vuetify SASS Variables
  • 💥 SSR: automatic SSR detection and configuration including HTTP Client hints
  • 🔩 Nuxt Layers and Module Hooks: load your Vuetify configuration using Nuxt Layers or using a custom module via vuetify:registerModule Nuxt Module Hook
  • 📥 Vuetify Configuration File: configure your Vuetify options using a custom vuetify.config file, no dev server restart needed
  • 🔥 Pure CSS Icons: no more font/js icons, use the new unocss-mdi icon set or build your own with UnoCSS Preset Icons
  • 😃 Icon Fonts: configure the icon font you want to use, the module will automatically import it for you using CDN or local dependencies
  • 🎭 SVG Icons: ready to use @mdi/js and @fortawesome/vue-fontawesome SVG icons packs
  • 📦 Multiple Icon Sets: register multiple icon sets
  • 🌍 I18n Ready: install @nuxtjs/i18n Nuxt module, and you're ready to use Vuetify internationalization features
  • 📆 Date Components: use Vuetify components that require date functionality installing and configuring one of the @date-io adapters
  • 💬 Auto-Import Vuetify Locale Messages: add Vuetify Locale Messages adding just the locales you want to use, no more imports needed
  • ⚙️ Auto-Import Vuetify Composables: you don't need to import Vuetify composables manually, they are automatically imported for you
  • 🎨 Vuetify Blueprints: use Vuetify Blueprints to quickly scaffold components
  • 👀 Nuxt DevTools: ready to inspect your Vuetify styles with the Nuxt DevTools inspector
  • 🦾 Type Strong: written in TypeScript

📦 Install

Requires Vite, will not work with Webpack

npx nuxi@latest module add vuetify-nuxt-module

Open in StackBlitz

🦄 Usage

vuetify-nuxt-module is 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 Joaquín Sánchez