- ✅ Pré-requisitos
- 1. Instalar o Node.js (com npm incluso)
- 2. Verificar a instalação
- Passo a Passo para Rodar o Projeto
- 1. Clonar ou descompactar o projeto
- 2. Instalar as dependências
- 3. Rodar o servidor de desenvolvimento
- 4. Build para produção (opcional)
- ️ Dicas úteis
- Estrutura típica do projeto Lovable
- Comandos importantes
- Problemas comuns
- ❌ “npm: comando não encontrado”
- ❌ “Error: Cannot find module”
- ❌ A porta 5173 já está em uso
- Quer deixar rodando como app fixo no Windows?
Este tutorial atualizado mostra como preparar o ambiente para rodar projetos Lovable modernos, usando Node.js junto com Vite, Next.js, React e Tailwind CSS.
Aqui você vai encontrar o passo a passo essencial para instalar o que precisa, configurar as dependências e iniciar o servidor local, além de dicas práticas para evitar os erros mais comuns. Tudo pensado para que o seu projeto Lovable funcione rápido, sem enrolação nem promessas vazias. Bora colocar a mão na massa!
✅ Pré-requisitos
Antes de tudo, instale o que é necessário:
1. Instalar o Node.js (com npm incluso)
Baixe e instale o LTS mais recente (marque para ele instalar as dependências durante a instalação principal)
https://nodejs.org
Após instalar, reinicie o PC se estiver no Windows 10/11 com WSL ou ambiente travando.
2. Verificar a instalação
Abra o Prompt de Comando ou PowerShell e rode:
Você deve ver as versões do Node e do npm. Algo como:
(ou se der bug rodar)
PS C:\Users\LINQ> Get-ExecutionPolicy
Restricted
PS C:\Users\LINQ> Set-ExecutionPolicy RemoteSigned
PS C:\Users\LINQ> Get-ExecutionPolicy
RemoteSigned
Passo a Passo para Rodar o Projeto
1. Clonar ou descompactar o projeto
-
Se for um
.zip, apenas extraia para uma pasta. -
Se for um repositório Git, clone:
2. Instalar as dependências
Dentro da pasta do projeto, rode:
Esse comando lê o package.json e instala tudo que é necessário (React, Vite, Tailwind, etc).
3. Rodar o servidor de desenvolvimento
Na maioria dos projetos Lovable modernos, o comando é:
Isso inicia o servidor local. Ele vai dizer algo como:
Local: http://localhost:5173
Abra isso no seu navegador!
4. Build para produção (opcional)
Se quiser gerar os arquivos prontos para colocar em um servidor, rode:
Os arquivos finais vão para a pasta dist (caso seja Vite ou React padrão).
️ Dicas úteis
Estrutura típica do projeto Lovable
Comandos importantes
-
npm run dev— inicia o servidor local -
npm run build— compila para produção -
npm run preview— visualiza o build gerado -
npx tailwindcss -i ./src/index.css -o ./dist/output.css --watch— se estiver usando Tailwind manualmente
Problemas comuns
❌ “npm: comando não encontrado”
Solução: reinicie o terminal após instalar o Node.js ou adicione o Node ao PATH.
❌ “Error: Cannot find module”
Solução: o
npm installnão foi rodado ou deu erro. Apaguenode_modulese tente novamente:
❌ A porta 5173 já está em uso
Solução: ou mate o processo travado, ou rode com outra porta:
Quer deixar rodando como app fixo no Windows?
Use o Electron, ou instale um PWA (alguns projetos Lovable já têm suporte). Alternativamente:
-
Abra no Chrome
-
Vá em
Menu › Mais Ferramentas › Criar atalho -
Marque “Abrir como janela”

