Ambientes

Um ambiente é declarado como target.environment. O nome do ambiente é um identificador. development, production, staging, preview, qa e test não são palavras reservadas. default é especial apenas por causa do arquivo para o qual mapeia.

Arquivos de saída

Este mapeamento é semântica projetada do Vidro. A CLI atual não gera estes arquivos.

default        → .env
<environment>  → .env.<environment>

target.default       → <target PATH>/.env
target.environment   → <target PATH>/.env.<environment>

Exemplos:

website.default      → apps/website/.env
website.development  → apps/website/.env.development
website.production   → apps/website/.env.production
website.preview      → apps/website/.env.preview
website.qa           → apps/website/.env.qa
api.integration      → <api PATH>/.env.integration

Exemplo

project: "langdrift";
 
website {
  PATH: "apps/website/";
}
 
website.default {
  RESEND_API_KEY: $RESEND_API_KEY;
}
 
website.development {
  API_URL: "http://localhost:8080";
}

Essa fonte controla:

apps/website/.env
apps/website/.env.development

Se default também entra na mescla de outros ambientes em tempo de execução é uma pergunta separada, ainda em aberto. O mapeamento de nomes de arquivo acima não decide isso.