Base de Conhecimento

Depois de enviar a pasta dist ao cPanel, alguns ajustes de domínio, HTTPS e roteamento ainda podem ser necessários. Abaixo estão as verificações mais comuns.

Prefira domínio ou subdomínio na raiz

Para uma primeira publicação, utilize um endereço como app.suaempresa.com.br apontando diretamente para a pasta da aplicação. Publicar em uma subpasta, como suaempresa.com.br/app, pode exigir alteração do caminho base no projeto e novo build.

Confirmar a raiz do documento

1. Acesse cPanel → Domínios → Domínios.
2. Localize o domínio.
3. Confira a raiz do documento.
4. Verifique se index.html e a pasta assets estão diretamente nesse local.

DNS

O domínio precisa resolver para o servidor da hospedagem. Edite os registros no provedor indicado pelos nameservers autoritativos.

• Se o DNS estiver na Invirtua, utilize o Editor de Zona do cPanel.
• Se estiver no Cloudflare ou em outro provedor, faça a alteração naquele painel.
• Revise registros A, AAAA e CNAME antigos que possam apontar para outro destino.
• Não altere MX, SPF, DKIM ou DMARC ao publicar apenas o site.

HTTPS

Depois que o DNS apontar para a hospedagem, o AutoSSL tentará emitir o certificado. Ative Forçar redirecionamento HTTPS somente quando o certificado estiver válido.

Um registro AAAA apontando para outro servidor pode fazer parte dos acessos chegar ao destino errado e também prejudicar a validação do certificado.

Erro 404 ao atualizar uma página interna

Se a página inicial abre, mas endereços como /login ou /clientes retornam 404 quando acessados diretamente, crie na raiz o arquivo .htaccess:

RewriteEngine On
RewriteBase /
RewriteRule ^index.html$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.html [L]

Página em branco

• Confirme que foi enviado o conteúdo de dist, não o código-fonte.
• Verifique se index.html está na raiz correta.
• Abra as ferramentas do navegador e consulte erros no Console.
• Verifique se os arquivos da pasta assets retornam normalmente.
• Se o projeto foi criado para uma subpasta diferente, ajuste o caminho base e gere novo build.

A versão antiga continua aparecendo

• Teste em janela privativa.
• Atualize a página ignorando o cache.
• Confirme que os arquivos novos foram enviados à raiz correta.
• Se houver CDN ou Cloudflare, revise o cache nesse serviço.
• Verifique se um Service Worker antigo está mantendo uma versão anterior.

Login ou banco de dados não funciona

• Confirme se as variáveis VITE_ corretas estavam presentes durante o build.
• Revise se o novo domínio está autorizado no provedor de autenticação.
• Consulte erros de RLS, CORS e rede no navegador e no backend.
• Confirme se Lovable Cloud, Supabase ou outro backend permanece ativo.
• Não tente resolver erros de autorização expondo chaves administrativas no frontend.

Erro 403 ou arquivos não carregam

Arquivos normalmente utilizam permissão 644 e diretórios 755. Não aplique 777 como solução genérica. Verifique também nomes de arquivo, diferenças entre letras maiúsculas e minúsculas e regras existentes no .htaccess.

O que informar ao suporte

• domínio utilizado;
• raiz do documento;
• etapa que apresentou erro;
• mensagem completa do navegador ou do build;
• horário aproximado do teste;
• se a aplicação usa Lovable Cloud, Supabase ou apenas arquivos estáticos.

Não envie senhas, tokens, chaves privadas ou conteúdo de arquivos .env. O suporte poderá solicitar apenas os nomes das variáveis e mensagens de erro necessárias ao diagnóstico.