Por que o deploy automático via GitHub não funciona (e como publicar)?

Criou seu site no Lovable e quer colocá-lo no ar numa hospedagem cPanel? Se você tentou conectar o repositório do GitHub e usar o deploy automático, percebeu que não funciona — o site simplesmente não abre. Calma: isso é esperado, e tem um motivo técnico simples. Neste artigo você entende por que o deploy automático via GitHub não funciona com projetos do Lovable no cPanel e como publicar do jeito certo.

Neste artigo

Por que o deploy automático via GitHub não funciona
A solução: preparar os arquivos antes de subir
Passo a passo resumido
Vídeo: tutorial completo
Dicas importantes na hora de subir
Perguntas frequentes

Por que o deploy automático via GitHub não funciona

O Lovable gera um projeto React + Vite — ou seja, código-fonte, e não o site já pronto. O GitHub guarda exatamente esse código-fonte. Quando o cPanel puxa o repositório pelo deploy via Git, ele apenas copia esses arquivos de código para o servidor.

O problema é que o navegador não consegue executar código-fonte diretamente (arquivos .tsx, .ts e afins). Falta a etapa de build (compilação), que transforma esse código nos arquivos finais que o navegador entende: HTML, CSS e JavaScript prontos.

📦 O que o Lovable/GitHub tem

Código-fonte do projeto (React/Vite). Precisa ser compilado antes de virar site.

🌐 O que o cPanel precisa

Arquivos finais (HTML, CSS e JS) que o navegador abre direto.

💡

Resumindo: o deploy via Git no cPanel copia arquivos, mas não compila o projeto. Por isso o build precisa ser feito antes — normalmente no seu próprio computador.

A solução: preparar os arquivos antes de subir

A forma correta de publicar é fazer o build do projeto no seu computador e subir apenas os arquivos finais gerados. Para isso você vai precisar do Node.js instalado e de dois comandos no terminal:

npm i
npm run build

O npm i instala as dependências do projeto, e o npm run build gera uma pasta chamada dist, com o site já compilado e pronto para o navegador. É o conteúdo dessa pasta que você envia para o cPanel.

Ainda não tem o Node.js? Baixe pelo site oficial: nodejs.org/en/download.

Passo a passo resumido

Instale o Node.js no seu computador (Windows, Mac ou Linux).
Baixe o projeto do Lovable (pelo GitHub, opção Download ZIP) e extraia a pasta.
Abra o terminal dentro da pasta do projeto e rode npm i.
Em seguida, rode npm run build para gerar a pasta dist.
No cPanel, envie o conteúdo da pasta dist para dentro do public_html.

Vídeo: tutorial completo

No vídeo abaixo eu mostro o processo completo no Windows, do Node.js ao upload no cPanel:

Dicas importantes na hora de subir

⚠️

Suba o conteúdo da pasta dist (o index.html e a pasta de assets), e não a pasta dist em si. Caso contrário o site abre em um subdiretório errado.

Antes de enviar, apague os arquivos padrão que já vêm no public_html (como o default.html).
Se o seu projeto tem várias páginas/rotas (aplicação SPA), pode ser necessário um arquivo .htaccess para o roteamento funcionar — o passo a passo aparece no vídeo.
Sempre que atualizar o site no Lovable, é preciso buildar de novo e reenviar os arquivos. Por isso não há “deploy automático” nesse fluxo.

Perguntas frequentes

Dá para fazer deploy automático do Lovable pelo GitHub no cPanel?

Não diretamente. O GitHub guarda o código-fonte do projeto, e o cPanel só copia esses arquivos sem compilá-los. É preciso fazer o build (com npm run build) antes de subir os arquivos finais.

Por que meu site do Lovable não abre depois de subir o repositório?

Porque você subiu o código-fonte, e não o site compilado. O navegador não executa arquivos .tsx/.ts. Rode o build no seu computador e envie apenas o conteúdo da pasta dist.

O que é o build e por que ele é necessário?

Build é o processo que compila o código-fonte do projeto nos arquivos finais (HTML, CSS e JavaScript) que o navegador entende. Sem ele, o servidor tem apenas o projeto, e não o site pronto para visitação.

Preciso instalar o Node.js para publicar um site do Lovable?

Sim. O Node.js é o que permite rodar os comandos npm i e npm run build no seu computador para gerar os arquivos finais.

🚀

Hospede seu site com foco em velocidade

Depois de buildar seu projeto do Lovable, suba para uma hospedagem rápida e estável. Os servidores da Nuvem usam LiteSpeed e NVMe para entregar seu site no menor tempo possível.

Conhecer os planos

Dúvidas? Fale com a gente em suporte@nuvemhospedagem.com.br.