Saltar al contenido principal
El comando create del CLI de Base44 crea nuevos proyectos con todos los archivos y la configuración necesarios. Este artículo describe la estructura del proyecto de backend de Base44 y explica para qué sirve cada archivo y directorio.

​
Estructura del proyecto de backend

Cuando creas un proyecto de Base44 solo backend, el CLI genera esta estructura mínima:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
A medida que desarrollas tu proyecto, añades archivos para tus recursos, como entidades, funciones, agentes, conectores y configuración de auth:
<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
Las funciones solo requieren un archivo entry.ts o entry.js. Opcionalmente, puedes añadir function.jsonc para configuraciones avanzadas, como nombres personalizados o automatizaciones. Consulta Funciones de backend para más detalles.

​
base44/

Contiene toda la configuración del backend de Base44 y las definiciones de recursos.

​
config.jsonc

Define la configuración de tu proyecto, incluidas las rutas a entidades, funciones, agentes, conectores, configuración de auth y los ajustes de hosting de sitio para proyectos full-stack. El CLI crea esto solo con el nombre de tu proyecto, y puedes añadir más configuración según sea necesario. Tu proyecto requiere un archivo config.jsonc (o config.json) en el directorio 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
  },
}
PropiedadDescripciónPredeterminado
nameNombre del proyecto (obligatorio)—
descriptionDescripción del proyecto—
entitiesDirRuta al directorio de entidades./entities
functionsDirRuta al directorio de funciones./functions
agentsDirRuta al directorio de agentes./agents
connectorsDirRuta al directorio de conectores./connectors
authDirRuta al directorio de configuración de auth./auth
site.outputDirectoryDónde se encuentran los archivos compilados de tu sitio (requerido para el despliegue del sitio)—
site.buildCommandSolo se usa durante base44 create para despliegue automatizado—
site.installCommandSolo se usa durante base44 create para despliegue automatizado—
site.serveCommandSolo de referencia. Actualmente no lo usa el CLI—
Las propiedades buildCommand, installCommand y serveCommand se incluyen automáticamente cuando creas un proyecto a partir de la plantilla full-stack. Solo se usan durante el flujo inicial de base44 create para el despliegue automatizado. No necesitas especificar ni modificar estas propiedades después de la creación del proyecto. Al desplegar tu sitio más adelante con site deploy, solo se usa outputDirectory.

​
.app.jsonc

Vincula tu proyecto local con tu app de Base44. Este archivo se crea automáticamente con el CLI cuando creas o vinculas un proyecto. 
// 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",
}
El archivo .app.jsonc no debe enviarse al control de versiones. El CLI crea automáticamente un archivo .gitignore que excluye este archivo.

​
.types/types.d.ts

Definiciones de tipos de TypeScript generadas para tus entidades, funciones, agentes y conectores. Se crea ejecutando base44 types generate. Este archivo proporciona autocompletado y seguridad de tipos al usar el SDK en proyectos TypeScript. Consulta Tipos dinámicos para más detalles.

​
agents/

Directorio que contiene configuraciones de agentes de IA. Cada agente se define en un archivo .json o .jsonc separado.

​
auth/

Directorio que contiene la configuración de autenticación de tu app. Contiene un único archivo config.jsonc que define qué métodos de inicio de sesión están disponibles para tus usuarios finales. Descarga la configuración actual desde Base44 con auth pull.

​
connectors/

Directorio que contiene configuraciones de conectores OAuth. Cada conector se define en un archivo .json o .jsonc separado, con el nombre del tipo de integración, como slack.jsonc o googlecalendar.jsonc.

​
entities/

Directorio que contiene definiciones de esquema de entidades. Cada entidad se define en un archivo .json o .jsonc separado. Crea este directorio cuando estés listo para definir tu primera entidad.

​
functions/

Directorio que contiene funciones de backend serverless. Cada función requiere su propio subdirectorio con un archivo de código entry.ts o entry.js. El CLI usa la ruta del directorio relativa a la raíz de funciones como nombre de la función. Por ejemplo, functions/sendEmail/entry.ts crea una función llamada sendEmail. Opcionalmente, puedes añadir un archivo de configuración function.jsonc para personalizar el nombre de la función o añadir automatizaciones.
functions
<function-name>
entry.ts
function.jsonc

​
.gitignore

Evita que los archivos se envíen al control de versiones. Tu proyecto empieza con este archivo para evitar que .app.jsonc se envíe.

​
Carpetas de skills de agentes de IA

Cuando creas un proyecto con base44 create, las skills de agentes de IA se instalan automáticamente. Aparecen en carpetas específicas del agente, como .claude/skills/, .cursor/skills/ o similares, según el asistente de IA para programación que uses. Estas carpetas ayudan a tu agente de programación a entender cómo trabajar con Base44 y se pueden enviar al control de versiones sin problemas.

​
Ver también

Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.