​
Desenvolvimento de Aplicações Express Profissionais

  • Antes de começar, certifique-se de ter o Node.js e npm instalados em seu sistema. Caso ainda não os possua, você pode baixá-los do site oficial do Node.js.
  • Em seguida, será necessário criar uma conta na Square Cloud, o que pode ser feito através da página de cadastro. Você pode utilizar seu email para criar uma conta.
  • Por fim, você precisa ter um plano pago ativo em sua conta. Você pode visualizar nossos planos e adquirir um de acordo com suas necessidades aqui.

​
Configuração do Express

Para utilizar o Express, você precisa instalá-lo em seu sistema. Execute o seguinte comando: 
npm install express
Este comando instala o pacote express em seu sistema, permitindo que você use o Express em seu terminal.

​
Criação de Projeto Express

Para criar um novo projeto Express, você pode começar criando um novo arquivo e escrevendo o seguinte código:
app.js
// Importando o módulo Express
const express = require('express');

// Criando uma nova aplicação Express
const app = express();

// Definindo a porta como 80
// A porta 80 é a porta padrão para tráfego HTTP.
const port = 80;

// Definindo um manipulador de rota para a rota '/'
// Este manipulador de rota envia 'Hello World!' quando acessado.
app.get('/', (req, res) => {
  res.send('Hello World!');
});

// Fazendo nossa aplicação Express escutar na porta 80
app.listen(port, () => {
  // Este bloco de código será executado uma vez que o servidor estiver escutando na porta 80
  console.log(`Aplicação exemplo escutando na porta ${port}`);
});

​
Criação do Arquivo de Configuração da Square Cloud

Saiba mais sobre: como criar o arquivo de configuração para a Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar sua aplicação; ele será usado para definir o nome, descrição, versão, arquivo principal, entre outras coisas.

​
Configuração do Campo START

No arquivo de configuração da Square Cloud, o campo START é opcional e só é necessário se você estiver usando um script personalizado para iniciar o website ou API. No exemplo fornecido, o campo START não é necessário.

​
Aquisição de Plano Antes do Upload do Projeto

Antes de fazer o upload do seu projeto para a Square Cloud, é importante entender que você precisa adquirir um plano. O tipo de plano que você escolher dependerá dos recursos exigidos pela sua aplicação. Você pode visualizar nossos planos aqui.
Está se perguntando quanta RAM e CPU seu plano precisa para hospedar uma aplicação Express? Não se preocupe, estamos aqui para ajudar. Express.js é um framework para Node.js que fornece recursos mínimos para construção de servidores web. É fácil de aprender, altamente flexível e adequado para uma ampla gama de aplicações, tornando-o uma excelente escolha para desenvolvimento web. Nosso plano Standard oferece 4GB de RAM e 4vCPU, que deve ser suficiente para a maioria das aplicações Express. No entanto, se você está trabalhando em um projeto maior ou precisa de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode garantir desempenho suave mesmo sob alta demanda. Para adquirir, simplesmente clique aqui.

​
Upload do Projeto para a Square Cloud

Após preparar os arquivos do seu projeto, agora você pode fazer o upload deles para a Square Cloud e hospedar seu projeto.
Acesse o Dashboard da Square Cloud e faça o upload dos arquivos do seu projeto.

​
Recursos Adicionais

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

​
Solução de Problemas

​
Domínio Personalizado

Para usar domínio personalizado (ex: meusite.com) ao invés da URL padrão https://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, use mais RAM para evitar erro LACK_OF_RAM e garantir performance.

​
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.

​
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.
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.