Pular para o conteúdo principal

ADR 0002 — Variáveis Vite no build

Status​

Aceito.

Contexto​

Vite substitui import.meta.env.VITE_* em compile-time. Colocar a URL da API só no environment: do Docker Compose não altera o bundle já gerado.

Decisão​

  • Documentar e passar VITE_* como build-arg (Dockerfile ARG/ENV antes de npm run build)
  • .env.example descreve o contrato; .env real fica fora do git
  • Produção usa .env.production no vite build da CI ou args equivalentes

Consequências​

  • Trocar API de um ambiente exige rebuild da imagem
  • Segredos de backend nunca devem ser VITE_* (ficam no JavaScript do cliente)
  • VITE_SESSION_VAULT_SECRET é ofuscação de localStorage, não segredo de servidor