O guardião das suas variáveis de ambiente — escaneia, valida e gera
.envautomaticamente!
✨ Funcionalidades
- 🔍 Escaneia todo o projeto em busca de variáveis de ambiente
- 📋 Compara com o
.envexistente e aponta o que falta - ⚠️ Alerta sobre variáveis ausentes em tempo real
- ✅ Indica o que já está configurado (com valor mascarado
••••••) - 📦 Gera
.envEnterprise com seções organizadas por categoria - ⚡ Gera
.envLite com as variáveis essenciais do projeto - 🔄 Atualiza automaticamente ao salvar qualquer arquivo
.envouenv-config - 🗂️ Sidebar dedicada com status visual de cada variável
📦 Instalação
Via Marketplace
- Abrir VS Code
- Ir em Extensions (
Ctrl+Shift+X) - Buscar por
Albertool Sentinel - Clicar em Install
Via VSIX (manual)
- Baixar o arquivo
.vsixna aba Releases - No VS Code:
Ctrl+Shift+P→Extensions: Install from VSIX - Selecionar o arquivo baixado
🚀 Como usar
1. Sidebar
Clique no ícone 🛡️ na barra lateral esquerda do VS Code.
SENTINEL 🛡️ ENV VALIDATOR
⚠️ 2 variável(is) faltando de 6
➕ Criar .env Enterprise
⚡ Criar .env Lite
❌ Faltando (2)
❌ JWT_SECRET FALTANDO
❌ DB_PASSWORD FALTANDO
✅ Configuradas (4)
✅ PORT ••••••
✅ DB_HOST ••••••
2. Gerar .env automaticamente
Se o projeto não tiver .env, o Sentinel cria automaticamente ao abrir o VS Code.
Ou use os botões na sidebar:
| Botão | Descrição |
|---|---|
➕ Criar .env Enterprise |
Gera .env completo com todas as seções organizadas por categoria (Aplicação, Banco de Dados, Auth, Cache, Email, Storage, Logs, Integrações) |
⚡ Criar .env Lite |
Gera .env enxuto com as variáveis essenciais: PORT, NODE_ENV, DB e JWT |
3. Refresh manual
Clique no ícone 🔄 no topo da sidebar ou use Ctrl+Shift+P → Sentinel: Refresh.
📁 Estrutura do .env Enterprise
#################################################################
# GERADO PELO ALBERTOOL SENTINEL #
# NÃO COMMITAR ESTE ARQUIVO NO GIT #
#################################################################
# 🌐 APLICAÇÃO
NODE_ENV=
PORT=
APP_NAME=
APP_URL=
# 🗄️ BANCO DE DADOS
DB_HOST=
DB_PORT=
DB_USER=
DB_PASSWORD=
DB_NAME=
# 🔐 AUTENTICAÇÃO & SEGURANÇA
JWT_SECRET=
JWT_EXPIRES_IN=
# 📦 CACHE & FILAS
REDIS_HOST=
REDIS_PORT=
# ... e muito mais
⚙️ Fontes de escaneamento
O Sentinel detecta variáveis em:
src/config/env-config.ts— padrão Albertool.env.example— variáveis documentadas- Qualquer arquivo
.tsou.jscomprocess.env.VARIAVEL
🔒 Segurança
- Valores exibidos na sidebar sempre mascarados (
••••••) - Apenas os primeiros 3 caracteres visíveis no tooltip
- Nunca commite seu
.env— adicione ao.gitignore:
.env
🛣️ Roadmap
- Suporte a múltiplos ambientes (
.env.production,.env.staging) - Validação de tipos (número, URL, booleano)
- Integração com Docker Compose
- Export para GitHub Secrets
🤝 Contribuindo
- Fork o repositório
- Crie sua branch:
git checkout -b feat/minha-feature - Commit:
git commit -m 'feat: minha feature' - Push:
git push origin feat/minha-feature - Abra um Pull Request
📄 Licença
MIT © Albertool
Feito com ☕ e muita variável de ambiente