envfix

What is envfix?

envfix is a tiny environment configuration doctor for Node.js projects. It compares your local .env against .env.example, reports missing, empty, and extra variables, and can append the missing keys for you — all with zero dependencies.

Key capabilities

• Check — compare .env with .env.example and list missing, empty, and extra variables.
• Fix — append missing keys to .env without touching existing lines or values.
• Doctor — full health check covering files, syntax, consistency, and Git safety (e.g. whether .env is tracked or ignored).
• Example — generate or sync .env.example from .env, always stripping values so secrets never leak.
• Multi-environment — use --env / --example for any pair, or --all to check every .env*.example pair in a directory.
• CI friendly — meaningful exit codes, --strict mode, --json output, and automatic GitHub Actions annotations.

Why it helps

Configuration drift is a common cause of "works on my machine" failures. envfix catches it in seconds, both locally and in CI, and its diagnostics include line numbers for duplicates, invalid names, and unclosed quotes.

Getting started

No installation required:

npx envfix
npx envfix fix
npx envfix doctor

It is open source under the MIT license.