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

1. Clique com o botão direito em qualquer arquivo .env.* no explorador de arquivos (.env, .env.example, .env.production, etc.)
2. Selecione "Gerar arquivo .env para ambiente específico" no menu de contexto
3. 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:

1. Abra qualquer arquivo .env.* no editor
2. Use Ctrl+Shift+P (ou Cmd+Shift+P no Mac) para abrir a paleta de comandos
3. Digite "Gerar arquivo .env para ambiente específico" e execute o comando

🎨 Opção 2: Criar a partir de Template (NOVO!)

1. Use Ctrl+Shift+P (ou Cmd+Shift+P no Mac) para abrir a paleta de comandos
2. Digite "DotEnv Manager: Criar .env a partir de template" e execute
3. 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
4. Escolha o tipo de arquivo .env a criar
5. 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!)

1. Clique com o botão direito em um arquivo .json no explorador
2. Selecione "Converter JSON para .env" no menu de contexto
3. Escolha o tipo de arquivo .env a criar
4. 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)

1. Abra o VS Code
2. Vá para Extensions (Ctrl+Shift+X)
3. Busque por "DotEnv Manager"
4. Clique em "Install"

Via arquivo VSIX

1. Baixe o arquivo dotenv-manager-1.4.0.vsix do repositório
2. No VS Code: Ctrl+Shift+P → "Extensions: Install from VSIX"
3. Selecione o arquivo baixado
4. Reinicie o VS Code se necessário

Para desenvolvimento

1. Clone o repositório: git clone https://github.com/dasilva95Ro/DotEnvManager.git
2. Execute npm install para instalar dependências
3. Abra o projeto no VS Code
4. Pressione F5 para executar em modo de desenvolvimento

Documentação Adicional

• 📖 Documentação Técnica - Guia para desenvolvedores
• 🔒 Segurança - Informações sobre validações e boas práticas

Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/nova-funcionalidade)
3. Commit suas mudanças (git commit -am 'Adiciona nova funcionalidade')
4. Push para a branch (git push origin feature/nova-funcionalidade)
5. Abra um Pull Request

Problemas e Sugestões

• 🐛 Reportar Bug
• 💡 Sugerir Funcionalidade

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:

1. 🎯 Concepção: Definição de requisitos e funcionalidades
2. 🏗️ Arquitetura: Estruturação do código e padrões
3. 💻 Implementação: Desenvolvimento das funcionalidades principais
4. 🔒 Segurança: Implementação de validações robustas
5. 📚 Documentação: Criação de documentação técnica completa
6. 🧪 Testes: Validação e casos de teste
7. 📦 Distribuição: Empacotamento para produção

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.