configuration / Node.js CLI

envdrift

Detect missing keys, type mismatches, and placeholders across environment files.

envdrift compares two or more environment files and reports structural differences before they become deployment failures. Values stay redacted by default while type, protocol, placeholder, and presence signals remain visible.

Installation

npx @barissozudogru/envdrift .env .env.production

Platform requirements and configuration are documented in the repository instructions.

Capabilities

  • Compare multiple .env files in one run
  • Find missing keys and inferred type mismatches
  • Flag placeholder values and protocol inconsistencies
  • Produce JSON output and CI-friendly exit codes

Use cases

  • Checking development, staging, and production configuration together
  • Adding an environment-contract check to CI
  • Reviewing drift without printing raw secret values

Evidence

redaction contract

Useful configuration differences remain visible while values stay hidden.

The default report exposes presence, inferred type, length, character class, protocol, and a stable fingerprint. Raw values require an explicit local-only flag.

raw value   suppressed
shape       length + class
comparison  stable fingerprint
ci exit     1 on drift

GitHub Actions

Check configuration drift without printing values.

- uses: barissozudogru/[email protected]

Limitations

  • It compares configuration shape and signals, not the validity of external credentials
  • Files must be available to the local process running the command
  • Review intentionally different values before enforcing a strict CI policy