🚀 Introdução
- Antes de começar, certifique‑se de que você possui um editor de texto adequado para criar arquivos HTML e CSS. Recomendamos o Visual Studio Code ou qualquer outro editor de sua preferência.
- Em seguida, será necessário criar uma conta na Square Cloud, o que pode ser feito através da página de login. Você pode usar seu e‑mail, GitHub ou ambos para criar a conta.
- Por fim, é necessário ter um plano pago ativo na sua conta. Você pode ver nossos planos e adquirir um conforme sua necessidade aqui.
A Square Cloud oferece suporte nativo para projetos estáticos, como sites HTML/CSS. Isso significa que você pode hospedar facilmente seus arquivos HTML, CSS e outros recursos estáticos na plataforma. Com CDN premium integrado, seus sites serão entregues rapidamente aos usuários em todo o mundo.
Se você estiver enviando sua aplicação através do website da Square Cloud, você pode ignorar a seção abaixo. O site cria automaticamente o arquivo de configuração
squarecloud.app para você.📄 Arquivos Obrigatórios
- index.html (Exemplo de arquivo principal).
- vite.html (Exemplo de arquivo principal para projetos Vite).
- 404.html (Arquivo de roteamento de erros 404, opcional).
🖥️ Preparando o projeto
Antes de hospedar seu projeto na Square Cloud, primeiro verifique se os arquivos do projeto estão corretamente configurados para hospedagem.📤 Como hospedar seu projeto
Agora que você preparou todos os arquivos do seu projeto HTML/CSS, o próximo passo é enviá-los para a Square Cloud e colocar sua aplicação no ar. Existem varias formas de fazer o upload, mas vamos abordar duas: via Dashboard ou via CLI.Via dashboard
1
Acesse a página de upload
Acesse a página de upload e envie seu arquivo zip.
2
Configure seu ambiente
Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar "Publicação na Web" e definir um subdomínio para o seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar "Publicação na Web" e definir um subdomínio para o seu projeto.
3
Faça o deploy do projeto
Por fim, clique no botão "Deploy" para hospedar seu projeto no Square Cloud.
Após o deploy, você poderá monitorar o status e os registros do seu projeto no painel.

Via CLI
Para usar esse método, você precisa criar um arquivo de configuração chamadosquarecloud.app no diretório raiz do seu projeto. Esse arquivo conterá a configuração necessária para o seu projeto.
Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.
O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar seu aplicativo; ele será usado para definir seu ambiente.
1
Primeiro Passo
Primeiro, você precisa ter a CLI instalada em seu ambiente. Se você ainda não a possui, execute o seguinte comando em seu terminal:Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
- Windows
- Linux, macOS, e WSL
2
Segundo Passo
Agora, para autenticar e usar outros comandos da CLI, você encontrará sua chave de autorização aqui clicando em "Solicitar Chave da API". Após obter sua chave de autorização, execute o seguinte comando:
3
Terceiro Passo
Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:Ou se já possui o zip criado:

