Deploy de site estático (HTML, React, Vite)

1. Pré-requisitos

Antes de subir seu site, verifique se você possui:

• Conta na Square Cloud: Crie sua conta via Página de Registro (e-mail, Discord, GitHub ou Google).
• Plano Ativo: É necessário um plano pago para realizar a hospedagem. Confira os preços aqui.

Nota: A Square Cloud possui suporte nativo para sites estáticos com CDN premium incluso, garantindo que seu site carregue rápido em qualquer lugar do mundo.

2. Estrutura de arquivos obrigatórios

Certifique-se de que seu projeto possui ao menos o arquivo principal na raiz:

• index.html: O arquivo principal do seu site. Para uma single-page app com rotas no navegador (React Router, Vue Router etc.), renomeie o index.html do build para vite.html: caminhos desconhecidos passam a carregar a aplicação. Um site com um HTML por página mantém o index.html e usa o 404.html.
• 404.html: (Opcional) Página personalizada para erros de "Not Found".

3. Preparando o projeto

Antes de enviar, verifique se todos os links para arquivos CSS e imagens estão funcionando localmente.

Aviso importante: Se você for fazer o upload diretamente pelo painel (website), não precisa se preocupar com arquivos de configuração agora, pois o sistema criará o arquivo squarecloud⁠.app automaticamente para você se enviar via dashboard.

4. Como hospedar (Upload)

Com os arquivos prontos, você tem dois caminhos principais para colocar o site no ar:

Opção A: Via dashboard (Mais fácil)

1. Acesse o painel da Square Cloud.
2. Clique em Enviar Aplicação.
3. Arraste ou selecione o .zip do projeto (até 100 MB), ou importe do GitHub.
4. Informe nome da aplicação, aponte seu arquivo principal e marque publicação na web para definir seu subdomínio squareweb⁠.app.

Dica: Projetos estáticos não precisam de um "servidor" rodando (como Node.js ou Python), a própria Square Cloud já configura um servidor nginx para você.

Opção B: Via CLI

1. Instale a CLI:

npm i -g @squarecloud/cli

2. Autenticar na CLI: rode o comando abaixo e aprove no navegador. Para usar uma chave criada em Minha conta > Segurança, rode squarecloud auth login --token <chave>.

squarecloud auth login

3. Crie seu arquivo de configuração: o arquivo de configuração, squarecloud.config ou squarecloud⁠.app, deve estar presente no seu projeto
4. Faça o upload:

squarecloud upload

• Ou se criou o zip:

squarecloud upload --file <caminho/para/zip>

Atualizado em: 04/10/2026