CLAW IA - LIVE SERVER

CLAW IA - LIVE SERVER é uma extensão profissional para Visual Studio Code que fornece um servidor local de desenvolvimento com live reload, suporte a multi-root workspace, HTTPS automático e abertura de páginas na URL ativa do servidor.

🔥 Ideal para desenvolvimento web com HTML, CSS, JavaScript e TypeScript, com suporte a SPAs, hot-reload e preview integrado.

✨ Recursos

Recurso	Descrição
✅ Live Reload	Recarregamento automático ao salvar arquivos (HTML/CSS/JS/TS)
✅ HTTPS Automático	Geração de certificado auto-assinado ou uso de certificado próprio
✅ Multi-root Workspace	Suporte completo a múltiplas pastas no mesmo workspace
✅ Status Bar Integrada	Botão CLAW na barra de status com indicador visual
✅ Preview no VS Code	Visualização do servidor diretamente no editor
✅ Navegador Externo	Abre a URL ativa no navegador de sua preferência
✅ Proxy Reverso	Configuração de proxy para APIs e serviços externos
✅ CORS Configurável	Headers CORS habilitáveis para desenvolvimento front-end
✅ Logs Detalhados	Output channel dedicado com timestamps e categorias
✅ Segurança	Headers CSP, proteção contra path traversal, validação de porta/host
✅ WebSocket	Live reload via WebSocket com reconexão automática
✅ SPA Support	Fallback para arquivo único em aplicações single-page

📦 Instalação

Pelo Marketplace (Recomendado)

Abra o Visual Studio Code
Acesse Extensões (Ctrl+Shift+X / Cmd+Shift+X)
Pesquise por CLAW IA - LIVE SERVER
Clique em Instalar

Instalação local

git clone https://github.com/RafaelBatistaDev/CLAW-IA---LIVE-SERVER.git
cd CLAW-IA---LIVE-SERVER
npm install
npm run compile

Abra a pasta no VS Code e pressione F5 para executar em modo de desenvolvimento.

🚀 Uso

Comandos

Comando	Descrição	Atalho (Win/Linux)	Atalho (Mac)
`claw.toggleServer`	Iniciar/Parar servidor	—	—
`claw.startServer`	Iniciar servidor	`Alt+L` `Alt+O`	`Cmd+L` `Cmd+O`
`claw.stopServer`	Parar servidor	`Alt+L` `Alt+C`	`Cmd+L` `Cmd+C`
`claw.openExternal`	Abrir no navegador externo	—	—
`claw.changeWorkspace`	Trocar workspace (multi-root)	—	—
`claw.showSettings`	Abrir configurações	—	—
`claw.forceStop`	Resetar servidor (forçar parada)	—	—

Clique com botão direito em arquivos HTML ou XML no editor/explorador para iniciar/parar o servidor.

⚙️ Configuração

A extensão lê as configurações em settings.json usando o namespace liveServer.settings.

Exemplo básico

{
  "liveServer.settings.port": 5500,
  "liveServer.settings.host": "127.0.0.1",
  "liveServer.settings.noBrowser": false,
  "liveServer.settings.useLocalIp": false
}

Configurações recomendadas

Configuração	Valor	Descrição
`liveServer.settings.port`	`0`	Porta aleatória disponível
`liveServer.settings.useLocalIp`	`true`	Acessível de outros dispositivos na rede
`liveServer.settings.cors`	`true`	APIs e aplicações front-end
`liveServer.settings.file`	`"index.html"`	Fallback para SPAs
`liveServer.settings.https.enable`	`true`	HTTPS com certificado auto-assinado

Configurações completas

Consulte a documentação de configuração para todas as opções disponíveis.

🛠️ Desenvolvimento

Tecnologias

Runtime: Node.js 18+
Linguagem: TypeScript 5.7
Framework: Express.js 4
Build: TypeScript Compiler
Lint: ESLint + TypeScript ESLint
WS: WebSocket (ws) + Chokidar

Scripts disponíveis

npm run compile    # Compilar TypeScript
npm run watch      # Compilar em modo watch
npm run lint       # Verificar código com ESLint
npm run lint:fix   # Corrigir problemas de lint automaticamente
npm run package    # Empacotar extensão .vsix

Estrutura do projeto

src/
├── extension.ts              # Ponto de entrada da extensão
├── server.ts                 # Servidor Express + WebSocket
├── security.ts               # Validação e headers de segurança
├── express-http-proxy.d.ts   # Tipos para express-http-proxy
└── selfsigned.d.ts           # Tipos para selfsigned

📄 Licença

Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.

🤝 Contribuição

Contribuições são bem-vindas! Veja CONTRIBUTING.md para guia de contribuição.

_{Desenvolvido com ❤️ por Rafael Batista}
_{🔗 github.com/RafaelBatistaDev/CLAW-IA---LIVE-SERVER}

CLAW IA - Live Server

Rafael Batista