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.
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.
observed output
raw value suppressedshape length + classcomparison stable fingerprintci exit 1 on drift
what it exposes
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
workflow integration
Keep the evidence in the run
Check configuration drift without printing values.
- uses: barissozudogru/envdrift@v0.5.1good fit
Use it when
- Checking development, staging, and production configuration together
- Adding an environment-contract check to CI
- Reviewing drift without printing raw secret values
operating limits
Know before using
- 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