env-formatter

Sort .env files and generate .env.example with deterministic comments (names and types).

Install

npm install -g env-formatter
# or
bun install -g env-formatter

Or run without installing:

npx env-formatter sort
bunx env-formatter example

Usage

• Sort — Group and sort keys by category (API keys, logging, database, etc.):

  env-formatter sort
  env-formatter sort --input .env.local -o .env.local.sorted

• Example — Create .env.example from .env with inferred comments and placeholders:

  env-formatter example
  env-formatter example --input .env --output .env.example

Options: -i, --input (default: .env), -o, --output (sort: overwrite input; example: .env.example), -h, --help.

Full usage and examples: docs/cli-usage.md.

Docs

• CLI usage — Commands, options, examples
• Sort categories — How keys are grouped
• Example generation — How comments and types are derived

Development

bun install
bun run index.ts sort
bun run index.ts example

Requires Bun and TypeScript 5.