# Como publicar uma nova versão do projeto no Deploy

> Depois de mudar o projeto, publique de novo pelo terminal com staycloud deploy, pedindo ao agente de IA ou pelo botão Publicar atualização na página do projeto. A versão nova substitui a anterior quando o build termina.

Para colocar uma alteração no ar, publique o projeto de novo: pelo terminal com `staycloud deploy`, pedindo ao agente de IA ou pelo botão **Publicar atualização** na página do projeto. Quando o build termina, a versão nova entra no ar e a anterior aparece como **substituída**.

## Antes de começar
- Você precisa de um projeto já publicado no Deploy.
- Para publicar pelo terminal ou pelo agente de IA, o projeto precisa estar conectado ao CLI (veja os artigos de CLI e de agente de IA).
- Se mudou variáveis de ambiente, elas passam a valer nesta nova publicação.

## Abrir o projeto
1. No menu da esquerda, clique em **Deploy IA** e, na lista **Projetos**, clique no projeto.
   Resultado: abre a página do projeto, com o botão **Publicar atualização** no topo.

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

![Página Projetos com o projeto listado](/imagens/b0176ec058af3c91dd82b52b9d90f982db6c1e6adc176aa858350ef025960c43.webp)

## Publicar pelo painel
1. Clique em **Publicar atualização**.
   Resultado: abre a aba **Deploys** do projeto, com as opções de publicação.

![Topo da página do projeto com o botão Publicar atualização destacado, ao lado de Visitar site e Tour](/imagens/fccb0a38d13d4e37deb7abf6cbff0702effcf920b29d803ecaa5aa0bd077875d.webp)

2. Siga a opção que o painel mostrar, como **Publicar pelo CLI**.

![Aba Deploys com o título Publicações e o botão Publicar pelo CLI destacado](/imagens/c2e79575676875001e7efad93aeab1bb86dd060edf782d7f04cf210e2989e18b.webp)

Na mesma aba, o quadro **Deploy pelo terminal (CLI)** mostra os tokens deste projeto e o botão **gerar token deste projeto**, para conectar o terminal ou o agente de IA só a esse projeto.

![Quadro Deploy pelo terminal (CLI) com o botão gerar token deste projeto, o link ver todas as integrações e a lista com escopo, último uso e validade do token](/imagens/1df11c65720be60ae8490cdfa8e566e4c160b8e545c7299b4cec56f09258133e.webp)

## Publicar pelo terminal ou pelo agente de IA
1. No terminal, dentro da pasta do projeto já conectado, rode:
   ```
   staycloud deploy
   ```
   Resultado: o CLI envia a nova versão e o build começa.
2. Ou, no Claude Code, escreva `faça deploy na StayCloud`.
   Resultado: o agente publica e avisa quando a versão nova estiver no ar.

## Como saber se deu certo
Na aba **Deploys**, a publicação nova aparece no topo como **pronto**, e a anterior como **substituída**. Abra o site e confira a alteração.

## Se algo der errado
### O site continua mostrando a versão antiga
Causa: o build ainda não terminou, ou o navegador guardou a versão anterior. Solução: veja o estado na aba **Deploys** e, quando estiver **pronto**, recarregue a página com Ctrl+F5.

### A publicação falhou
Solução: abra a aba **Logs**, filtre por **Erros** e corrija o problema antes de publicar de novo. A versão anterior continua no ar.

## Relacionados
- Como fazer deploy pelo terminal com a CLI
- Como fazer deploy com um agente de IA
- Como acompanhar os deployments e ler os logs no Deploy

---
Fonte: https://help.staycloud.com/artigos/como-publicar-uma-nova-versao-do-projeto-no-deploy