DotEnv Manager
Uma extensão robusta e segura para VS Code que facilita o gerenciamento de arquivos .env para diferentes ambientes.
Funcionalidades
🆕 Novidades v1.5.0
📦 Templates Comunitários: Crie arquivos .env a partir de templates prontos para frameworks populares (Next.js, React, Django, Laravel, etc.)
- ✨ Auto-detecção de framework no projeto
- 🌐 Templates atualizados via GitHub (cache local de 24h)
- 🎯 10+ templates profissionais incluídos
📄 Conversor JSON → .env: Converta arquivos JSON para formato .env
- 🔄 Suporte a objetos aninhados
- 🎨 Formatação automática com cabeçalhos
- 💾 Escolha o tipo de arquivo .env a criar
✅ Criar arquivo .env principal: Agora é possível criar o arquivo .env base
- ⚠️ Confirmação de segurança extra
- 🛡️ Proteção contra sobrescrever origem
Funcionalidades Principais
- 🔄 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
📋 Opção 1: Criar a partir de outro arquivo .env
- 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 - Arquivo .env principal ⚠️ (agora disponível!).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
🎨 Opção 2: Criar a partir de Template (NOVO!)
- Use
Ctrl+Shift+P (ou Cmd+Shift+P no Mac) para abrir a paleta de comandos
- Digite "DotEnv Manager: Criar .env a partir de template" e execute
- Selecione um template da lista:
- ✨ Templates detectados no seu projeto aparecem no topo
- 📦 Escolha entre Next.js, React, Vite, Node, Express, Django, Laravel, Docker, PostgreSQL, MongoDB
- Escolha o tipo de arquivo .env a criar
- Pronto! Arquivo criado com variáveis de ambiente profissionais
Templates disponíveis:
- Next.js: Aplicações full-stack com database e auth
- React (CRA): SPAs com integração de API
- Vite: Projetos frontend modernos
- Node.js: Aplicações Node genéricas
- Express.js: APIs RESTful
- Django: Web framework Python
- Laravel: Framework PHP
- Docker: Configurações de containers
- PostgreSQL: Setup de banco PostgreSQL
- MongoDB: Setup de banco MongoDB
📄 Opção 3: Converter JSON para .env (NOVO!)
- Clique com o botão direito em um arquivo
.json no explorador
- Selecione "Converter JSON para .env" no menu de contexto
- Escolha o tipo de arquivo .env a criar
- Arquivo .env criado automaticamente com as chaves convertidas!
Exemplo de conversão:
{
"database": {
"host": "localhost",
"port": 5432
},
"api": {
"key": "abc123"
}
}
↓ Converte para ↓
DATABASE_HOST=localhost
DATABASE_PORT=5432
API_KEY=abc123
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.5.0 (Atual) 🎉
- 📦 Sistema de Templates Comunitários
- 10+ templates profissionais (Next.js, React, Django, Laravel, etc.)
- Auto-detecção de framework no projeto
- Templates via GitHub API com cache local (24h)
- Contribuições da comunidade bem-vindas!
- 📄 Conversor JSON → .env
- Conversão automática de objetos JSON
- Suporte a objetos aninhados
- Formatação profissional
- ✅ Criar arquivo .env principal
- Agora é possível criar o
.env base
- Confirmação de segurança extra
- Proteção contra sobrescrever fonte
v1.4.1
- 🎨 Ícone personalizado da extensão
v1.4.0
- 🚀 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.
