# Como fazer o primeiro deploy na StayCloud

> Em Deploy IA › Adicionar projeto, escolha Importar do GitHub, Upload de .zip ou Deploy via CLI e siga as etapas da tela até publicar. O projeto ganha um endereço com SSL.

Para publicar seu primeiro projeto, abra **Deploy IA › Adicionar projeto** e escolha um método: **Importar do GitHub**, **Upload de .zip** ou **Deploy via CLI**. Cada caminho tem as suas etapas na tela; no fim, o projeto ganha um endereço com SSL.

## Antes de começar
- Você precisa de acesso ao painel em `dash.staycloud.com`.
- Tenha o projeto pronto: um repositório no GitHub, um arquivo `.zip` com o build estático (até 32 MB) ou a pasta do projeto no computador, para usar o terminal.
- Escolha um nome para o projeto em letras minúsculas, com hífen no lugar de espaço (de 3 a 32 caracteres), por exemplo `meu-app`.

## Abrir a criação do projeto
1. No menu da esquerda, clique em **Deploy IA**.
   Resultado: abre a página **Projetos**.

![Menu da esquerda com o item Deploy IA destacado](/imagens/0e88ce6e176b5c07d9fe72da3cce14c58ee84261f2a8ed2851fd6c53429284c2.webp)

2. Clique em **Adicionar projeto** (ou em **Adicionar**, no menu do Deploy).
   Resultado: abre a tela **Criar projeto**, na etapa **Selecionar um método**.

![Página Projetos com o botão Adicionar projeto no canto direito](/imagens/b9e2d60d18b6fe4f95d58eff3e65a5f494a3278eb0a600f81d93e1bedac0286c.webp)

![Tela Criar projeto com os três métodos: Importar do GitHub, Upload de .zip e Deploy via CLI (recomendado)](/imagens/166bff652cb8f2fd42f28d52e1288b25da9c914f8aa32a96650822180d9f710f.webp)

## Caminho 1: importar do GitHub
1. Clique em **Importar do GitHub**.
   Resultado: abre a etapa **Selecione um repositório**. Se a conta do GitHub ainda não estiver conectada, aparece o botão **Conectar GitHub**.

![Etapa Selecione um repositório com o quadro Conecte sua conta do GitHub, o botão Conectar GitHub, o link gerenciar integração e os botões Voltar e Próximo](/imagens/b9b9462239dc58bd4b1173b5e8f8ceb1f5685ed7225cf21af2b1907cbeb50a21.webp)

2. Conecte o GitHub, se preciso, escolha o repositório e clique em **Próximo**.
   Resultado: abre a etapa **Configure o projeto**, com as configurações de build detectadas.
3. Confira os campos: **Nome do projeto**, **Branch** (de onde sai cada publicação), **Preset de build** (o painel detecta pelo `package.json` e pelos arquivos do repositório), **Diretório de saída** e, se precisar, **Variáveis de ambiente** (**Adicionar variável** ou **Colar .env**).
4. Clique em **Publicar projeto**.
   Resultado: o build começa no servidor e, quando termina, o projeto fica no ar.

## Caminho 2: enviar um arquivo .zip
1. Na escolha do método, clique em **Upload de .zip**.
   Resultado: abre a etapa **Envie o build**.
2. Clique em **selecionar arquivo .zip** e escolha o arquivo (apenas `.zip`, até 32 MB).
3. Em **Nome do projeto**, digite o nome (por exemplo, `meu-app`). O endereço do projeto termina em `.stayai.space`.
4. Clique em **Criar e implantar**.
   Resultado: o conteúdo do `.zip` vai direto para a rede, sem etapa de build.

![Etapa Envie o build com a área selecionar arquivo .zip (apenas .zip, máximo 32 MB), o campo Nome do projeto com o final .stayai.space e os botões Voltar e Criar e implantar](/imagens/3ced7f7081e6f38345b18b056b196920cad5500e18a259965e997aa0a545dbf3.webp)

## Caminho 3: publicar pelo CLI
1. Na escolha do método, clique em **Deploy via CLI**.
   Resultado: abre a etapa **Conecte o CLI**, com o comando `npx @staysdev/setup init --token ••• --api-url •••`.
2. Clique em **Gerar comando**.
   Resultado: o painel mostra o comando completo, com o código de conexão, válido por 1 hora.
3. Cole o comando no terminal, dentro da pasta do projeto, e tecle Enter. O CLI cria o projeto na primeira execução.

![Etapa Conecte o CLI com o comando npx @staysdev/setup init escondido, o aviso de código válido por 1 hora, o link Como usar o CLI e o botão Gerar comando](/imagens/d9f1be350661b28daef07a97ba6e56db74a00705fb953f3433c41ab280aed4a5.webp)

O passo a passo completo do terminal e do agente de IA está nos artigos sobre CLI e sobre agente de IA, listados em Relacionados.

## Como saber se deu certo
O projeto aparece em **Projetos** com a etiqueta **no ar**. Na página do projeto, clique em **Abrir site** ou **Visitar site** para ver a publicação.

## Se algo der errado
### O botão de publicar fica apagado
Causa: falta algum campo obrigatório, como o arquivo, o repositório ou o nome do projeto. Solução: confira os campos da etapa e o formato do nome (minúsculas, hífen, de 3 a 32 caracteres).

### O build falhou
Causa: erro no projeto durante o build. Solução: abra o projeto, vá à aba **Logs** e leia a mensagem de erro do build.

## Relacionados
- O que é o Deploy IA da StayCloud e quando usar
- Como fazer deploy a partir do GitHub
- Como publicar um site enviando um arquivo .zip
- Como fazer deploy pelo terminal com a CLI
- Como fazer deploy com um agente de IA

---
Fonte: https://help.staycloud.com/artigos/como-fazer-o-primeiro-deploy-na-staycloud