File overrides

Apply different rules to specific environment files.

Usage

Use [files.".env.production"] for file-wide settings and [files.".env.production".env.NAME] for individual variables. These settings inherit root rules and apply when that file is selected.

[env.NODE_ENV]
enum = ["development", "test", "production"]

[env.SENTRY_DSN]
optional = true

[files.".env.production"]
strict = true

[files.".env.production".env.NODE_ENV]
enum = ["production"]

[files.".env.production".env.SENTRY_DSN]
required = true

Use literal filenames relative to your project. An override changes only the options it specifies and can introduce a variable that applies only to that file.

When multiple selected files have overrides, earlier files in the selected list take precedence for explicitly specified options. Unspecified options inherit the root rules. File blocks can set strict, required, and storage defaults.