Conceptos

Cómo funcionan las aplicaciones

Una aplicación es un conjunto de entidades declaradas usando funciones defineEntity() del paquete twenty-sdk. La CLI detecta estas declaraciones a través de análisis AST en tiempo de construcción y produce un manifiesto — una descripción completa de lo que su aplicación añade a un espacio de trabajo. Estas funciones validan tu configuración en tiempo de compilación y proporcionan autocompletado en el IDE y seguridad de tipos.

your-app/
├── src/
│   ├── application-config.ts    ← defineApplication (required, one per app)
│   ├── roles/                   ← defineRole
│   ├── objects/                 ← defineObject
│   ├── fields/                  ← defineField
│   ├── validation-rules/        ← defineValidationRule
│   ├── logic-functions/         ← defineLogicFunction
│   ├── front-components/        ← defineFrontComponent
│   ├── skills/                  ← defineSkill
│   ├── agents/                  ← defineAgent
│   ├── mcp-servers/             ← defineMcpServer
│   ├── views/                   ← defineView
│   ├── navigation-menu-items/   ← defineNavigationMenuItem
│   ├── settings-menu-items/     ← defineSettingsMenuItem
│   └── page-layouts/            ← definePageLayout
├── public/                      ← Static assets (images, icons)
└── package.json

La organización de archivos depende de ti. La detección de entidades está basada en AST — el SDK encuentra export default defineEntity(. .) llama independientemente del lugar donde resida el archivo . La estructura de carpetas anterior es una convención, no un requisito.

Tipos de entidades

Entidad	Propósito	Documentos
Aplicación	Identidad de la aplicación, rol predeterminado, variables	Configuración de la aplicación
Rol	Conjuntos de permisos para objetos y campos	Roles y permisos
Object	Tipos de registros personalizados con campos	Objetos
Campo	Agregar campos a objetos de otras aplicaciones	Ampliar objetos
Relación	Vínculos bidireccionales entre objetos	Relaciones
Regla de validación	Condiciones que debe cumplir un registro antes de poder guardarse	Reglas de validación
Función de lógica	TypeScript del lado del servidor con activadores	Funciones de lógica
Habilidad	Instrucciones reutilizables para agentes de IA	Habilidades y agentes
Agente	Asistentes de IA con prompts personalizados	Habilidades y agentes
Flujo de trabajo	Flujos de trabajo listos con un disparador y pasos	Workflows
Proveedor de conexión	OAuth o inicio de sesión personalizado para cuentas de terceros	Conexiones
Proveedor de mensajería	Envía respuestas desde los canales de mensajería de una aplicación a través de una conexión	Canales de mensajería
Servidor MCP	Servidor MCP externo al que puede llamar la IA del espacio de trabajo	Habilidades y agentes
Vista	Vistas de listas de registros preconfiguradas	Vistas
Elemento del menú de navegación	Entradas personalizadas de la barra lateral	Elementos del menú de navegación
Diseño de página	Pestañas y widgets en la página de detalles de un registro	Diseños de página
Componente de frontend	Interfaz de usuario de React en entorno aislado dentro de Twenty	Componentes de frontend
Dependencias compartidas	Dependencias compartidas por los componentes del frontend de la aplicación, declaradas en package.json	Dependencias compartidas
Elemento del menú de comandos	Acciones rápidas y entradas Cmd+K	Elementos del menú de comandos
Ítem de menú de configuración	Entradas en el menú de configuración de la aplicación, cada uno renderizando un componente frontal	Artículos del menú de configuración

Sandboxing

Las funciones de lógica se ejecutan en procesos de Node.js aislados en el servidor. Sólo acceden a los datos a través del cliente de API escrito, que actúa como la persona que activó la ejecución o como la aplicación misma. Ver Quién accede a un uso de llamadas.
Los componentes de frontend se ejecutan en Web Workers usando Remote DOM — aislados de la página principal pero renderizando elementos DOM nativos (no iframes). Se comunican con Twenty a través de una API de host de paso de mensajes.
Los permisos se aplican a nivel de API. Se inyectan dos fichas de tiempo de ejecución, ambas derivadas del rol declarado con defineApplicationRole(); el valor por defecto se limita más a lo que la persona activadora puede hacer cuando alguien está detrás de la ejecución.

Ciclo de vida de la aplicación

┌─────────────────────────────────────────────────────────┐
│ Development                                             │
│   twenty app init → twenty app dev (live sync)   │
├─────────────────────────────────────────────────────────┤
│ Build & Deploy                                          │
│   twenty app build → twenty app publish        │
├─────────────────────────────────────────────────────────┤
│ Install flow                                            │
│   upload → [pre-install] → metadata migration →         │
│   generate SDK → [post-install] → … → [uninstall]       │
├─────────────────────────────────────────────────────────┤
│ Publish                                                 │
│   npm publish → appears in Twenty marketplace           │
└─────────────────────────────────────────────────────────┘

veinte aplicaciones dev — observa tus archivos de origen y los cambios en live-syncs a un servidor conectado Veenty . Tras una sincronización correcta, regenera el cliente de API tipado cuando el esquema o el paquete del generador instalado han cambiado, o cuando faltan archivos del cliente generado o han cambiado. Para actualizar los tipos después de cambiar el espacio de trabajo en la interfaz de usuario, ejecuta twenty app generate-client.
veinte apps build — compila TypeScript, agrupa funciones lógicas y componentes frontales con esbuild, y produce un manifiesto.
Hooks de pre/post-instalación y desinstalación — funciones opcionales que se ejecutan durante la instalación o justo antes de la desinstalación. Consulta Hooks de instalación para más detalles.

Próximos Pasos

Configura

identidad de la aplicación, rol predeterminado, e instala e instala ganchos.

datos

Objetos, campos y relaciones bidireccionales.

Logic

Funciones de lógica, habilidades, agentes, conexiones y canales de mensajería.

Diseño

Visualizaciones, navegación, diseños de páginas, componentes frontales.

Operaciones

CLI, prueba, remotos, CI y publica tu aplicación.

Desarrolladores

Aplicaciones

API

Autoalojamiento

Contribuir

Biblioteca de IU

Cómo funcionan las aplicaciones

Tipos de entidades

Sandboxing

Ciclo de vida de la aplicación

Próximos Pasos

​Cómo funcionan las aplicaciones

​Tipos de entidades

​Sandboxing

​Ciclo de vida de la aplicación

​Próximos Pasos

Cómo funcionan las aplicaciones

Tipos de entidades

Sandboxing

Ciclo de vida de la aplicación

Próximos Pasos