Ajuda · Sites feitos com IA
Como colocar um site React no ar
Rode npm install e npm run build na pasta do projeto e publique só a pasta gerada (dist, no Vite, ou build, no Create React App). Configure a hospedagem para devolver o index.html em qualquer endereço, coloque as variáveis de ambiente no lugar certo e aponte o domínio. Copiar a pasta do projeto inteira para a hospedagem não funciona.
Revisado em
O passo a passo
Instale o Node.js na versão que o projeto pede (veja o package.json ou um arquivo .nvmrc). Na pasta do projeto, rode npm install para baixar as dependências e npm run build para gerar a versão de produção. Se terminar sem erro, abra a pasta gerada: é ela, e só ela, que vai para a hospedagem.
Numa hospedagem comum, envie o conteúdo da pasta para a public_html. Em serviços como Vercel, Netlify e Cloudflare Pages, conecte o repositório e informe o comando de build e a pasta de saída; eles compilam a cada alteração.
O erro 404 ao recarregar
Sites React costumam ter uma página só, e as rotas (/sobre, /contato) são resolvidas no navegador. Quem abre direto um endereço interno pede ao servidor um arquivo que não existe e recebe 404. A correção é uma regra que devolve o index.html para qualquer caminho: um arquivo de redirecionamento no Netlify, uma configuração no Vercel ou uma regra no servidor da hospedagem comum.
Variáveis de ambiente
No Vite, só as variáveis com o prefixo VITE_ chegam ao navegador, e tudo o que chega ao navegador é público. Endereços de API e chaves públicas podem ficar ali; chaves secretas, nunca. As variáveis precisam estar configuradas na hospedagem no momento do build, não só no seu computador.
React e Google
Um app React de página única entrega pouco texto no HTML inicial. O Google consegue processar JavaScript, mas com atraso e nem sempre por completo, e outros robôs, como os das IAs, leem ainda menos. Para um site que precisa ser encontrado, vale pré-renderizar as páginas ou usar um framework que gera o HTML no servidor, como o Next.js.
Quando chamar alguém
Nem sempre precisa. Quando precisa, é isto.
Se o build dá erro, se as rotas quebram ao recarregar ou se o site precisa aparecer no Google, a gente publica, corrige as rotas e, quando faz sentido, prepara o site para ser lido pelos buscadores.
Serviço relacionado
Projetos feitos com IA→Revisão, publicação no seu domínio e manutenção.
Perguntas frequentes
Funciona numa hospedagem comum?
Funciona para o site estático gerado pelo build, com a regra de redirecionamento das rotas. Se o projeto tem servidor próprio, precisa de hospedagem Node.
Qual a diferença entre dist e build?
É só o nome da pasta de saída: o Vite usa dist, o Create React App usa build. O conteúdo tem o mesmo papel.
Preciso rodar o build a cada alteração?
Sim, ou deixar a hospedagem fazer isso sozinha, ligada ao repositório. É o jeito mais seguro de não publicar uma versão velha.
Continuar por aqui
Você fala com quem faz
O build passou e o site não?
Você fala direto com o Gabriel, pelo WhatsApp. Mande o que aconteceu e o endereço do site, se houver.