Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Introdução

Para desenvolver e hospedar um aplicativo no Square Cloud, é essencial seguir uma sequência estruturada de configurações e pré-requisitos. Este guia técnico abordará todo o processo, desde a configuração inicial até a implantação em produção.

​
Pré-requisitos

  • Conta Square Cloud: Cadastre-se através da página de cadastro usando seu e-mail.
  • Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.

​
Criando o projeto

Antes de começar, certifique-se de que o Node.js e o npm estejam instalados em seu sistema. Se ainda não os tiver, você pode baixá-los no site oficial do Node.js. Para criar um novo projeto SolidJS, execute o seguinte comando: 
npm init solid
Esse comando solicitará que você selecione um template, defina um nome e outras configurações para o novo projeto SolidJS.

​
Entendendo a diferença entre JavaScript e TypeScript

Ao escolher JavaScript, o Solid configura o projeto com as definições padrão de JavaScript. Ao escolher TypeScript, o Solid configura o projeto com ajustes de TypeScript, incluindo a geração do arquivo tsconfig.json.

​
Compilando o projeto

Antes de enviar para produção, gere os artefatos de produção usando o comando de build: 
npm run build
Esse comando irá construir sua aplicação e criar uma versão pronta para produção. O conteúdo gerado dependerá do template ou da ferramenta de build escolhida ao criar o projeto.

​
Implantação

Se você estiver usando o Vite como ferramenta de build, veja o tutorial do Vite para mais detalhes sobre como servir a build de produção. Se estiver usando o vinxi como ferramenta de build, ele inclui um servidor embutido para servir a build de produção. Você pode iniciar o servidor editando o script start no package.json para: 
"scripts": {
  "start": "vinxi start --port 80"
}
Em seguida, defina o comando START para iniciar o servidor: 
npm run start

​
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.
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.
Enviando aplicação para a Square Cloud

​
Via CLI

Para usar esse método, você precisa criar um arquivo de configuração chamado squarecloud.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:
npm install -g @squarecloud/cli
Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
squarecloud update
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:
squarecloud auth login
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:
squarecloud upload
Ou se já possui o zip criado:
squarecloud upload --file <caminho/para/zip>

​
Recursos adicionais

Para mais informações sobre o Solid e suas ferramentas, visite a documentação oficial do Solid. Lá você encontrará guias detalhados, tutoriais e a documentação da API para ajudar a aproveitar ao máximo o SolidJS.

​
Solução de problemas

​
Domínio Personalizado

Para usar domínio personalizado (ex: meusite.com) ao invés da URL padrão meusite.squareweb.app, você precisa do plano Standard ou superior. O subdomínio é definido pelo campo SUBDOMAIN no arquivo de configuração. Veja: Como configurar seu domínio personalizado.

​
Requisitos Mínimos de RAM

Mínimo: 512MB de RAM para websites/APIs simples. Para sites com frameworks (Next.JS, React, Vue, Angular, etc.), sugerimos sempre pelo menos 1GB de RAM. Para aplicações maiores, aumente a RAM para evitar que a aplicação fique sem memória e trave.

​
Não foi possível encontrar esse site.

Verifique se o subdomínio/domínio corresponde ao configurado no campo SUBDOMAIN ou nas configurações de domínio personalizado. Se você acabou de enviar o site, aguarde até 60 segundos para a Square liberar o primeiro acesso.
Erro de site não encontrado no Cloudflare

​
Site demorou demais para responder…

Verifique se configurou corretamente a porta 80 e host 0.0.0.0 na aplicação. Recomendamos usar as variáveis de ambiente forçadas da Square: PORT e HOST do arquivo .env.
Erro de timeout no Cloudflare

​
Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão.