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

# Vincular um projeto de backend existente

> Configure e execute código de projeto de backend Base44 existente, como apps de exemplo

Você pode vincular código de projeto de backend Base44 existente, como de um [app de exemplo](https://github.com/base44/apps-examples), a um backend na Base44. Use isto quando já tem arquivos de projeto de backend Base44 localmente.

Se você ainda não tem arquivos de projeto, use [`base44 create`](/developers/references/cli/commands/create) para gerar um novo projeto.

<Note>
  * Este guia é para vincular código de projeto de backend Base44 existente, como apps de exemplo ou projetos compartilhados por membros da equipe. Se você criou um app com o [editor de apps Base44](https://base44.com) e quer desenvolvê-lo localmente, use [`base44 eject`](/developers/backend/overview/start-from-existing-app).
  * A CLI requer Node.js 20.19.0 ou superior.
</Note>

## Entendendo o código local vs. projetos de backend

Ao trabalhar com a Base44, há dois componentes separados:

* **Código local:** Os arquivos do projeto no seu computador, como seu código frontend, schemas de entidade e funções de backend.
* **Projeto de backend Base44:** A infraestrutura de backend nos servidores da Base44, incluindo o banco de dados, endpoints, hospedagem etc.

A vinculação conecta seu código local a um projeto de backend para que seu app possa usar a infraestrutura da Base44. Durante o processo de vinculação, você escolherá uma de duas opções:

* **Criar um novo projeto:** Cria um backend novo na Base44 para o seu código. Escolha isto se estiver configurando este código pela primeira vez.
* **Vincular a um existente:** Conecta a um backend que já existe na Base44. Escolha isto se estiver reconectando a um backend que configurou anteriormente, ou se estiver entrando em um projeto de equipe onde o backend já foi criado.

## Vincular um projeto

<Steps>
  <Step title="Obtenha o código do projeto">
    Clone um app de exemplo ou baixe o código do projeto existente, depois navegue até o diretório do projeto.

    O projeto já deve conter uma pasta `base44/` com um arquivo `config.jsonc`.
  </Step>

  <Step title="Instale as dependências">
    Instale as dependências do projeto:

    ```bash theme={null}
    npm install
    ```
  </Step>

  <Step title="Instale a CLI da Base44">
    Instale a CLI da Base44 globalmente:

    ```bash theme={null}
    npm install -g base44@latest
    ```
  </Step>

  <Step title="Autentique">
    Faça login na sua conta Base44:

    ```bash theme={null}
    base44 login
    ```

    A CLI gera um código de dispositivo. Abra a URL fornecida, insira o código e complete a autenticação no seu navegador.
  </Step>

  <Step title="Vincule o projeto">
    Vincule seu projeto local a um backend Base44:

    ```bash theme={null}
    base44 link
    ```

    A CLI vai solicitar que você crie um novo projeto de backend ou vincule a um existente. Isso cria um arquivo `.app.jsonc` no seu diretório `base44/` com seu ID de app:

    ```jsonc theme={null}
    {
      "id": "your-app-id"
    }
    ```

    <Warning>
      O arquivo `.app.jsonc` nunca deve ser commitado no controle de versão. Ele é automaticamente adicionado ao `.gitignore` e é específico de cada desenvolvedor e ambiente de deploy.
    </Warning>
  </Step>

  <Step title="Configure variáveis de ambiente (se necessário)">
    Seu ID de app é necessário ao configurar um cliente SDK. Os projetos normalmente armazenam seu ID de app em uma variável de ambiente e o recuperam para criar um cliente. Verifique a documentação ou os arquivos de configuração do projeto para instruções sobre como configurar as variáveis de ambiente necessárias.
  </Step>

  <Step title="Faça o build do frontend se o projeto tiver um">
    Se seu projeto inclui um frontend, faça o build dele para que esteja pronto para deploy no próximo passo.
  </Step>

  <Step title="Envie os recursos">
    Sincronize os recursos do seu projeto com seu backend Base44:

    ```bash theme={null}
    base44 deploy
    ```

    Isso envia entidades, funções e o site se seu projeto tiver um.

    Se seu projeto tem agentes, envie-os também:

    ```bash theme={null}
    base44 agents push
    ```
  </Step>
</Steps>

## Próximos passos

Agora que seu projeto está configurado e rodando, você pode:

* Usar o [SDK](/developers/references/sdk/getting-started/overview) para adicionar mais funcionalidade ao seu frontend, se o projeto tiver um.
* Adicionar [entidades](/developers/backend/resources/entities/overview), [funções de backend](/developers/backend/resources/backend-functions/overview) e [agentes](/developers/backend/resources/agents-config).
* Continuar construindo e implantar atualizações com [`base44 deploy`](/developers/references/cli/commands/deploy).

## Veja também

* [Referência de comandos da CLI](/developers/references/cli/commands/introduction): Todos os comandos da CLI disponíveis
* [Estrutura do projeto](/developers/backend/overview/project-structure): Como os arquivos do projeto são organizados
* [Documentação do SDK JavaScript](/developers/references/sdk/getting-started/overview): Conecte seu app ao backend
* [Base44 Skills](/developers/backend/overview/base44-skills): Ensine assistentes de IA a trabalhar com a Base44
* [Repositório de apps de exemplo](https://github.com/base44/apps-examples): Projetos de exemplo para aprender

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>