Pular para o conteúdo
Site PertoSite Perto
Menu

Seu site está pronto para hospedar?
Confira os arquivos primeiro.

A SitePerto recebe o HTML, o CSS e o JavaScript finais do seu site. Este guia ajuda a reconhecer a saída certa, entender o que precisa de servidor e resolver os problemas mais comuns antes da entrega.

Responsável editorial: Lucas Joaquim Cardoso · SitePerto / Store Experts

Atualizado em .

Como produzimos este conteúdo

O que seu projeto precisa para funcionar?

Um site estático é entregue ao navegador como arquivos prontos. Ele pode ter animações, menus e JavaScript. Isso não significa que a hospedagem execute o servidor, o banco ou os comandos usados para construir o projeto.

Compatibilidade depende dos arquivos e dos recursos usados, mesmo quando o site foi criado com IA.
Seu projetoCondiçãoO que preparar
HTML, CSS e JavaScript prontosÉ o caminho do importador estático.Envie o HTML único com recursos embutidos, ou a pasta/ZIP com entrada HTML, imagens, estilos e scripts.
React com VitePode funcionar com uma saída estática compatível.Gere o build, envie a pasta final e confira rotas, imagens e integrações. O nome do framework não garante que o projeto dispense servidor.
Next.jsDepende de uma exportação estática compatível.Recursos que exigem servidor precisam de adaptação ou outra infraestrutura. Confira os caminhos gerados e teste cada página no destino.
PHP, WordPress ou servidor Node.jsNão são executados pelo importador estático.Use hospedagem compatível com esse servidor ou prepare uma versão estática. Copiar os arquivos de PHP ou a pasta do projeto não converte suas funções.
Login, banco de dados ou API externaO frontend e o serviço externo têm responsabilidades separadas.Confira permissões, endereço de produção e limites do serviço. Credenciais de servidor ficam fora dos arquivos públicos; o banco não é enviado no ZIP.
Tema nativo SitePertoSegue o formato próprio de tema e seus controles visuais.Consulte a documentação do editor. Importar HTML independente não cria automaticamente esses controles.

A ferramenta de IA não define a compatibilidade. Peça a ela para identificar dependências de servidor e gerar os arquivos finais. Se o resultado precisa de um processo rodando continuamente ou de segredos no servidor, o envio estático sozinho não atende a essa parte.

Do projeto-fonte aos arquivos finais.

React com Vite

Em um projeto Vite já configurado, com dependências instaladas e scripts de build e prévia definidos, gere a saída e confira-a localmente:

No ambiente do seu projeto
npm run build
npm run preview

Por padrão, os arquivos finais ficam em dist. A pasta pode ter outro nome se o projeto mudou a configuração. Envie essa saída, preservando os assets. O comando de prévia serve para a conferência local, não para manter um servidor de produção.

Next.js com exportação estática

Next.js também pode gerar arquivos estáticos, quando o projeto é compatível com output: 'export'. O build produz a pasta out por padrão. Isso é diferente de enviar o projeto Next.js inteiro.

Server Actions, lógica que depende da requisição, algumas rotas dinâmicas e otimização de imagem com servidor precisam de revisão. A exportação deve concluir sem essas dependências; depois, confira páginas e recursos no destino.

As instruções variam conforme a versão e a configuração do projeto. Use as fontes oficiais abaixo antes de mudar o seu código.

O Drop recebe a saída pronta. Ele não instala dependências nem executa o build por você. Se você já tem um HTML pronto, não precisa passar por esses comandos.

Envie a pasta publicável, com seus recursos.

Este é um exemplo de saída pronta. Envie a pasta dist ou um ZIP com esse conteúdo; mantenha a organização dos arquivos.

Exemplo ilustrativo de uma saída estática
dist/
  index.html
  sobre.html
  assets/
    app.js
    estilos.css
    logo.svg

No Drop, a entrada index.html ou index.htm pode estar dentro da pasta publicável. Essa pasta é preparada para o envio. Se houver várias entradas possíveis, escolha apenas o site desejado. Arquivos de fora dessa pasta não acompanham o pacote preparado.

São limites diferentes.

  • Pacote: até 100 MB no envio, até 100 MB extraídos e 600 arquivos.
  • Conta Free: 100 MB compartilhados entre arquivos e projetos, não 100 MB extras para cada site.
  • Prévia local: há limites próprios; uma página preparada com seus recursos pode ultrapassar 8 MB e precisar de redução.
  • Validação: extensão, caminho e conteúdo dos arquivos também são conferidos. Estar abaixo do tamanho máximo não garante aprovação.

