envfix
Ferramenta de diagnóstico de configuração de ambiente para Node.js, sem dependências, que compara arquivos de ambiente e completa automaticamente as entradas que faltam.
Sobre envfix
envfix é uma ferramenta de diagnóstico de configuração de ambiente para projetos Node.js, sem dependências e fácil de integrar ao CI. Ela compara .env e .env.example item por item para encontrar rapidamente variáveis ausentes ou vazias, detecta declarações duplicadas ou com formato incorreto e também verifica se o .env está corretamente excluído via gitignore. Na correção, as chaves que faltam são adicionadas ao final do .env sem alterar linhas e valores existentes; ela também pode gerar ou sincronizar o .env.example sem expor segredos. O comando doctor avalia ainda se a configuração de ambiente está saudável, consistente e segura; no CI, o programa encerra com o código de saída 1 quando há variáveis ausentes ou vazias, ajudando equipes a detectar a deriva de configuração antes que ela chegue à produção.
Ideal para
Melhores casos de uso
Conferir o .env local após clonar um projeto e completar automaticamente as variáveis que faltam
Interceptar no CI variáveis ausentes ou vazias para impedir que a deriva de configuração chegue à produção
Gerar e sincronizar o .env.example para equipes ou projetos de código aberto sem expor segredos reais
Usar o comando doctor para uma avaliação completa da saúde, consistência e segurança da configuração de ambiente do projeto
Funcionalidades
Verificação por comparação de configuração
Compara .env e .env.example item por item, encontra variáveis ausentes ou vazias e detecta declarações duplicadas ou com formato incorreto.
Avaliação completa com o doctor
Responde a perguntas mais amplas do que a verificação básica: a configuração de ambiente do projeto está saudável, consistente e segura?
Correção segura por acréscimo
As chaves que faltam são adicionadas ao .env; linhas e valores existentes nunca são alterados.
Segurança de segredos e do repositório
Gera ou sincroniza o .env.example sem expor segredos e verifica se o .env está corretamente excluído via gitignore.
Vantagens
- Sem dependências: instalação leve e fácil de usar no CI
- Correções por acréscimo que não alteram linhas e valores existentes
- Por padrão, não imprime valores de variáveis de ambiente no terminal, em JSON nem em anotações de CI, reduzindo o risco de vazamentos
- Encerra com o código de saída 1 quando há variáveis ausentes ou vazias, facilitando o bloqueio direto no pipeline