Installation

Core Package

Install @vite-env/core with your preferred schema validator:

With Zod (recommended)

pnpm

pnpm add @vite-env/core zod

npm

npm install @vite-env/core zod

yarn

yarn add @vite-env/core zod

bun

bun add @vite-env/core zod

With any Standard Schema validator

If you prefer Valibot, ArkType, or another Standard Schema-compliant validator, install it instead of Zod:

pnpm

pnpm add @vite-env/core valibot

npm

npm install @vite-env/core valibot

yarn

yarn add @vite-env/core valibot

bun

bun add @vite-env/core valibot

CLI (Optional)

The @vite-env/cli package provides the vite-env command for type generation and validation checks outside of the Vite build process. Install it as a dev dependency:

pnpm

pnpm add -D @vite-env/cli

npm

npm install -D @vite-env/cli

yarn

yarn add -D @vite-env/cli

bun

bun add -D @vite-env/cli

Requirements

Requirement	Version
Node.js	>= 20.19.0
Vite	>= 8.0.0
Zod	>= 4.0.0 (optional — only for defineEnv())

When using defineStandardEnv(), install your preferred Standard Schema-compliant validator (Valibot, ArkType, etc.) instead of Zod. Any version that implements the Standard Schema spec works.