1. O Que Sao Variaveis de Ambiente

Variaveis de ambiente sao pares chave-valor que configuram o comportamento de uma aplicacao sem alterar o codigo-fonte. Elas permitem que o mesmo codigo funcione diferentemente em desenvolvimento, homologacao e producao — mudando apenas as configuracoes externas.

O principio vem do Twelve-Factor App, metodologia para construir aplicacoes modernas: "A configuracao de uma aplicacao e tudo que varia entre deploys (desenvolvimento, staging, producao)". Armazenar configuracao em variaveis de ambiente e separar claramente codigo de configuracao.

2. O Padrao .env e dotenv

O arquivo .env e um arquivo de texto simples na raiz do projeto que define variaveis de ambiente para desenvolvimento local. A biblioteca dotenv (disponivel para Node.js, Python, PHP e outras linguagens) carrega automaticamente esse arquivo ao iniciar a aplicacao.

O formato e simples: CHAVE=valor, uma por linha. Linhas que comecam com # sao comentarios. Valores com espacos ou caracteres especiais devem ser envolvidos em aspas.

"O .env e seu ambiente de desenvolvimento codificado em texto. Trate-o como qualquer outro segredo — nunca o versione no Git."

3. Segredos: O Que NUNCA Versionar

Nunca adicione ao Git arquivos .env com valores reais, especialmente:

• Senhas de banco de dados e usuarios
• Chaves de API (AWS, Stripe, SendGrid, etc.)
• Tokens de autenticacao e JWT secrets
• Certificados e chaves privadas
• Credenciais de servicos de terceiros

Uma vez que um segredo e exposto no historico do Git (mesmo em um commit que depois foi removido), ele deve ser considerado comprometido e rotacionado imediatamente. Adicione sempre .env e .env.local ao seu .gitignore.

4. O Arquivo .env.example

O .env.example (ou .env.sample) e a versao segura para versionar: contem todas as chaves necessarias, mas com valores em branco ou placeholders descritivos para segredos. Novos desenvolvedores copiam este arquivo para .env e preenchem os valores reais.

Nossa ferramenta gera automaticamente o .env.example substituindo valores de variaveis marcadas como "secret" pelo placeholder your_secret_here. Variaveis booleanas recebem o formato true|false para indicar os valores possiveis.

5. Variaveis em Producao

Em producao, nunca use arquivos .env diretamente — eles podem ser expostos acidentalmente. As alternativas recomendadas sao:

• Plataformas PaaS (Heroku, Render, Railway): injete variaveis pelo painel de controle.
• CI/CD (GitHub Actions, GitLab CI): use secrets do pipeline, nunca hardcode.
• Cofres de segredos (HashiCorp Vault, AWS Secrets Manager, GCP Secret Manager): para ambientes corporativos ou alto volume de segredos.
• Kubernetes Secrets: para ambientes containerizados em cluster.

6. Perguntas Frequentes

Posso ter multiplos arquivos .env?

Sim. Muitas bibliotecas dotenv suportam arquivos por ambiente: .env.development, .env.production, .env.test. Next.js, por exemplo, tem suporte nativo a esse padrao. A ordem de precedencia varia por biblioteca — consulte a documentacao da sua stack.

Como compartilhar .env com a equipe com seguranca?

Use um gerenciador de segredos compartilhados como 1Password Teams, Doppler, ou o proprio AWS/GCP Secrets Manager. Evite compartilhar por Slack, e-mail ou qualquer canal nao criptografado. Ferramentas como dotenv-vault tambem permitem sincronizar .env criptografado entre a equipe.

Os dados inseridos nesta ferramenta sao enviados para algum servidor?

Nao. Todo o processamento e feito inteiramente no seu navegador via JavaScript. Nenhum dado de variaveis de ambiente e enviado ou armazenado em qualquer servidor da Chipak ou de terceiros.