DotEnv Manager
Uma extensão robusta e segura para VS Code que facilita o gerenciamento de arquivos .env para diferentes ambientes.
Funcionalidades
- 🔄 Suporte completo para qualquer arquivo .env.*: Use qualquer arquivo
.env.* como origem (não apenas .env)
- 🚀 Gerar arquivos .env para múltiplos ambientes: Crie
.env.production a partir de .env.example, ou qualquer combinação possível
- ✨ Seleção interativa de ambiente: Interface intuitiva que filtra automaticamente o arquivo de origem
- 🎯 Nomes personalizados: Opção para criar arquivos com nomes personalizados
- 👤 Informações de autoria: Inclui automaticamente o autor (nome do Git) e data de geração nos comentários
- 📝 Rastreabilidade: Cada arquivo gerado contém informações sobre quando e por quem foi criado
Como usar
- Clique com o botão direito em qualquer arquivo .env.* no explorador de arquivos (
.env, .env.example, .env.production, etc.)
- Selecione "Gerar arquivo .env para ambiente específico" no menu de contexto
- Escolha o tipo de ambiente desejado no menu de seleção (o arquivo de origem será automaticamente filtrado):
.env.example - Arquivo template padrão.env.development - Ambiente de desenvolvimento.env.staging - Ambiente de homologação/teste.env.production - Ambiente de produção.env.test - Testes automatizados.env.local - Configurações locais.env.docker - Para containers Docker.env.preview - Para deploys de preview- Personalizado - Digite um nome customizado
Ou:
- Abra qualquer arquivo .env.* no editor
- Use
Ctrl+Shift+P (ou Cmd+Shift+P no Mac) para abrir a paleta de comandos
- Digite "Gerar arquivo .env para ambiente específico" e execute o comando
Exemplos de Uso
Cenário 1: Criar arquivo de produção a partir do template
- Arquivo origem:
.env.example
- Ação: Clique direito → Selecione
.env.production
- Resultado:
.env.production criado com valores sanitizados
Cenário 2: Criar arquivo de teste a partir de desenvolvimento
- Arquivo origem:
.env.development
- Ação: Clique direito → Selecione
.env.test
- Resultado:
.env.test criado preservando estrutura
Cenário 3: Criar template a partir de produção
- Arquivo origem:
.env.production
- Ação: Clique direito → Selecione
.env.example
- Resultado:
.env.example criado como documentação
Funcionalidades da conversão
A extensão inteligentemente converte os valores baseado no tipo:
- Strings entre aspas →
"" ou ''
- Valores booleanos →
true
- Números →
0
- E-mails →
user@example.com
- URLs →
https://example.com
- Domínios →
example.com
- Outros valores → string vazia
- Comentários e linhas vazias são preservados
Exemplo
Arquivo .env original:
# Configurações da aplicação
APP_NAME="Minha App"
APP_PORT=3000
APP_DEBUG=true
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
ADMIN_EMAIL=admin@mycompany.com
# Configurações de API
API_KEY=abc123def456
API_ENDPOINT=https://api.example.com/v1
Arquivo .env.production gerado:
# .env.production
# Configurações para ambiente de produção
# Gerado automaticamente a partir do arquivo .env
# Autor: Rodrigo Da Silva Santos
# Data: 15/09/2025
# Configurações da aplicação
APP_NAME=""
APP_PORT=0
APP_DEBUG=true
DATABASE_URL=https://example.com
ADMIN_EMAIL=user@example.com
# Configurações de API
API_KEY=
API_ENDPOINT=https://example.com
Instalação
Via Marketplace (Recomendado)
- Abra o VS Code
- Vá para Extensions (
Ctrl+Shift+X)
- Busque por "DotEnv Manager"
- Clique em "Install"
Via arquivo VSIX
- Baixe o arquivo
dotenv-manager-1.4.0.vsix do repositório
- No VS Code:
Ctrl+Shift+P → "Extensions: Install from VSIX"
- Selecione o arquivo baixado
- Reinicie o VS Code se necessário
Para desenvolvimento
- Clone o repositório:
git clone https://github.com/dasilva95Ro/DotEnvManager.git
- Execute
npm install para instalar dependências
- Abra o projeto no VS Code
- Pressione
F5 para executar em modo de desenvolvimento
Documentação Adicional
Contribuição
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/nova-funcionalidade)
- Commit suas mudanças (
git commit -am 'Adiciona nova funcionalidade')
- Push para a branch (
git push origin feature/nova-funcionalidade)
- Abra um Pull Request
Problemas e Sugestões
Versões
v1.4.0 (Atual)
- 🚀 Suporte para qualquer arquivo .env. como origem*
- ✨ Filtro automático do arquivo de origem no seletor
- 🎯 Placeholder dinâmico mostrando arquivo base
- 🔄 Flexibilidade total para criar qualquer combinação de ambientes
v1.3.0
- ✅ Melhorias de segurança completas
- ✅ Documentação técnica abrangente
- ✅ Validações robustas de entrada
- ✅ Proteção contra path traversal
v1.2.0
- ✅ Informações de autoria e data
- ✅ Múltiplos ambientes suportados
v1.1.0
- ✅ Seleção interativa de ambientes
- ✅ Nomes personalizados
Autor
Rodrigo Santos - GitHub
Sobre o Desenvolvimento
🤖 Esta extensão foi desenvolvida 100% com auxílio de IA Claude Code
Esta extensão representa um exemplo prático de como a inteligência artificial pode acelerar o desenvolvimento de software, desde a concepção inicial até a implementação final com validações de segurança enterprise-level.
Tecnologias e Ferramentas Utilizadas:
- Claude Code: IA para desenvolvimento completo
- TypeScript: Linguagem principal
- VS Code API: Framework de extensões
- Node.js: Runtime e APIs do sistema
- ESLint: Análise estática de código
Processo de Desenvolvimento:
- 🎯 Concepção: Definição de requisitos e funcionalidades
- 🏗️ Arquitetura: Estruturação do código e padrões
- 💻 Implementação: Desenvolvimento das funcionalidades principais
- 🔒 Segurança: Implementação de validações robustas
- 📚 Documentação: Criação de documentação técnica completa
- 🧪 Testes: Validação e casos de teste
- 📦 Distribuição: Empacotamento para produção
Licença
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
