{"id":22915,"library":"vite-plugin-vue-env","title":"vite-plugin-vue-env","description":"A Vite plugin that provides VUE_APP_* environment variables (like Vue CLI) to Vite projects. Version 1.0.6 requires Vite 2+. It performs string replacement (code.replace) to substitute process.env.VUE_APP_* with actual values at build time. Alternative to Vite's built-in import.meta.env, useful for migrating from Vue CLI. Includes TypeScript types.","status":"active","version":"1.0.6","language":"javascript","source_language":"en","source_url":"https://github.com/notiv-nt/vite-plugin-vue-env","tags":["javascript","vite-plugin","vite","dotenv","env","vue","vue-cli","typescript"],"install":[{"cmd":"npm install vite-plugin-vue-env","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-vue-env","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-vue-env","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Default import only; named import does not exist.","wrong":"import { pluginEnv } from 'vite-plugin-vue-env'","symbol":"default import","correct":"import pluginEnv from 'vite-plugin-vue-env'"},{"note":"CJS require must use .default because the package exports an ESM default.","wrong":"const pluginEnv = require('vite-plugin-vue-env')","symbol":"require style","correct":"const pluginEnv = require('vite-plugin-vue-env').default"},{"note":"Types are exported but not documented; Options and Variables may be undefined.","wrong":"","symbol":"TypeScript import type","correct":"import type { Options, Variables } from 'vite-plugin-vue-env'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite';\nimport pluginEnv from 'vite-plugin-vue-env';\n\nexport default defineConfig({\n  plugins: [\n    pluginEnv({\n      // override env variables (optional)\n      APP_ENV: 'development'\n    }, {\n      // customize prefix (optional)\n      variablePrefix: 'VUE_APP_'\n    })\n  ]\n});\n\n// Then in your source code:\n// console.log(process.env.VUE_APP_MY_VAR);","lang":"typescript","description":"Configures vite-plugin-vue-env in Vite config with optional custom variables and prefix."},"warnings":[{"fix":"Use const and treat them as compile-time constants.","message":"Plugin replaces process.env.VUE_APP_* with string literals; reassigning or mutating these values at runtime will not work.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use default import: import pluginEnv from 'vite-plugin-vue-env'","message":"Default export only; named import returns undefined.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Append .default to require.","message":"CJS users must use .default: const pluginEnv = require('vite-plugin-vue-env').default","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consider using Vite's native import.meta.env or 'dotenv' directly.","message":"Plugin is not actively maintained; last release 2021. Vite 4+ may have compatibility issues.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Set variablePrefix option to include custom prefixes.","message":"Only variables with prefix VUE_APP_ (default) are exposed; others are not replaced.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Change import to: import pluginEnv from 'vite-plugin-vue-env'","cause":"Using named import instead of default import.","error":"TypeError: pluginEnv is not a function"},{"fix":"Run: npm i -D vite-plugin-vue-env","cause":"Missing installation or incorrect package.json configuration.","error":"Cannot find module 'vite-plugin-vue-env'"},{"fix":"Ensure .env file contains VUE_APP_MY_VAR=value, or set variablePrefix.","cause":"Variable does not start with VUE_APP_ prefix or .env file is missing.","error":"process.env.VUE_APP_MY_VAR is undefined at runtime"},{"fix":"Use default import: import pluginEnv from 'vite-plugin-vue-env'","cause":"Using named import for a default export.","error":"export 'pluginEnv' (imported as 'pluginEnv') was not found in 'vite-plugin-vue-env'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}