Skip to content

This reference covers the envModel format used by @vibenv/env-manager.

envModel value types

  • boolean: true or false
  • number: any numeric value
  • string: a default value, optionally followed by alternatives separated by |

Example:

json
{
  "envModel": {
    "LOG_LEVEL": "info|debug|warn|error",
    "PORT": 3000,
    "DEBUG": false
  }
}

Generated .env rules

  • Keys are sorted alphabetically.
  • When a string has | separators, alternatives are emitted as a # comment above the key.
  • Existing .env values are preserved when they match the expected type.
  • Type mismatches fall back to the default value and emit a warning.