paro-paro / vite-plugin-vuetify-sass

MIT License
8 stars 1 forks source link

@paro-paro/vite-plugin-vuetify-sass

NPM version

Copy of vite-plugin-vuetify 's internal style plugin with a few tweaks.

Meant to be used in Nuxt applications with SSR enabled.

For more detailed info, check the vuetify documentation, specially the SASS and treeshaking sections.

You can also check this issue for context.

Be noted that, if you are not using Nuxt, it is recommended that you use the original vite-plugin-vuetify

Install

Use your favorite package manager.

pnpm add -D @paro-paro/vite-plugin-vuetify-sass

Vuetify v3.0.0 (or above) and Vite v3.1 (or above) are required. Vite 5.x is also supported.

Usage

settings.scss

@use 'vuetify/settings' with (
  $reset: false,
  $utilities: false,
  $button-height: 100px,
  $button-border-radius: 50px
);

Vue

vite.config.ts

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import vuetify from 'vite-plugin-vuetify'
import vuetifySass from '@paro-paro/vite-plugin-vuetify-sass'

export default defineConfig({
  plugins: [
    vue(),
    vuetify({ autoImport: true }), // do not pass the 'styles' option
    vuetifySass({ configFile: 'src/assets/settings.scss' }),
  ],
})

Nuxt

nuxt.config.ts

import vuetify from 'vite-plugin-vuetify'
import vuetifySass from '@paro-paro/vite-plugin-vuetify-sass'

export default defineNuxtConfig({
  ssr: true,
  build: {
    transpile: ['vuetify'], // when ssr is enabled
  },
  experimental: {
    inlineSSRStyles: false, // for production build
  },
  hooks: {
    'vite:extendConfig': (config) => {
      config.plugins!.push(
        vuetify({ autoImport: true }), // do not pass the 'styles' option
        vuetifySass({
          configFile: 'assets/settings.scss',
        }),
      )
    },
  },
})

Note

This plugin does not include any auto-import or treeshaking functionality. For that, you still need to use the original vite-plugin-vuetify (as shown in the usage section). Just make sure that you do not pass the styles option to the plugin. This way, only the internal import plugin (for treeshaking) will be used.

SASS compilation

Currently, there are several open issues and discussions around the slow performance of SASS compilation with Vite. Despite this, I have not experienced a significant performance hit when using this plugin in a Vite + Vue + Vuetify application.

The big performance hit seems to be a Nuxt specific issue where compilation of large amount of SASS files heavily affects the warm up (dev server) time.

Update: Latest Nuxt 3.8.1 and 3.8.2 versions seem to have addressed this issue and the warm up time has being reduced significantly. Check #1 for details.

License

MIT License © 2023-PRESENT Antonio Parody