Publique sua build do Vite ou React da pasta dist

Uma build de front-end moderna é, por design, uma pasta de arquivos estáticos, esse é o ponto central da etapa de build. Vite, Create React App, Vue CLI, o adaptador estático do SvelteKit e Astro todos emitem um index.html mais bundles de JS/CSS com fingerprint e seus assets. Nenhum servidor é necessário para servi-los; você só precisa de um lugar para colocar os arquivos. Compactar essa pasta e enviá-la aqui é o caminho mais curto de npm run build até uma URL pública, sem CI, sem configuração de deploy e nada para instalar.

Diferentes ferramentas nomeiam a pasta de saída de formas distintas: Vite escreve dist/, Create React App escreve build/, uma exportação estática de Next ou Nuxt escreve out/, Jekyll e 11ty escrevem _site/ e public/. Você não precisa lembrar qual, se seu ZIP contiver uma dessas pastas (ou uma pasta envolvente ao compactar pelo desktop), detectamos a raiz web real e servimos a partir dela. Compacte a saída da build em vez do código-fonte; enviar um projeto sem build não renderizará, e avisaremos se não encontrarmos um index.html.

Apps de página única roteiam no navegador: /dashboard e /settings são tratados pelo React Router ou Vue Router, não por arquivos HTML separados. Isso significa que um visitante que abre um link direto, ou atualiza em uma página interna, precisa que o servidor devolva index.html para que seu router assuma o controle. Ative o modo de aplicação de página única e é exatamente isso que acontece: caminhos desconhecidos fazem fallback para index.html com 200, então recarregamentos e links diretos compartilhados funcionam em vez de retornar 404. Deixe desativado para um site multipágina comum e caminhos desconhecidos retornam um 404 real (ou seu próprio 404.html).

Boas ferramentas de build fazem fingerprint nos seus bundles, app.4f3a9c2b.js, exatamente para que possam ser cacheados para sempre. Respeitamos isso: assets com hash de conteúdo são servidos com cache imutável de um ano, então visitas repetidas são instantâneas, enquanto seu index.html é servido sem cache para que um novo upload apareça imediatamente. Você obtém o desempenho do cache agressivo sem a armadilha clássica de um arquivo HTML desatualizado apontando para bundles que não existem mais. Publique uma nova build enviando um novo ZIP; a URL permanece a mesma e os visitantes recebem a nova versão no próximo carregamento.

Uma build hospedada em uma URL aleatória serve para prévia, mas um app real precisa de um endereço real. No Pro, conecte seu domínio ou subdomínio e provisionamos HTTPS automaticamente, sem configuração de certificado, sem renovações. Isso torna este um lar legítimo para um pequeno front-end de produção: uma ferramenta interna, um site de marketing, um app de documentação, uma entrega para cliente. Tudo o que o navegador precisa para rodar seu app é servido corretamente; simplesmente não há backend, que é o limite honesto da hospedagem estática.

Isso serve seus arquivos estáticos compilados e nada mais: sem renderização no servidor por requisição, sem rotas de API, sem banco de dados. Se seu app chama uma API externa do navegador via HTTPS, isso continua funcionando. Se depende de código de servidor, componentes de servidor do Next.js renderizados por requisição, endpoints do SvelteKit, segredos de ambiente lidos no servidor, você precisa de uma plataforma que execute esse servidor, e deve exportar uma build totalmente estática ou hospedar em outro lugar. Dito claramente: traga sua saída compilada e tenha uma hospedagem estática rápida; traga um app dependente de servidor e a hospedagem estática é a ferramenta errada.