zod-envkit

Type-safe environment variable validation and documentation using Zod.

zod-envkit helps you treat environment variables as an explicit runtime contract, not an implicit guessing game.

Features

• Runtime validation with Zod
• Fully typed process.env
• CLI for env inspection and CI checks
• Auto-generated .env.example
• Documentation generation (md, json, yaml)
• Strict validation for CI/CD

Quickstart

npm install zod-envkit

yarn add zod-envkit

pnpm add zod-envkit

Example

import "dotenv/config";
import { z } from "zod";
import { mustLoadEnv } from "zod-envkit";

const EnvSchema = z.object({
  NODE_ENV: z.enum(["development", "test", "production"]),
  PORT: z.coerce.number().int(),
});

export const env = mustLoadEnv(EnvSchema);