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

> Cria um novo projeto Base44 a partir de um modelo. Este comando é agnóstico a frameworks e pode criar a estrutura completa de um projeto ou adicionar configuração Base44 a um projeto existente.

<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 create

Cria um novo projeto Base44 a partir de um modelo. Este comando é agnóstico a frameworks e pode criar a estrutura completa de um projeto ou adicionar configuração Base44 a um projeto existente.

## Crítico: Modo não interativo obrigatório

SEMPRE forneça o nome do projeto E a flag `--path`. Sem ambos, o comando abre uma TUI interativa que agentes não podem usar corretamente.

ERRADO: `npx base44 create`
ERRADO: `npx base44 create my-app`
CERTO: `npx base44 create my-app -p ./my-app`

## Sintaxe

```bash theme={null}
npx base44 create [name] --path <path> [options]
```

## Argumentos e opções

| Argumento/Opção       | Descrição                                                                                 | Obrigatório |
| --------------------- | ----------------------------------------------------------------------------------------- | ----------- |
| `name`                | Nome do projeto (argumento posicional)                                                    | Sim\*       |
| `-p, --path <path>`   | Caminho onde criar o projeto                                                              | Sim\*       |
| `-t, --template <id>` | ID do modelo (veja modelos abaixo)                                                        | Não         |
| `--deploy`            | Constrói e implanta o site (inclui envio de entidades)                                    | Não         |
| `--no-skills`         | Pula a instalação de habilidades de agente de IA (habilidades são adicionadas por padrão) | Não         |

\*Obrigatório para modo não interativo. Tanto `name` quanto `--path` devem ser fornecidos juntos.

## Seleção do modelo (CRÍTICO - Escolha adequadamente)

**Você DEVE selecionar o modelo mais adequado com base nos requisitos do usuário:**

| ID do modelo         | Quando usar                                                                                             | Cenários de exemplo                                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `backend-and-client` | Criando um NOVO aplicativo web full-stack do zero                                                       | "Create a task app", "Build me a dashboard", "Make a SaaS app"                   |
| `backend-only`       | Adicionando Base44 a um projeto EXISTENTE OU usando um framework diferente (Next.js, Vue, Svelte, etc.) | "Add Base44 to my project", "I want to use Next.js", "I already have a frontend" |

**Escolha padrão:** Quando o usuário pede para "criar um aplicativo" ou "construir um projeto" sem especificar um framework particular, use `backend-and-client` para fornecer um aplicativo completo e pronto para produção com Vite + React + Tailwind.

## A flag `--path`

* **Para o modelo `backend-and-client` (novos projetos):** Use um novo caminho de subpasta
  ```bash theme={null}
  npx base44 create my-app -p ./my-app -t backend-and-client
  ```
* **Para o modelo `backend-only` (projetos existentes):** Use `-p .` no diretório atual
  ```bash theme={null}
  npx base44 create my-app -p .
  ```

## Fluxo: Usando `backend-only` com frameworks externos

**CRÍTICO: A pasta do projeto DEVE existir ANTES de executar `base44 create` com `backend-only`**

O modelo `backend-only` apenas adiciona arquivos de configuração Base44 - NÃO cria um frontend. Se você precisa de um frontend com um framework específico:

```bash theme={null}
# Step 1: Initialize the frontend project FIRST
npm create vite@latest my-app -- --template react  # or vue, svelte, etc.
# OR: npx create-next-app@latest my-app
# OR: any other framework's init command

# Step 2: Navigate into the created folder
cd my-app

# Step 3: Install Base44 CLI
npm install --save-dev base44

# Step 4: Add Base44 configuration
npx base44 create my-app -p .
```

**AVISO:** NÃO:

* Crie uma pasta vazia manualmente e depois tente executar `npx create vite` dentro dela (falhará - a pasta existe)
* Execute `base44 create` com `backend-only` esperando que ele crie um frontend (não fará)

**FAÇA:**

* Execute o comando de inicialização do framework externo PRIMEIRO (ele cria sua própria pasta)
* Depois execute `base44 create` dentro dessa pasta com `-p .`

## Exemplos

```bash theme={null}
# RECOMENDADO: Cria projeto full-stack (para novos aplicativos)
npx base44 create my-app -p ./my-app -t backend-and-client

# Cria full-stack e implanta em uma etapa
npx base44 create my-app -p ./my-app -t backend-and-client --deploy

# Adiciona Base44 a um projeto EXISTENTE (deve estar dentro da pasta do projeto)
npx base44 create my-app -p .

# Adiciona Base44 a um projeto existente e implanta
npx base44 create my-app -p . --deploy

# Cria sem adicionar habilidades de agente de IA
npx base44 create my-app -p . --no-skills
```

## O que faz

1. Aplica o modelo selecionado ao caminho de destino
2. Cria uma pasta `base44/` com arquivos de configuração
3. Registra o projeto com o backend Base44
4. Cria `base44/.app.jsonc` com o ID do aplicativo
5. Se `--deploy` for usado:
   * Envia quaisquer entidades definidas em `base44/entities/`
   * Executa comandos de instalação e build (para modelos com frontend)
   * Implanta o site na hospedagem Base44

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