@pinegrow/vuetify-plugin
v3.0.51
Published
Pinegrow Vuetify Plugin
Downloads
142
Readme
Pinegrow Vuetify Plugin
Vuetify plugin for Pinegrow ⚡️
Pinegrow Vuetify Plugin provides customized visual controls, design panel for theming and other rich visual features customized for your Vuetify experience.
Note:
- This plugin is generally used in conjunction with the Pinegrow Vite Plugin or with the meta-framework specific Pinegrow modules for Iles, Nuxt and Astro.
- To use Vuetify in Pinegrow apps, you require an active Vuetify Addon subscription.
- Learn more about Vue Designer
Features
- 🎨 Visually live-design your Vite-powered Vuetify apps (Vue, Nuxt, Iles, Astro, etc)
- ⚙️ Smartly integrates into your Vite workflow in dev-mode only
- ✨ Clean code 😃, No lock-in - You are in control of your projects and development workflow ❤️
Quick Setup
- Install: Add
@pinegrow/vuetify-plugin
to your project
# Using npm
npm install -D @pinegrow/vuetify-plugin
# Using pnpm
pnpm add -D @pinegrow/vuetify-plugin
- Configure: Add
vuetify
along withconfigPath
andcssPath
as options toliveDesigner
in your config. To turn off visual helpers for Vuetify utility classes, setutilities: false
.
//vite.config.[js,ts]
export default defineConfig({
plugins: [
liveDesigner({
// For options, refer to https://www.npmjs.com/package/@pinegrow/vite-plugin
//...
vuetify: {
/* PinegrowVuetifyModuleOptions (for more details, refer to Options section below) */
/* Please ensure that you update the filenames and paths to accurately match those used in your project. */
configPath: 'vuetify.config.ts', // or file where vuetify is created
// utilities: false,
// restartOnConfigUpdate: true,
restartOnThemeUpdate: true,
},
}),
//...
],
//...
})
//nuxt.config.ts
export default defineNuxtConfig({
modules: [
'@pinegrow/nuxt-module',
//...
],
pinegrow: {
liveDesigner: {
// For options, refer to https://www.npmjs.com/package/@pinegrow/vite-plugin
//...
vuetify: {
/* PinegrowVuetifyModuleOptions (for more details, refer to Options section below) */
/* Please ensure that you update the filenames and paths to accurately match those used in your project. */
configPath: 'vuetify.config.ts', // or file where vuetify is created
// utilities: false,
// restartOnConfigUpdate: true,
restartOnThemeUpdate: true,
},
},
},
//...
})
//iles.config.ts
import type { LiveDesignerOptions } from '@pinegrow/vite-plugin'
export default defineConfig({
modules: [
[
'@pinegrow/iles-module',
{
liveDesigner: {
// For options, refer to https://www.npmjs.com/package/@pinegrow/vite-plugin
//...
vuetify: {
/* PinegrowVuetifyModuleOptions (for more details, refer to Options section below) */
/* Please ensure that you update the filenames and paths to accurately match those used in your project. */
configPath: 'vuetify.config.ts', // or file where vuetify is created
// utilities: false,
// restartOnConfigUpdate: true,
restartOnThemeUpdate: true,
},
} as LiveDesignerOptions,
},
],
//...
],
//...
})
//astro.config.[mjs]
import { defineConfig } from 'astro/config'
import vue from '@astrojs/vue'
import Pinegrow from '@pinegrow/astro-module'
export default defineConfig({
integrations: [
vue(),
Pinegrow({
liveDesigner: {
// For options, refer to https://www.npmjs.com/package/@pinegrow/vite-plugin
//...
vuetify: {
/* PinegrowVuetifyModuleOptions (for more details, refer to Options section below) */
/* Please ensure that you update the filenames and paths to accurately match those used in your project. */
configPath: 'vuetify.config.ts', // or file where vuetify is created
// utilities: false,
// restartOnConfigUpdate: true,
restartOnThemeUpdate: true,
},
},
}),
//...
],
//...
})
Now, open your project in your Pinegrow app (currently only Vue Designer). ✨
Theme Customization (optional) - Pinegrow Vuetify addon enables easy theming based on colors, fonts and background images. Theme files are saved at the location specified by the
themePath
option (default: [src]/themes/pg-vuetify/tokens.[cjs,mjs]). To use the theme, follow the instructions in the Config Panel of your Pinegrow app (currently only Vue Designer) under@pinegrow/vuetify-plugin
package.
Options
interface PinegrowVuetifyModuleOptions {
/**
* Absolute or relative path of the vuetify configuration file.
*/
configPath: string | any
/**
* Absolute or relative path of the vuetify entry css file.
*/
cssPath?: string | any
/**
* Absolute or relative path of the vuetify theme file.
* @default 'src/themes/pg-vuetify/tokens.[cjs,mjs]'
* @default 'themes/pg-vuetify/tokens.[cjs,mjs]' // Nuxt
* Set to false to turn off theming via Design Panel
*/
themePath?: string | boolean
/**
* Turn off visual controls for Vuetify utility classes
* @default true
*/
utilities?: boolean
/**
* Restart on vuetify config file updates
* @default false
*/
restartOnConfigUpdate?: boolean
/**
* Restart on vuetify theme file updates
* @default false
*/
restartOnThemeUpdate?: boolean
}
interface PinegrowVuetifyModule {
/**
* Pinegrow Vuetify Module Options, added within liveDesigner in vite/nuxt/iles/astro config files
*/
vuetify: PinegrowVuetifyModuleOptions
}
License
Copyright (c) Pinegrow