Como fazer deploy de um 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 ou GitHub).
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. Ou vite.html, caso utilize o framework Vite.
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)

Acesse o painel da Square Cloud.
Clique em Enviar Aplicação.
Selecione a pasta do seu projeto ou arraste o arquivo .zip.
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

Instale a CLI:

npm i -g @squarecloud/cli

Autenticar na CLI: Pegue seu token de API na página de Minha Conta, indo na seção Autenticação e solicitando a chave API; Em sequência, se autentique na CLI com o comando a seguir.

squarecloud auth login

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

squarecloud upload

Ou se criou o zip:

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

Atualizado em: 26/05/2026

Este artigo foi útil?

Obrigado!