env-config-gen

Generate typed config.js + config.d.ts + .env.example from your .env files.

Installation

npm install -g env-config-gen

Or run locally:

npx env-config-gen

Usage

env-config-gen [command] [options]

Commands

• generate (default): Generate config files from .env files.

Options

• --out=<dir>: Output directory (default: .)
• --env=<env>: Specify NODE_ENV (default: development or process.env.NODE_ENV)
• --no-types: Skip generating config.d.ts
• --no-example: Skip generating .env.example
• --validate: Validate .env files without generating
• --key-case=<case>: Key case transformation (camel, snake, etc., default: as-is)

How it works

1. Loads .env (base configuration)
2. Merges with .env.<NODE_ENV> if it exists (overrides)
3. Generates:
   • config.js: JavaScript module with parsed values
   • config.d.ts: TypeScript definitions
   • .env.example: Template with all keys

Example

Run the generator:

npx env-config-gen

Given a .env file:

DATABASE_URL=postgres://localhost:5432/myapp
API_KEY=secret123
DEBUG=true

This generates:

• config.js: JavaScript module with parsed values
• config.d.ts: TypeScript definitions
• .env.example: Template file

Recommended Usage

For production builds, specify the environment and output directory:

npx env-config-gen --env=production --out=src/config

This loads .env and merges with .env.production, then outputs files to src/config/.

License

MIT