vite-plugin-valibot-env
v0.5.1
Published
A Vite plugin to validate environment variables against a Valibot schema
Downloads
513
Readme
vite-plugin-valibot-env
A Vite plugin to validate environment variables against a Valibot schema.
Why?
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, too?
Installation
npm install -D vite-plugin-valibot-env valibot
Usage
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 envSchema = v.object({
VITE_API_ENDPOINT: v.string([v.url()]),
VITE_ENABLE_LOGGING: v.boolean(),
});
export default defineConfig({
plugins: [
valibot(envSchema),
]
});
API
valibot(schema, options?)
Options
options.ignoreEnvPrefix
Type: Boolean
Default: false
Setting this to true
will also validate unprefixed environment variables.
[!TIP] Vite uses a prefix to prevent leaking all environment variables into your code. The same limitation applies to the validator. However, there might be use cases where you want validate unprefixed environment variables as well, e.g.
HOST
andPORT
to configure the Vite server. This is what this option is for.
options.transformValues
Type: Boolean
Default: false
Setting this to true
will try and transform string values to their respective types. Supports booleans, integers, floats, and null
.
License
This work is licensed under The MIT License.