{"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,"search_vec":"'1.0.6':22 '2':25 'actual':36 'altern':41 'app':12,34 'build':39 'built':46 'built-in':45 'cli':17,54,68 'code.replace':30 'dotenv':63 'env':5,64 'environ':13 'import.meta.env':48 'includ':55 'javascript':58 'like':15 'migrat':51 'perform':27 'plugin':3,8,61 'process.env.vue':33 'project':20 'provid':10 'replac':29 'requir':23 'string':28 'substitut':32 'time':40 'type':57 'typescript':56,69 'use':49 'valu':37 'variabl':14 'version':21 'vite':2,7,19,24,43,60,62 'vite-plugin':59 'vite-plugin-vue-env':1 'vue':4,11,16,53,65,67 'vue-c':66","created_at":"2026-04-27T17:07:46.519249+00:00","updated_at":"2026-04-27T17:07:46.519249+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/notiv-nt/vite-plugin-vue-env","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/vite-plugin-vue-env","openapi_spec":null,"status_page":null,"smithery":null,"categories":["web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-18","next_check":"2026-07-26","install_tag":null}}