Como subir um front-end React ou Next.js em hospedagem tradicional?

Antes de publicar um projeto React ou Next.js em hospedagem tradicional, a pergunta central não é “qual pasta eu envio?”, mas “esse projeto é estático ou precisa de servidor Node.js em tempo de execução?”. A própria documentação do Next.js diferencia claramente esses cenários: deploy como servidor Node suporta todos os recursos; export estático funciona apenas para projetos compatíveis com esse modelo.

Se o projeto é um React SPA clássico ou um Next.js configurado para saída estática, o fluxo tende a ser simples: gerar o build e publicar os arquivos finais no diretório web. Nesse caso, a preocupação principal passa a ser roteamento, cache e assets. Já se o projeto usa SSR, getServerSideProps, route handlers, server actions ou outras funcionalidades dependentes de servidor, a hospedagem precisa suportar processo Node, comando de start e proxy reverso.

O erro mais comum é presumir que todo projeto Next.js pode ser tratado como site estático. A documentação oficial mostra que isso não é verdade: alguns recursos simplesmente não existem sem servidor.

Quando você classifica corretamente o tipo de aplicação antes do deploy, evita um dos problemas mais recorrentes desse ecossistema: publicar um projeto funcional em desenvolvimento num ambiente incapaz de executar o que ele realmente precisa.