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.

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

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

# 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

# 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

Aplica o modelo selecionado ao caminho de destino
Cria uma pasta base44/ com arquivos de configuração
Registra o projeto com o backend Base44
Cria base44/.app.jsonc com o ID do aplicativo
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

Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.

Getting started

Building your app

Designing your app

Managing app data

Adding logic to your app

Selling on your app

Using on mobile

Domains

Securing your app

Measuring your app

Growing your app's reach

Superagents

Integrations

base44 create

base44 create

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

Sintaxe

Argumentos e opções

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

A flag `--path`

Fluxo: Usando `backend-only` com frameworks externos

Exemplos

O que faz

​base44 create

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

​Sintaxe

​Argumentos e opções

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

​A flag --path

​Fluxo: Usando backend-only com frameworks externos

​Exemplos

​O que faz

base44 create

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

Sintaxe

Argumentos e opções

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

A flag `--path`

Fluxo: Usando `backend-only` com frameworks externos

Exemplos

O que faz