Registry / web-framework / vite-plugin-vue-env

vite-plugin-vue-env

library1.0.6jsnpmunverified

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.

web-framework

npm install vite-plugin-vue-env

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-VUE-EN

vite-plugin-vue-env

web-frameworkjavascriptv1.0.6

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default import

✓ import pluginEnv from 'vite-plugin-vue-env'

✗ import { pluginEnv } from 'vite-plugin-vue-env'

Default import only; named import does not exist.

require style

✓ const pluginEnv = require('vite-plugin-vue-env').default

✗ const pluginEnv = require('vite-plugin-vue-env')

CJS require must use .default because the package exports an ESM default.

TypeScript import type

✓ import type { Options, Variables } from 'vite-plugin-vue-env'

Types are exported but not documented; Options and Variables may be undefined.

Configures vite-plugin-vue-env in Vite config with optional custom variables and prefix.

// vite.config.ts import { defineConfig } from 'vite'; import pluginEnv from 'vite-plugin-vue-env'; export default defineConfig({ plugins: [ pluginEnv({ // override env variables (optional) APP_ENV: 'development' }, { // customize prefix (optional) variablePrefix: 'VUE_APP_' }) ] }); // Then in your source code: // console.log(process.env.VUE_APP_MY_VAR);

Debug

Known issues

breakingPlugin replaces process.env.VUE_APP_* with string literals; reassigning or mutating these values at runtime will not work.

fix

Use const and treat them as compile-time constants.

affects: >=1.0.0

gotchaDefault export only; named import returns undefined.

fix

Use default import: import pluginEnv from 'vite-plugin-vue-env'

affects: >=1.0.0

gotchaCJS users must use .default: const pluginEnv = require('vite-plugin-vue-env').default

fix

Append .default to require.

affects: >=1.0.0

deprecatedPlugin is not actively maintained; last release 2021. Vite 4+ may have compatibility issues.

fix

Consider using Vite's native import.meta.env or 'dotenv' directly.

affects: >=1.0.0

gotchaOnly variables with prefix VUE_APP_ (default) are exposed; others are not replaced.

fix

Set variablePrefix option to include custom prefixes.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: pluginEnv is not a function

Using named import instead of default import.

fix

Change import to: import pluginEnv from 'vite-plugin-vue-env'

Cannot find module 'vite-plugin-vue-env'

Missing installation or incorrect package.json configuration.

fix

Run: npm i -D vite-plugin-vue-env

process.env.VUE_APP_MY_VAR is undefined at runtime

Variable does not start with VUE_APP_ prefix or .env file is missing.

fix

Ensure .env file contains VUE_APP_MY_VAR=value, or set variablePrefix.

export 'pluginEnv' (imported as 'pluginEnv') was not found in 'vite-plugin-vue-env'

Using named import for a default export.

fix

Use default import: import pluginEnv from 'vite-plugin-vue-env'

Upgrade

Version history

1.0.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/notiv-nt/vite-plugin-vue-env ↗

packagehttps://www.npmjs.com/package/vite-plugin-vue-env ↗