envsaurus
v0.0.1
Published
ENVSAURUS is a zero-dependency CLI + library that turns your .env.example into a fully typed config file. It validates environment variables at runtime, fails fast in CI, and exports a safe CONFIG object for Node/TypeScript apps. Catch missing or invalid
Maintainers
cavani21Readme
envsaurus
Generate typed config from .env.example and validate process.env at runtime.
Quickstart
npm i -D typescript
npm run build
npx envsaurus --helpCLI
npx envsaurus gen --example .env.example --out src/config.ts
npx envsaurus check --example .env.example --strict
npx envsaurus schema --example .env.example --format json|yamlRequirements
- Node >= 18
- CommonJS output by default
Example
.env.example
# PORT:number=3000
PORT=3000
# NODE_ENV:enum(development,production,test)=development
NODE_ENV=development
# API_URL:url
API_URL=
# ENABLE_CACHE:boolean=false
ENABLE_CACHE=false
# FEATURES:json # e.g. {"beta":true}
FEATURES=Generate config (TypeScript):
npx envsaurus gen --example .env.example --out src/config.tsGenerate config (JavaScript + JSDoc):
npx envsaurus gen --example .env.example --out config.js --jsValidate in CI (exit 1 on errors):
npx envsaurus check --example .env.example --strict