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

# base44 dev

> Inicia o desenvolvimento local para um projeto Base44 vinculado.

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# base44 dev

Inicia o desenvolvimento local para um projeto Base44 vinculado.

Este comando sempre inicia o backend da Base44 localmente. Se `base44/config.jsonc` define `site.serveCommand`, ele também executa seu servidor de desenvolvimento de frontend a partir da raiz do projeto e o conecta ao backend local automaticamente.

## Sintaxe

```bash theme={null}
npx base44 dev [options]
```

## Opções

| Opção                 | Descrição                            | Obrigatório | Padrão |
| --------------------- | ------------------------------------ | ----------- | ------ |
| `-p, --port <number>` | Porta para o backend local da Base44 | Não         | 4400   |

## Autenticação

**Obrigatório**: Sim. Se não estiver autenticado, você será solicitado a fazer login primeiro.

## Requisitos

* Deve ser executado a partir de um **projeto local vinculado da Base44**
* `base44/.app.jsonc` deve existir
* `base44 dev` não pode ser usado com `--app-id` ou `BASE44_APP_ID`

## O que faz

1. Lê a configuração do seu projeto local vinculado
2. Inicia o backend local da Base44 para entidades, funções e rotas de autenticação
3. Observa recursos locais da Base44 e os recarrega quando mudam
4. Se `site.serveCommand` está configurado, inicia seu servidor de desenvolvimento de frontend a partir da raiz do projeto
5. Injeta `VITE_BASE44_APP_ID` e `VITE_BASE44_APP_BASE_URL` no processo de frontend
6. Desliga tudo limpamente quando você para o comando

## Comportamento de frontend + backend

`base44 dev` funciona para **backend e frontend**:

* **Backend**: sempre executado localmente
* **Frontend**: executado apenas quando `base44/config.jsonc` inclui `site.serveCommand`

Antes de usar `base44 dev` para desenvolvimento local full-stack, verifique sua configuração:

```jsonc theme={null}
{
  "site": {
    "serveCommand": "npm run dev"
  }
}
```

Se `site.serveCommand` estiver faltando, `base44 dev` ainda funciona, mas só inicia o backend da Base44.

## Exemplos

```bash theme={null}
# Inicia o desenvolvimento local na porta padrão
npx base44 dev

# Inicia o backend em uma porta específica
npx base44 dev --port 4500
```

## Notas

* Use isto a partir de um projeto local vinculado, não com `--app-id`
* Quando o frontend está em execução, a CLI transmite as saídas do backend e do frontend juntas
* Se o processo de frontend sair, o ambiente de desenvolvimento local também será desligado

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