Um ZIP de 20 MB que ocupa 110 MB depois de extraído ultrapassa o limite do pacote. Mesmo um pacote válido precisa caber no espaço que resta na sua conta. Consulte o uso no painel e as condições do Free.

O navegador recebe arquivos públicos.

Não envie .env, senhas, chaves privadas, cópias de banco, node_modules ou arquivos internos. Variáveis incorporadas ao JavaScript durante o build também podem ficar visíveis. Serviços que dependem de segredos precisam tratá-los no servidor apropriado.

Se algo não abrir, comece pelo sintoma.

A página abre vazia

Confira se você enviou o build final, se a entrada HTML existe e se os scripts foram incluídos. Uma pasta src com componentes não é uma saída de publicação.

As imagens ou o estilo sumiram

Compare os caminhos escritos no HTML/CSS com as pastas enviadas, incluindo maiúsculas e minúsculas. Remova caminhos do seu computador e referências a localhost.

O início abre, mas outra página falha

Abra o endereço interno diretamente e recarregue. Rotas que só funcionam depois de clicar no menu podem depender de regras do servidor anterior; não suponha que redirects ou rewrites de outra hospedagem serão importados.

O formulário ou login não responde

A prévia é protegida e não valida envios reais. No site publicado, confira o serviço de destino, domínio autorizado e configuração de produção. Integrações próprias precisam ser mantidas por seu responsável.

O arquivo foi recusado

Confira tamanho comprimido e extraído, quantidade de arquivos, espaço da conta e a mensagem de validação. Remova arquivos de desenvolvimento; não apenas compacte de novo o mesmo conteúdo.

Um serviço externo pode exigir mudanças no endereço permitido, no formulário ou na autenticação quando o domínio muda. Publicar o frontend não migra banco de dados, e-mail ou serviços pagos de outro fornecedor.

Confira antes de entregar.

  1. Guarde a origem.

    Mantenha uma cópia do projeto e do pacote final. Antes de uma atualização, preserve também o que está publicado.

  2. Abra a prévia.

    Confira texto, imagens, navegação e apresentação no computador e no celular. Corrija os avisos de recursos ausentes.

  3. Teste no endereço final.

    Após publicar, abra e recarregue páginas internas. Confira HTTPS, links de contato e integrações reais.

  4. Combine a manutenção.

    Defina quem cuida do código, do domínio e dos serviços externos. A hospedagem e o conteúdo têm responsabilidades diferentes.

Referências para conferir o seu projeto.

As referências abaixo explicam a geração de arquivos estáticos. Elas não certificam a compatibilidade de qualquer projeto específico com a SitePerto. Consultadas em 7 de outubro de 2026.

Dúvidas de compatibilidade.

Posso hospedar um site React ou Vite na SitePerto?

Sim, quando o projeto gera HTML, CSS e JavaScript estáticos compatíveis. Em um projeto Vite configurado, o build normalmente gera a pasta dist. Envie os arquivos finais e teste páginas, imagens e integrações. Ter React ou Vite no projeto não garante que ele dispense servidor.

O SitePerto executa npm install ou o servidor do meu projeto?

Não no envio de HTML, ZIP ou pasta pelo Drop. Prepare a saída estática no seu ambiente ou com a ferramenta que criou o site. O importador não executa PHP, WordPress, Node.js, SSR nem banco de dados próprio.

Um ZIP de menos de 100 MB sempre cabe no Free?

Não. O tamanho do ZIP, o conteúdo extraído, a quantidade de arquivos e a quota da conta são verificações diferentes. O envio tem limite de 100 MB, até 100 MB extraídos e 600 arquivos; o Free tem 100 MB compartilhados entre arquivos e projetos. Um pacote pequeno comprimido pode ultrapassar esses limites.

Posso manter meu banco de dados ou API em outro serviço?

O frontend pode usar serviços externos compatíveis, mas eles continuam com suas próprias configurações, permissões, custos e disponibilidade. Segredos e credenciais de servidor não podem ficar no HTML ou JavaScript público. Confira as integrações na versão publicada; a prévia não comprova o funcionamento real desses serviços.