envguards

envguards is a TypeScript library that provides a unified solution for managing environment variables across any JavaScript or TypeScript project. It eliminates common pain points like silent failures, missing documentation, and framework lock-in by offering validation, auto-documentation, and example file generation from a single schema definition.

Key Features

• Runtime Validation — Validates environment variables at startup with clear, actionable error messages to fail fast.
• Auto-Documentation — Generates comprehensive Markdown documentation (ENVIRONMENT.md) from the schema.
• Example File Sync — Automatically creates and updates a .env.example file with comments and default values.
• Framework Agnostic — Works with Node.js, Express, React, Next.js, Vite, Angular, Svelte, Bun, and Deno.
• CI/CD Integration — Includes a check command that exits with code 1 on failure for easy CI pipeline integration.
• TypeScript Support — Built with TypeScript and provides full type definitions and inference helpers.

Philosophy

envguards believes environment management should be consistent, documented, and fail-fast, regardless of the underlying framework, promoting better developer experience and team collaboration.