🔧 GBIT-FIX CLI

GBIT fix

Auto-repair, dependency conflict resolver & smart launcher for Node.js projects.

npx gbit-fix


📸 O Problema
Quem nunca clonou um repositório ou abriu um projeto antigo e se deparou com:

❌ node_modules corrompido ou quebrado

❌ Erros de conflito de versão (peer dependencies)

❌ Dúvida se deve rodar na raiz, no /frontend ou no /backend

❌ Ter que rodar manualmente 5 comandos no terminal para limpar e reiniciar

🚀 A Solução: gbit-fix

O gbit-fix é uma CLI inteligente parte do Ecossistema GBIT. Com um único comando, ele analisa o projeto, limpa arquivos corrompidos, resolve conflitos de dependência automaticamente e inicia o servidor do seu app!

========================================
     🔧 GBIT-FIX — Auto Repair & Start   
  ========================================

  🔎 'package.json' encontrado em: ./frontend
  📂 Diretório do Projeto: /meu-projeto/frontend
  
  🧹 Limpando cache e arquivos corrompidos...
  🗑️  Removendo: node_modules...
  🗑️  Removendo: package-lock.json...
  ⚡ Limpando npm cache...
  
  📦 Instalando dependências (Tentativa Padrão)...
  ⚠️ Falha na instalação padrão (Peer Dependency Conflict).
  🔄 Tentando novamente com "--legacy-peer-deps"...
  ✅ Dependências instaladas com sucesso!
  
  🚀 Inicializando o projeto com: "npm run dev"...
  🌐 Servidor rodando! Abra a URL no seu navegador.


  ✨ FuncionalidadesÍconeRecursosDescrição🔍Detecção InteligenteLocaliza automaticamente o package.json na raiz ou em pastas como /frontend, /backend, /server, /client.🧹Deep Clean & PurgeRemove node_modules, package-lock.json, yarn.lock, pnpm-lock.yaml e limpa o cache do NPM (--force).🛡️Auto Fallback FixTenta a instalação normal do NPM. Se houver conflitos de versão, executa --legacy-peer-deps automaticamente.🎯Smart Start StrategyDetecta scripts de inicialização (dev, start, serve, server.js) e sobe o app imediatamente.🌐Cross-PlatformFunciona perfeitamente em Windows, macOS e Linux.
  
  
🛠️ Como Usar

Execução Direta (Recomendado)
Não precisa instalar nada globalmente, basta rodar na pasta do seu projeto:

```bash
npx gbit-fix

Instalação Global (Opcional) Se preferir ter o comando sempre disponível no seu terminal:

npm install -g gbit-fix

Depois rode em qualquer repositório:

gbit-fix

🔄 Fluxo de Reparo Automático O gbit-fix executa a seguinte sequência de ações em segundos:

graph TD A[Executa npx gbit-fix] --> B[Analisa Estrutura de Pastas] B --> C{Achei o package.json?} C -- Sim --> D[Limpa node_modules e Lockfiles] C -- Não na raiz --> E[Busca em /frontend, /backend, etc.] E --> D D --> F[Executa npm install] F -- Sucesso --> H[Detecta Script de Startup] F -- Erro de Conflito --> G[Executa npm install --legacy-peer-deps] G --> H H --> I[Inicia o Servidor & Exibe URL]

🧬 Faz Parte do Ecossistema GBIT

O gbit-fix integra o ecossistema oficial de ferramentas CLI desenvolvidas para acelerar o workflow de desenvolvedores:

📦 gbit-container — Gerenciador e orquestrador nativo de processos.

⚡ gbit-next / gbit-react — Scaffolding rápido para projetos Web.

🗄️ gbit-db — Gestor e migrador de bancos SQL/SQLite no terminal.

🧱 create-gbit-app — Generator Fullstack com React, Node e Smart Contracts.

📄 Licença

Este projeto está sob a licença MIT. Sinta-se livre para usar, estudar e contribuir!

Desenvolvido por Gislaine Programadora com o Ecossistema GBIT 🚀

👩‍💻 Autora

Gislaine Cristina Desenvolvedora Full-Stack • DevOps • Blockchain Engineer GitHub: https://github.com/Gislaine-programadora