Como publicar um site Astro no painel WordPane

Antes de começar: identifique a saída do projeto

Abra o repositório e confira o package.json, o arquivo de configuração do Astro e as integrações usadas. O caso mais simples é um site totalmente pré-renderizado. Nesse cenário, o build produz arquivos que um servidor web pode entregar, sem manter o processo de desenvolvimento do Astro funcionando. A documentação oficial de deploy indica dist como diretório padrão de saída.

Se o projeto usa endpoints dinâmicos, sessões ou renderização sob demanda, ele pode exigir um adapter e um runtime. Não tente publicar apenas a interface e esperar que a autenticação ou a API apareçam automaticamente. Anote também serviços externos, variáveis, domínio, formulários e o destino dos dados enviados. Essa lista define o ambiente e as tarefas de validação.

Gere e confira a versão de produção

Execute os comandos a seguir na pasta do projeto. O exemplo pressupõe npm e package-lock.json versionado; se você usa outro gerenciador, mantenha o gerenciador e o lockfile do projeto. Confira a versão Node exigida pela sua versão do Astro. Pare se a instalação ou o build falhar e corrija o erro antes de enviar arquivos.

Use a prévia local para verificar as páginas e o resultado do build. A prévia serve para conferência, não como serviço permanente de produção. Abra uma página interna diretamente, examine as imagens e teste o formulário. Confira se a URL pública e a canônica apontam para seu domínio, em vez do endereço localhost.

npm ci
npm run build
npm run preview

Prepare a aplicação no painel

Na área do cliente, escolha a infraestrutura compatível e aguarde a conclusão da configuração do servidor. Para um site estático, avalie um ambiente web que permita servir os arquivos do projeto. Você não precisa contratar um runtime Node apenas porque o Astro usa Node durante o build. A geração pode acontecer no seu computador ou em uma automação de CI.

O caminho observado no painel é Applications → Create an Application → Custom. Os campos de versão PHP desse formulário pertencem à aplicação personalizada PHP; eles não transformam o Astro em PHP. O uso relevante para o site estático é preparar domínio, usuário e diretório público que servirá os arquivos. Confira esse comportamento na stack escolhida.

1. Informe Application Name e selecione Primary Domain ou Test Domain.
2. Para domínio próprio, informe o endereço e revise a opção de SSL; o DNS precisa apontar para o destino correto.
3. Escolha Custom e revise System User em Show Advance Options.
4. Confira Custom Webroot. O destino deve corresponder à pasta que receberá o conteúdo gerado, não ao diretório de código-fonte.
5. Crie a aplicação e confira o caminho no File Manager antes de enviar o build.

Envie o conteúdo de dist para o webroot

No File Manager da aplicação, confirme o breadcrumb e o caminho. O webroot observado em nossa documentação é public_html; um projeto com Custom Webroot pode usar outro destino. Envie o conteúdo interno de dist para essa pasta, preservando subpastas e nomes. Se você colocar a pasta dist inteira dentro de public_html, o index.html pode ficar um nível abaixo do que o servidor procura.

Use File Manager ou SFTP com o usuário correto. Mantenha uma cópia do site anterior antes de substituir arquivos. Não envie .env, .git, arquivos de credenciais ou dependências do ambiente de desenvolvimento para a pasta pública. Para futuras atualizações, publique o build completo de forma consistente: HTML novo com assets antigos, ou o contrário, pode quebrar a página.

Integre o Git sem pular a etapa de build

A integração Git permite vincular conta, repositório e branch à aplicação que disponibiliza esse recurso. Ela não significa, por si só, que todo projeto terá dependências instaladas e build executado. Na documentação WordPane, a aplicação criada pelo método Git oferece opções próprias de atualização; não há um campo de build universal confirmado para todas as stacks.

Você pode gerar os arquivos em uma rotina externa e publicar os artefatos, ou executar um procedimento de build no ambiente que tenha runtime, permissões e recursos necessários. Documente qual método sua equipe adotou. Só habilite atualização automática depois de provar que um commit produz os arquivos finais no webroot e que existe uma forma de recuperar a versão anterior.

O que muda com Astro e SSR

Para renderização no servidor, consulte o adapter Node oficial e a documentação correspondente à versão do projeto. Essa arquitetura precisa de um processo de produção, configuração de execução e proxy. O ambiente Node.js da WordPane está em beta; confira versão, comando, porta, variáveis e controles disponíveis antes da contratação.

Não copie o formulário PHP como se fosse o formulário Node. Se a aplicação depende de um runtime de edge ou de um serviço específico de outro provedor, prepare a adaptação. A hospedagem do código na VPS não reproduz automaticamente serviços de Vercel ou Cloudflare. Para esse caso, envie os requisitos e o comando de produção à equipe antes de seguir.

Valide o domínio e resolva as falhas mais comuns

• Página inicial funciona, mas uma rota retorna 404: confira a saída do build, as regras de URL e a estrutura de pastas.
• CSS ou imagens falham: confira o caminho base e se os assets gerados foram publicados junto do HTML.
• Formulário não envia: verifique o endpoint real e o backend responsável; HTML estático não processa mensagens sozinho.
• Uma alteração não aparece: confirme branch, build, diretório de destino e cache do navegador.
• SSL não conclui: confira o DNS e a configuração do domínio antes de repetir a emissão.
• Antes de divulgar, teste menu, páginas internas, metadados sociais e o cadastro que seu projeto oferece.

Onde a WordPane agrega à rotina

A plataforma reúne a criação ou conexão do servidor, acompanhamento de operações e consumo na área do cliente. No painel de controle, você encontra ferramentas para domínio, arquivos, integração Git, logs e backup conforme o ambiente configurado. Isso organiza tarefas que continuariam existindo mesmo quando a IA produz boa parte do código.

A cobrança por hora permite acompanhar o consumo do ambiente no saldo. O custo da infraestrutura é separado de modelos de IA, APIs e serviços externos usados pelo projeto. Comece com uma publicação de teste, registre os passos que funcionaram e escolha os recursos com base no comportamento observado. O primeiro resultado útil é um site acessível, atualizável e recuperável.