> ## 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.

# Configuração do desenvolvimento local

> Configure o dev server da Base44 e conecte seu frontend a ele

O desenvolvimento local executa dois processos lado a lado. O dev server da Base44 cuida do seu backend, e seu dev server frontend habitual executa a UI. Seu frontend se comunica com o backend local através do SDK.

## Pré-requisitos

Se seu projeto tem funções de backend, você precisa instalar o [Deno](https://docs.deno.com/runtime/getting_started/installation/) para executá-las localmente.

## Configure seu cliente frontend

Se seu projeto tem um frontend que usa o SDK, você precisa informar para onde enviar as requisições. Por padrão, o SDK envia requisições para o backend hospedado da Base44. Para usar o dev server local, passe `serverUrl` para a configuração do cliente ao rodar em modo de desenvolvimento. Em produção, omita `serverUrl` para que o SDK use seu padrão.

A abordagem é detectar se seu código está rodando em um ambiente de desenvolvimento, então definir condicionalmente `serverUrl` para apontar para o dev server local. A maioria dos frameworks oferece uma forma nativa de verificar isso.

<Steps>
  <Step title="Detecte o modo de desenvolvimento">
    Use o padrão que corresponde ao seu ambiente:

    <CodeGroup>
      ```javascript Vite theme={null}
      const isDev = import.meta.env.DEV;
      ```

      ```javascript Node.js, Webpack, Next.js theme={null}
      const isDev = process.env.NODE_ENV !== "production";
      ```

      ```javascript React Native theme={null}
      const isDev = __DEV__;
      ```

      ```javascript Deno theme={null}
      const isDev = Deno.env.get("DENO_ENV") !== "production";
      ```
    </CodeGroup>
  </Step>

  <Step title="Passe serverUrl condicionalmente">
    Ao criar o cliente, inclua `serverUrl` apenas em desenvolvimento:

    ```javascript theme={null}
    import { createClient } from "@base44/sdk";

    const base44 = createClient({
      appId: "your-app-id",
      ...(isDev && { serverUrl: "http://localhost:4400" }),
    });
    ```

    * Em desenvolvimento, `isDev` é `true` e o SDK envia requisições para `localhost:4400`
    * Em builds de produção, `isDev` é `false`, `serverUrl` é omitido e o SDK usa o backend padrão da Base44
  </Step>
</Steps>

## Execute os dev servers

Cada vez que você desenvolve localmente, precisa de dois terminais rodando lado a lado.

<Steps>
  <Step title="Inicie o backend">
    Em um terminal, execute [`dev`](/developers/references/cli/commands/dev) a partir do diretório do seu projeto:

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

    Isso inicia o backend local em `http://localhost:4400`.
  </Step>

  <Step title="Inicie o frontend">
    Em um segundo terminal, inicie seu dev server frontend como você normalmente faria. Por exemplo, com Vite:

    ```bash theme={null}
    npm run dev
    ```

    Todas as chamadas do SDK do seu frontend agora vão para o dev server local da Base44.
  </Step>
</Steps>

## Veja também

* [Visão geral do desenvolvimento local](/developers/backend/overview/local-dev/local-development-overview): O que roda localmente, o que é encaminhado e como funciona
* [`dev`](/developers/references/cli/commands/dev): Referência do comando da CLI com flags
* [`serverUrl`](/developers/references/sdk/docs/functions/createClient): Configuração do cliente do SDK

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