Vite
Inject safe client env and surface validation errors in the overlay.
Use the @confkit/vite
plugin to inject safe client environment variables and validate on file changes.
Install
pnpm add @confkit/vite
Configure
import { defineConfig } from 'vite';
import confkit from '@confkit/vite';
export default defineConfig({
plugins: [confkit({ file: './conf/config.ts' })],
});
What It Does
- Computes
clientEnv
usingconfkit/load
and setsdefine['process.env.KEY'] = JSON.stringify(value)
- Validates on server start and on watched file changes
- Sends a readable error into Vite’s overlay when validation fails
Virtual Module
Import a pre-baked client env object via a virtual module:
import env from 'confkit:client';
console.log(env.PUBLIC_APP_NAME);
API: confkitVite({ file?: string })