EnvGuard

Appearance

EnvGuardEnvironment Variable Validator

Validate .env files against a declarative YAML schema. Catch misconfigurations before deployment.

Get Started
View on GitHub
EnvGuard
🛡️

Schema Validation

Define rules once in YAML and validate everywhere. Types, patterns, enums, ranges, formats, and more.

🔍

Secret Detection

Built-in scanning for AWS keys, GitHub tokens, JWTs, Stripe keys, and 13 more patterns plus entropy-based detection.

⚡

Blazing Fast

Written in Go as a single static binary. Zero runtime dependencies. Parallel validation support.

🔧

CI-First

Native GitHub Action, pre-commit hook, SARIF output, and wrappers for Node.js and Python.

👁️

Watch Mode

Automatically re-validate on file changes with debounced filesystem watching.

🧠

Schema Inference

Auto-generate schemas from existing .env files with smart type and format detection.

Demo ​

Full Feature Demo ​

See every major feature in action — from schema generation and validation to secret scanning, linting, schema composition, and source-code auditing.

Quick Validation ​

Define your schema in envguard.yaml:

yaml
version: "1.0"

env:
  DATABASE_URL:
    type: string
    required: true
    format: url

  PORT:
    type: integer
    default: 3000
    min: 1024
    max: 65535

  DEBUG:
    type: boolean
    default: false

Run the validator:

bash
$ envguard validate
✓ All environment variables are valid

Install in 10 Seconds ​

bash
curl -sSL https://github.com/firasmosbehi/envguard/releases/latest/download/envguard-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/') -o /usr/local/bin/envguard
chmod +x /usr/local/bin/envguard
bash
brew install --formula https://raw.githubusercontent.com/firasmosbehi/envguard/main/homebrew/envguard.rb
bash
docker run --rm -v $(pwd):/workspace ghcr.io/firasmosbehi/envguard:latest validate
bash
npm install -g envguard-validator
bash
pip install envguard-validator

License ​

MIT

Released under the MIT License.

Copyright © 2024-present Firas Mosbehi