Pular para o conteúdo principal
O comando create da CLI da Base44 cria novos projetos com todos os arquivos e configurações necessários. Este artigo descreve a estrutura do projeto de backend da Base44 e explica o que cada arquivo e diretório faz.

​
Estrutura do projeto de backend

Quando você cria um projeto Base44 somente backend, a CLI gera esta estrutura mínima:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
À medida que você desenvolve seu projeto, adiciona arquivos para seus recursos, como entidades, funções, agentes, conectores e auth config:
<your-project-name>
base44
.app.jsonc
config.jsonc
.types
types.d.ts
agents
<agent-name>.jsonc
auth
config.jsonc
connectors
<connector-type>.jsonc
entities
<entity-name>.jsonc
functions
<function-name>
entry.ts
function.jsonc
.gitignore
As funções exigem apenas um arquivo entry.ts ou entry.js. Você pode opcionalmente adicionar function.jsonc para configurações avançadas como nomes customizados ou automations. Veja Backend Functions para detalhes.

​
base44/

Contém toda a configuração de backend Base44 e definições de recursos.

​
config.jsonc

Define a configuração do seu projeto, incluindo caminhos para entidades, funções, agentes, conectores, auth config e configurações de hospedagem para projetos full-stack. A CLI cria isto com apenas o nome do seu projeto, e você pode adicionar mais configurações conforme necessário. Seu projeto requer um arquivo config.jsonc (ou config.json) no diretório base44/: 
// Base44 Project Configuration
{
  "name": "my-project",
  "description": "My Base44 app",

  // Directory paths (relative to config file)
  "entitiesDir": "./entities",
  "functionsDir": "./functions",
  "agentsDir": "./agents",
  "connectorsDir": "./connectors",
  "authDir": "./auth",

  // Site/hosting configuration (for full-stack projects)
  "site": {
    "outputDirectory": "./dist", // Required - where your built files are located
  },
}
PropriedadeDescriçãoPadrão
nameNome do projeto (obrigatório)—
descriptionDescrição do projeto—
entitiesDirCaminho para o diretório de entidades./entities
functionsDirCaminho para o diretório de funções./functions
agentsDirCaminho para o diretório de agentes./agents
connectorsDirCaminho para o diretório de conectores./connectors
authDirCaminho para o diretório de auth config./auth
site.outputDirectoryOnde os arquivos compilados do seu site estão localizados (obrigatório para deploy do site)—
site.buildCommandUsado apenas durante base44 create para deploy automatizado—
site.installCommandUsado apenas durante base44 create para deploy automatizado—
site.serveCommandApenas referência. Não usado atualmente pela CLI—
As propriedades buildCommand, installCommand e serveCommand são incluídas automaticamente quando você cria um projeto a partir do template full-stack. Elas são usadas apenas durante o fluxo inicial de base44 create para deploy automatizado. Você não precisa especificar ou modificar essas propriedades após a criação do projeto. Ao implantar seu site depois com site deploy, apenas outputDirectory é usado.

​
.app.jsonc

Vincula seu projeto local ao seu app Base44. Este arquivo é criado automaticamente pela CLI quando você cria ou vincula um projeto. 
// Base44 App Configuration
// This file links your local project to your Base44 app.
// Do not commit this file to version control.
{
  "id": "your-app-id",
}
O arquivo .app.jsonc não deve ser commitado no controle de versão. A CLI cria automaticamente um arquivo .gitignore que exclui este arquivo.

​
.types/types.d.ts

Definições de tipo TypeScript geradas para suas entidades, funções, agentes e conectores. Criado executando base44 types generate. Este arquivo fornece autocomplete e segurança de tipo ao usar o SDK em projetos TypeScript. Veja Dynamic Types para mais detalhes.

​
agents/

Diretório que contém configurações de agentes de IA. Cada agente é definido em um arquivo .json ou .jsonc separado.

​
auth/

Diretório que contém a configuração de autenticação do seu app. Contém um único arquivo config.jsonc que define quais métodos de login estão disponíveis para seus usuários finais. Faça pull da configuração atual da Base44 com auth pull.

​
connectors/

Diretório que contém configurações de conectores OAuth. Cada conector é definido em um arquivo .json ou .jsonc separado nomeado de acordo com o tipo de integração, como slack.jsonc ou googlecalendar.jsonc.

​
entities/

Diretório que contém definições de schemas de entidade. Cada entidade é definida em um arquivo .json ou .jsonc separado. Crie este diretório quando estiver pronto para definir sua primeira entidade.

​
functions/

Diretório que contém funções de backend serverless. Cada função requer seu próprio subdiretório com um arquivo de código entry.ts ou entry.js. A CLI usa o caminho do diretório relativo à raiz de funções como o nome da função. Por exemplo, functions/sendEmail/entry.ts cria uma função chamada sendEmail. Você pode opcionalmente adicionar um arquivo de configuração function.jsonc para customizar o nome da função ou adicionar automations.
functions
<function-name>
entry.ts
function.jsonc

​
.gitignore

Impede que arquivos sejam commitados no controle de versão. Seu projeto começa com este arquivo para evitar que .app.jsonc seja commitado.

​
Pastas de skills do agente de IA

Quando você cria um projeto com base44 create, skills do agente de IA são instaladas automaticamente. Elas aparecem em pastas específicas do agente, como .claude/skills/, .cursor/skills/ ou similares, dependendo de qual assistente de codificação de IA você usa. Essas pastas ajudam seu agente de codificação a entender como trabalhar com a Base44 e são seguras para commit no controle de versão.

​
Veja também

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