A Vite plugin to validate environment variables against a Valibot schema.

It's generally a good idea to check that you're all set up early in the development process. Validating that your environment variables have been defined and are of the expected type is a part of that – for yourself and your colleagues. While there are many libraries to validate against a schema, Valibot stands out for its versatility and modularity. The small footprint makes it an ideal candidate for validation in the frontend. So why not use it in your development process as well?

npm install -D vite-plugin-valibot-env valibot

Let's start with a very basic example

import { defineConfig } from 'vite';
import * as v from 'valibot';
import valibot from 'vite-plugin-valibot-env';

const schema = v.object({
	VITE_API_ENDPOINT: v.pipe(v.string(), v.url()),
	VITE_LOCALE: v.literal('en_US'),
});

export default defineConfig({
	plugins: [
		valibot(schema),
	]
});

valibot(schema, options?)

Type: boolean
Default: false

Setting this to true will also validate unprefixed environment variables.

Type: boolean
Default: false

Setting this to true will try and transform string values to their respective types. Supports booleans, integers, floats, and null.

Type: string
Default: undefined

Language ID for localized error messages.

Type: function
Default: undefined

A callback function executed after any issues have been printed.

Type: function
Default: undefined

A callback function executed after all issues have been printed.

Type: boolean
Default: false

Throws an error rather than exiting gracefully when issues have been found in the schema.

• esbuild-plugin-valibot-env

This work is licensed under The MIT License.