> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Execute seu app no Replit

> Peça ao Replit que execute um preview de desenvolvimento do seu repositório do GitHub ou GitLab, acompanhe o progresso da configuração e experimente o app antes de fazer sua primeira alteração pontual.

Veja seu aplicativo em execução antes de alterar o código dele. Este passo a passo usa o [Cloud Agent Demo](https://github.com/replit/cloud-agent-demo), uma pequena landing page sem banco de dados, credenciais ou serviços externos obrigatórios. Se você já tem um repositório, use a URL dele.

> [!NOTE]
>
> Não tem um repositório para testar? Você pode usar o Cloud Agent Demo se tiver recebido acesso. O repositório de exemplo é atualmente privado, não público.

## Execute seu app

Antes de começar, [conecte-se ao seu repositório](https://docs.replit.com/pt/build/code/connect-your-repository.md) se sua conta do GitHub ou do GitLab ainda não estiver conectada.

**1. Peça ao Replit que execute o app**

Para a demo, copie este prompt:

Execute [https://github.com/replit/cloud-agent-demo](https://github.com/replit/cloud-agent-demo) e mostre-me um preview.
Não faça push de alterações nem abra um pull request.

Se você tem seu próprio repositório, cole o link dele no lugar da URL da demo.

![Campo de mensagem do chat do Replit com um prompt para executar o Cloud Agent Demo e mostrar um preview sem fazer push de alterações nem abrir um pull request.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/cloud-agent-demo-prompt.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=d2961cd7d4183656174154ea0506a1aa)

O Replit prepara ou reutiliza uma configuração de desenvolvimento, instala as dependências e inicia o app. Ele pode usar as instruções do seu repositório para descobrir os comandos de configuração, então você não precisa determiná-los por conta própria.

O app roda em um sandbox na nuvem. Você não precisa criar um ambiente reutilizável antes; [Arquivos e ambiente](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#arquivos-e-ambiente) explica a diferença.

Se o seu aplicativo precisar de credenciais, insira-as pelo [fluxo seguro de secrets](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#secrets), não na sua mensagem. O Cloud Agent Demo não exige nenhuma.

**2. Visualize e salve o ambiente**

Experimente o preview em execução. Quando o app funcionar, você pode, opcionalmente, salvar a configuração dele para que chats futuros comecem com o repositório, o runtime, as ferramentas e as dependências já preparados.

Quando o Replit se oferecer para salvá-la, confirme com ele o repositório, a branch e a configuração proposta. Revise o nome e a descrição do ambiente no formulário e depois selecione **Save environment**.

![O Replit mostrando o preview do Cloud Agent Demo ao lado de um formulário Save environment com nome, descrição e o botão Save environment.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/cloud-agent-demo-save-environment.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=c58d0efa53f1824164e84ff86ec09665)

O Replit faz o build da configuração salva e verifica o app em um sandbox novo. Salvar a configuração não significa, por si só, que o build foi bem-sucedido. Depois de um build bem-sucedido, chats futuros podem reutilizar a configuração preparada.

> [!NOTE]
>
> Os builds em segundo plano precisam de [acesso do workspace ao repositório](https://docs.replit.com/pt/build/code/manage-repository-access.md), separado da sua conexão Git pessoal. Pode ser necessário que um administrador o configure. Você pode continuar usando seu preview atual sem salvar um ambiente reutilizável.

Salvar não publica seu app nem compartilha automaticamente a configuração com sua equipe. Rebuilds posteriores não atualizam o sandbox que você já está usando. Consulte [Arquivos e ambiente](https://docs.replit.com/pt/build/code/navigate-your-workspace.md#arquivos-e-ambiente) para entender como isso funciona.

Se o formulário não aparecer, você pode pedir ao Replit que salve a configuração que funciona. A orientação detalhada de configuração está em [Crie um ambiente reutilizável](https://docs.replit.com/pt/build/code/create-reusable-environment.md).

**3. Abra o preview em uma nova aba**

Selecione **Open in a new tab** no canto superior direito da barra de ferramentas do preview. Passe o mouse sobre o botão para ver a dica dele.

![Barra de ferramentas do preview com o botão Open in a new tab e sua dica destacados.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/open-preview-tab.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=6a25f71d56825d3bba81068ee7786ba3)

O aplicativo abre em uma aba separada do navegador, dando mais espaço para você experimentá-lo. Você ainda está vendo um preview de desenvolvimento, não um deployment de produção.

![Landing page do Cloud Agent Demo exibida sem o chat e a barra lateral do Replit ao redor.](https://mintcdn.com/replit/ZvLiuMLrojYoqf3I/images/code-contributions/cloud-agent-demo-browser-preview.jpg?fit=max\&auto=format\&n=ZvLiuMLrojYoqf3I\&q=85\&s=42295144489b57ee47f267524de5068e)

Para a demo da landing page:

* **Experimente a navegação:** Selecione os links para ir às seções da página.
* **Explore o conteúdo:** Encontre as seções de fluxo de trabalho, benefícios e como funciona.
* **Confira o layout:** Redimensione o preview para ver como a página se adapta a uma tela menor.

Se o preview não carregar, peça ao Replit que verifique o servidor e o endpoint do preview. Se ele parar de responder, peça ao Replit que reinicie o app e verifique o link novamente.

A seguir: [Faça uma contribuição](https://docs.replit.com/pt/build/code/first-contribution.md) para melhorar seu app.
