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

# Criar localmente no Manus Studio

> Crie sites, aplicativos web, aplicativos móveis e jogos em uma pasta no seu próprio computador com o Manus Studio. Escolha serviços gerenciados pelo Manus ou um projeto local simples.

## O que é

O recurso **Criar localmente** (**Build locally**) permite que o Manus crie um site, aplicativo web, aplicativo móvel ou jogo em uma pasta no seu próprio computador. Você trabalha no **Manus Studio**, o aplicativo para desktop do Manus para macOS (Apple Silicon) e Windows. O Manus escreve o código, executa o projeto e mostra uma pré-visualização ao vivo. Ele usa os arquivos, as pastas e as ferramentas que já estão no seu computador. Para saber o que o Manus Studio pode fazer no seu computador, leia [Manus Studio](https://manus.im/docs/pt-br/features/desktop.md).

Use este recurso nestes casos:

* Seu projeto já está no seu computador.
* Você quer manter seu próprio fluxo de trabalho com Git.
* Você quer usar suas próprias ferramentas junto com o Manus.

Você também pode usar o mesmo fluxo de trabalho em um [Cloud Computer](https://help.manus.im/en/articles/15392111-what-is-the-cloud-computer). Nesse caso, a pasta do projeto fica no Cloud Computer, e não na sua própria máquina.

Para cada site ou aplicativo móvel, você escolhe um de dois tipos de projeto:

| Termo | O que significa |
| :- | :- |
| **Projeto gerenciado pelo Manus** | O projeto se conecta aos serviços do Manus, como hospedagem, banco de dados, login de usuários, recursos de IA, histórico de versões e publicação. Você também pode continuar o projeto no Manus pela web. |
| **Projeto local simples** | Um projeto comum no seu computador. Você usa suas próprias ferramentas e serviços. O Manus não configura hospedagem, publicação nem outros serviços do Manus. |
| **Histórico de versões do Manus** | A lista de versões salvas que o Manus mantém para um projeto gerenciado pelo Manus. Ela é separada do seu próprio repositório Git. |

A tabela mostra quais opções se aplicam a cada tipo de projeto.

| Tipo de projeto | Suas opções | Onde o desenvolvimento é executado |
| :- | :- | :- |
| **Site ou aplicativo web** | Gerenciado pelo Manus ou local simples | Seu computador |
| **Aplicativo móvel** | Gerenciado pelo Manus ou local simples | Gerenciado pelo Manus: Manus Cloud. Local simples: seu computador. |
| **Jogo** | Sempre gerenciado pelo Manus | Seu computador |

***

## Como usar

### Configurar o Manus Studio

**1. Baixe o Manus Studio**

Abra [manus.im/desktop](https://manus.im/desktop). Selecione **macOS (Apple Silicon)** ou **Windows** e depois execute o instalador.

**2. Faça login**

Abra o Manus Studio e faça login com sua conta do Manus. Se o Manus pedir que você atualize antes de usar uma pasta local, instale a versão mais recente.

**3. Ative o Trabalhar localmente e escolha a pasta**

Na caixa de chat, ative **Trabalhar localmente** (**Work locally**). Clique em **Escolher uma pasta** (**Choose a folder**) e selecione a pasta onde está seu projeto ou onde o Manus deve criá-lo. Leia [Manus Studio](https://manus.im/docs/pt-br/features/desktop.md) para saber sobre modos de permissão e acesso a pastas.

### Começar um novo site no seu computador

**1. Descreva o site e onde ele deve ficar**

Inicie uma tarefa no Manus Studio. Descreva o site e diga ao Manus onde criá-lo no seu computador.

**2. Escolha um tipo de projeto**

O Manus pergunta como você quer configurar o site. Selecione **gerenciado pelo Manus** (**Manus-managed**) para usar hospedagem, banco de dados, login, histórico de versões e publicação do Manus. Selecione **local simples** (**plain local**) para usar apenas suas próprias ferramentas e serviços.

**3. Permita o armazenamento de código se a pasta não estiver vazia**

Em um projeto gerenciado pelo Manus, o Manus verifica a pasta. Se ela já contiver arquivos, o Manus mostra um cartão **Armazenamento do código do projeto** (**Project code storage**). O cartão pergunta: "Allow Manus to sync your project's code?" (Permitir que o Manus sincronize o código do seu projeto?). Clique em **Permitir e inicializar** (**Allow and initialize**) para continuar. Se você cancelar, o Manus não configura o projeto.

**4. Revise o plano**

O Manus apresenta um plano para o site. Peça alterações antes que o Manus comece a criar.

**5. Visualize e ajuste**

O Manus executa o site no seu computador e abre uma pré-visualização ao vivo no Manus Studio. Descreva as alterações que você quer na mesma tarefa.

Exemplo de prompt:

```text theme={null}
Build a booking website for my yoga studio in a new folder called yoga-site
in my Documents folder. Include a class schedule, a booking form, and a contact page.
```

> [!NOTE]
>
> Se você já escolheu um tipo de projeto no seu prompt, por exemplo "mantenha local, sem hospedagem do Manus", o Manus não pergunta de novo.

### Continuar um site que já está no seu computador

**1. Indique a pasta ao Manus**

No Manus Studio, diga ao Manus qual projeto continuar. Informe o caminho completo da pasta, se puder.

**2. Confirme a cópia certa**

O Manus procura sites do Manus nessa pasta e em pastas próximas. Se o Manus encontrar mais de uma correspondência, ou se a correspondência não estiver clara, ele pergunta qual você quer.

**3. Escolha como conectar o código existente**

A pasta pode conter código que ainda não está vinculado ao Manus. Nesse caso, o Manus pede que você escolha entre gerenciado pelo Manus ou local simples. O Manus mantém seus arquivos existentes e não aplica um modelo inicial sobre eles.

### Adicionar um site a um projeto maior

Você pode adicionar um site a um projeto que não é um site, por exemplo, um site oficial para um jogo.

1. Diga ao Manus que você quer um site separado dentro do projeto maior. Por exemplo: "Adicione um site oficial para este jogo."
2. O Manus cria o site em uma subpasta própria, por exemplo `website/`.
3. Apenas essa subpasta pertence ao site. O Manus não inclui o restante do projeto nas versões do site.

### Criar um aplicativo móvel

**1. Descreva o aplicativo**

No Manus Studio, descreva o aplicativo móvel que você quer criar.

**2. Escolha um tipo de projeto**

O Manus pede que você escolha antes de começar. **Gerenciado pelo Manus** oferece backend, banco de dados, login, recursos de IA, histórico de versões e builds do aplicativo. **Local simples** mantém o desenvolvimento no seu computador, com seu próprio backend e seus próprios serviços.

**3. Confirme a transferência para o Manus Cloud**

Atualmente, um aplicativo móvel gerenciado pelo Manus é executado no Manus Cloud. Se você escolher essa opção, o Manus transfere a tarefa do seu computador para o Manus Cloud antes do início do desenvolvimento. O Manus avisa sobre essa transferência antes que você escolha.

> [!WARNING]
>
> Os arquivos da sua pasta local podem não ser transferidos com a tarefa para o Manus Cloud. Se você já tem código, avise o Manus antes de escolher, para que ele possa planejar como levar o código.

### Criar um jogo

1. No Manus Studio, descreva o jogo e diga ao Manus onde criá-lo no seu computador.
2. O Manus configura o jogo como um projeto gerenciado pelo Manus. Ele não pede que você escolha um tipo de projeto.
3. Continue com o fluxo de trabalho normal do Game Dev. Leia [Game Developer](https://manus.im/docs/pt-br/features/game-developer.md).

### Salvar versões e publicar um projeto gerenciado pelo Manus

**1. Peça ao Manus para salvar uma versão**

Quando estiver satisfeito com uma alteração, peça ao Manus para salvar uma versão. O Manus envia uma cópia do código da pasta do site para um repositório privado gerenciado pelo Manus. O Manus usa essa cópia apenas para o histórico de versões e a publicação.

**2. Publique quando estiver pronto**

Peça ao Manus para publicar ou publique como descrito em [Publicação](https://manus.im/docs/pt-br/website-builder/publishing.md). O Manus pergunta "Allow Manus to publish?" (Permitir que o Manus publique?). Escolha **Permitir uma vez** (**Allow once**) ou **Sempre permitir para este site** (**Always allow for this website**) para pular essa pergunta da próxima vez. Somente o proprietário do projeto pode publicar um projeto local. Salvar uma versão não publica seu site por si só, a menos que você tenha ativado a publicação automática.

> [!NOTE]
>
> Um commit no seu próprio repositório Git não cria uma versão no Manus e não publica seu site.

### Testar pagamentos do Stripe em um projeto local

1. Peça ao Manus para adicionar pagamentos. O Manus configura o Stripe no modo de teste. Leia [Pagamentos](https://manus.im/docs/pt-br/website-builder/payments.md).
2. Teste o checkout com o cartão de teste do Stripe `4242 4242 4242 4242`.
3. Para testar os pagamentos por completo, o Stripe precisa enviar eventos de pagamento (webhooks) para o seu aplicativo. Uma pré-visualização no seu próprio computador não consegue receber esses eventos. Peça ao Manus para transferir o projeto para um sandbox temporário na nuvem para esse teste. O Manus pede sua aprovação antes.
4. Antes de publicar pela primeira vez, peça ao Manus para conectar o webhook do Stripe a partir de uma pré-visualização na nuvem.

### Conectar um projeto local simples ao Manus depois

1. Abra a pasta do projeto no Manus Studio.
2. Peça ao Manus para conectar o site ao Manus.
3. O Manus vincula a pasta existente a um novo projeto gerenciado pelo Manus. Ele mantém seus arquivos de código-fonte e não recria o site.

Isso se aplica a sites e aplicativos web. Para transformar um aplicativo móvel local simples em um projeto gerenciado pelo Manus, o Manus transfere a tarefa para o Manus Cloud e avalia como levar seu código.

***

## O que você precisa saber

### O que é executado onde

* **A pré-visualização é executada no seu computador.** O Manus Studio abre a pré-visualização a partir de um endereço local na sua máquina. Outros dispositivos não conseguem abrir esse endereço.
* **Compartilhe com outras pessoas publicando.** Para que outras pessoas vejam o site, publique-o ou continue a tarefa no Manus Cloud.
* **Sincronize antes de continuar na nuvem.** Uma nova tarefa na nuvem começa a partir da versão sincronizada mais recente. Alterações que existem apenas no seu computador não são incluídas. Peça ao Manus para sincronizar primeiro e depois selecione **Continuar em uma nova tarefa na nuvem** (**Continue in a new cloud task**).
* **Somente o proprietário pode usar arquivos locais.** Arquivos locais, publicação local e a continuação em uma nova tarefa estão disponíveis apenas para o proprietário do projeto.
* **Aplicativos móveis gerenciados são executados no Manus Cloud.** Sites, aplicativos web e jogos permanecem no seu computador. Aplicativos móveis gerenciados pelo Manus são transferidos para o Manus Cloud.

### O que o Manus envia

* **Projetos gerenciados pelo Manus:** Quando você salva ou sincroniza uma versão, o Manus envia o código da pasta do site. Ele não envia o restante de um projeto maior, como o jogo ao redor de um site complementar.
* **A configuração por si só não envia código.** Conectar uma pasta ou configurar um projeto gerenciado pelo Manus não envia seu código por si só.
* **Escolher gerenciado pelo Manus não publica nada.** Seu site só fica público quando você o publica.
* **Projetos locais simples:** O Manus não configura serviços do Manus e não salva versões no Manus. Você pode conectar o projeto ao Manus depois.

### Como o Manus trabalha com seu repositório Git

* **Dois históricos separados.** O Manus mantém seu próprio histórico de versões para um projeto gerenciado pelo Manus. Seu repositório Git e o histórico dele permanecem separados.
* **Sua configuração do Git continua a mesma.** O Manus não altera seus remotes, branches, hooks ou credenciais. Ele não importa seu histórico do Git.
* **Commits não são copiados de um lado para o outro.** Seus commits não aparecem no histórico de versões do Manus, e as versões do Manus não aparecem como commits no seu repositório.
* **Arquivos compartilhados.** Os dois históricos rastreiam os mesmos arquivos da pasta. Quando o Manus traz alterações do próprio histórico, essas alterações aparecem no seu repositório Git como alterações não commitadas.
* **Pastas sem um repositório Git próprio.** Se a pasta do site não estiver dentro de um repositório Git, suas ferramentas do Git mostram o histórico de versões do Manus para essa pasta. Para usar um repositório separado ali, peça ao Manus para configurá-lo. Não execute `git init` nessa pasta por conta própria.
* **O Manus adiciona dois itens à pasta do site.** Um pequeno arquivo de projeto vincula a pasta ao seu projeto do Manus. Uma pasta oculta armazena o histórico de versões do Manus. Não exclua nenhum dos dois. Não faça commit da pasta oculta no seu próprio repositório.
* **Worktrees e branches do Git.** Você pode fazer commit do pequeno arquivo de projeto no seu repositório. Assim, um novo branch ou worktree continua vinculado ao mesmo projeto do Manus.
* **Projetos na nuvem e GitHub.** Para projetos que você cria no Manus Cloud, leia [Integração GitHub](https://manus.im/docs/pt-br/website-builder/github-integration.md) e [Controle de Código](https://manus.im/docs/pt-br/website-builder/code-control.md).

### Limitações atuais

* **A reversão ainda não está disponível para projetos locais.** Você não pode reverter um projeto local gerenciado pelo Manus para uma versão salva anteriormente. Para desfazer alterações, use seu próprio histórico do Git.
* **O teste completo de webhooks do Stripe precisa de um sandbox na nuvem.** O checkout no modo de teste funciona localmente. Os eventos de pagamento precisam de um sandbox temporário na nuvem.
* **Jogos são sempre gerenciados pelo Manus.** A opção local simples não está disponível para jogos.
* **Aplicativos móveis gerenciados precisam do Manus Cloud.** Você não pode desenvolver um aplicativo móvel gerenciado pelo Manus no seu próprio computador.

### Ferramentas no seu computador

* **O Manus usa as ferramentas que você tem.** O Manus usa as linguagens de programação, os gerenciadores de pacotes e as outras ferramentas instaladas no seu computador.
* **Os pacotes do projeto são instalados como parte da tarefa.** O Manus instala os pacotes de que seu projeto precisa, usando as configurações do próprio projeto.
* **Alterações no sistema precisam da sua permissão.** Antes de instalar ou reparar uma ferramenta para todo o seu computador, o Manus explica a alteração e pede sua permissão. Ele não usa privilégios de administrador sem a sua aprovação.

### Mover ou copiar uma pasta de projeto

* **Mova a pasta inteira.** Se você mover ou renomear a pasta inteira do site, o vínculo com seu projeto do Manus e o histórico de versões permanecem intactos.
* **Copiar apenas o arquivo de projeto não cria um novo site.** A cópia aponta para o mesmo projeto do Manus. Em vez disso, peça ao Manus para configurar um novo projeto.

### Créditos

Tarefas que trabalham com seu computador consomem créditos na mesma proporção que tarefas equivalentes na nuvem. O custo é definido pela complexidade da tarefa, e não pelo local dos arquivos. Leia [Understanding Credit Consumption in the Manus Desktop App](https://help.manus.im/en/articles/14134826-understanding-credit-consumption-in-the-manus-desktop-app).

***

## Dicas

* **Informe ao Manus o caminho completo da pasta.** Um caminho completo, como `~/Documents/yoga-site`, ajuda o Manus a encontrar o projeto certo logo na primeira vez.
* **Use uma pasta nova e vazia para um novo site.** Assim, o Manus configura o projeto sem pedir que você confirme o armazenamento de código.
* **Informe o tipo de projeto no primeiro prompt.** Diga "gerenciado pelo Manus" ou "mantenha local" para pular a pergunta de configuração.
* **Escolha gerenciado pelo Manus se você pretende publicar com o Manus.** Você tem hospedagem, histórico de versões e publicação sem configuração extra.
* **Mantenha um site complementar em uma subpasta própria.** Assim, o histórico de versões e os envios incluem apenas o site, e não o projeto inteiro.
* **Faça commit do seu trabalho no Git antes de grandes alterações.** A reversão ainda não está disponível para projetos locais gerenciados pelo Manus, então seu próprio histórico do Git é sua rede de segurança.
* **Faça commit do pequeno arquivo de projeto, não da pasta oculta.** Assim, seus branches e worktrees continuam vinculados ao mesmo projeto do Manus.
* **Planeje os testes de pagamento com antecedência.** Peça ao Manus para configurar um sandbox temporário na nuvem quando estiver pronto para testar o fluxo de pagamento completo.
* **Publique para compartilhar.** Uma pré-visualização local funciona apenas no seu computador. Publique o site para enviar um link a outras pessoas.

***

## Perguntas frequentes

> [accordion] Preciso do Manus Studio para criar localmente?
>
> Sim. Para criar no seu próprio computador, você precisa do Manus Studio para macOS (Apple Silicon) ou Windows. Baixe-o em [manus.im/desktop](https://manus.im/desktop). Você também pode usar o mesmo fluxo de trabalho em um Cloud Computer.

> [accordion] Qual é a diferença entre um projeto gerenciado pelo Manus e um projeto local simples?
>
> Um projeto gerenciado pelo Manus se conecta a serviços do Manus, como hospedagem, banco de dados, login, histórico de versões e publicação. Um projeto local simples é um projeto comum no seu computador. Você usa suas próprias ferramentas e serviços, e o Manus não configura hospedagem nem publicação.

> [accordion] O Manus envia meu código?
>
> Em um projeto gerenciado pelo Manus, o Manus envia o código da pasta do site quando você salva ou sincroniza uma versão. Configurar o projeto não envia código por si só. Em um projeto local simples, o Manus não salva versões no Manus.

> [accordion] O Manus vai alterar meu repositório Git?
>
> Não. O Manus mantém seu próprio histórico de versões, separado do seu repositório. Ele não altera seus remotes, branches, hooks ou credenciais. Quando o Manus altera arquivos, essas alterações aparecem no seu repositório como alterações não commitadas.

> [accordion] Por que a tarefa do meu aplicativo móvel foi transferida para a nuvem?
>
> Atualmente, um aplicativo móvel gerenciado pelo Manus é executado no Manus Cloud. O Manus avisa sobre isso antes que você escolha. Para manter o aplicativo no seu computador, escolha o desenvolvimento local simples.

> [accordion] Por que o Manus não pede que eu escolha um tipo de projeto para meu jogo?
>
> Jogos criados localmente são sempre gerenciados pelo Manus. O Manus configura o jogo com os serviços do Manus e segue para a próxima etapa.

> [accordion] Posso reverter um projeto local para uma versão anterior?
>
> Ainda não. A reversão não está disponível para projetos locais gerenciados pelo Manus nesta versão. Faça commit no seu próprio repositório Git antes de grandes alterações para poder restaurar os arquivos por conta própria.

> [accordion] Posso testar pagamentos do Stripe no meu computador?
>
> Você pode testar o checkout no modo de teste do Stripe. O teste completo de eventos de pagamento (webhooks) precisa de um sandbox temporário na nuvem. Peça ao Manus para configurá-lo. O Manus pede sua aprovação antes de transferir o projeto.

> [accordion] Outra pessoa pode abrir minha pré-visualização local?
>
> Não. A pré-visualização é executada em um endereço local no seu computador. Para compartilhar o site, publique-o ou continue a tarefa no Manus Cloud.

> [accordion] Posso conectar um site local simples ao Manus depois?
>
> Sim. Peça ao Manus para conectar o site. O Manus vincula a pasta existente a um projeto gerenciado pelo Manus e mantém seus arquivos de código-fonte.

> [accordion] O Manus pediu para instalar uma ferramenta no meu computador. Por quê?
>
> Seu projeto precisa de uma ferramenta que está ausente, desatualizada ou não está funcionando no seu computador. O Manus explica a alteração e pede sua permissão antes de instalar ou reparar uma ferramenta para todo o seu computador.

> [accordion] Criar localmente consome mais créditos?
>
> Não. Tarefas que trabalham com seu computador consomem créditos na mesma proporção que tarefas equivalentes na nuvem. Leia [Planos e Preços](https://manus.im/docs/pt-br/introduction/plans.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.