Andamiaje

En lugar de crear archivos de entidad a mano, usa el generador interactivo:

yarn twenty dev:add

Te pide que elijas un tipo de entidad y te guía por los campos requeridos; luego escribe un archivo listo para usar con un universalIdentifier estable y la llamada correcta a defineEntity(). También puedes pasar el tipo de entidad directamente para omitir la primera pregunta:

yarn twenty dev:add object
yarn twenty dev:add logicFunction
yarn twenty dev:add frontComponent

Tipos de entidad disponibles

Tipo de entidad	Comando	Archivo generado
Objeto	`yarn twenty dev:add object`	`src/objects/\<name>.ts`
Campo	`yarn twenty dev:add field`	`src/fields/\<name>.ts`
Función de lógica	`yarn twenty dev:add logicFunction`	`src/logic-functions/\<name>.ts`
Componente de frontend	`yarn twenty dev:add frontComponent`	`src/front-components/\<name>.tsx`
Rol	`yarn twenty dev:add role`	`src/roles/\<name>.ts`
Habilidad	`yarn twenty dev:add skill`	`src/skills/\<name>.ts`
Agente	`yarn twenty dev:add agent`	`src/agents/\<name>.ts`
Vista	`yarn twenty dev:add view`	`src/views/\<name>.ts`
Elemento del menú de navegación	`yarn twenty dev:add navigationMenuItem`	`src/navigation-menu-items/\<name>.ts`
Diseño de página	`yarn twenty dev:add pageLayout`	`src/page-layouts/\<name>.ts`
Pestaña Diseño de página	`yarn twenty dev:add pageLayoutTab`	`src/page-layout-tabs/\<name>.ts`
Elemento del menú de comandos	`yarn twenty dev:add commandMenuItem`	`src/command-menu-items/\<name>.ts`
Campo de vista	`yarn twenty dev:add viewField`	`src/view-fields/\<name>.ts`
Proveedor de conexión	`yarn twenty dev:add connectionProvider`	`src/connection-providers/\<name>.ts`

Qué genera el generador

Cada tipo de entidad tiene su propia plantilla. Por ejemplo, yarn twenty dev:add object solicita:

Nombre (singular) — p. ej., invoice
Nombre (plural) — p. ej., invoices
Etiqueta (singular) — se completa automáticamente a partir del nombre (p. ej., Invoice)
Etiqueta (plural) — se completa automáticamente (p. ej., Invoices)
¿Crear una vista y un elemento de navegación? — si respondes que sí, el generador también crea una vista correspondiente y un enlace en la barra lateral para el nuevo objeto.

Otros tipos de entidad tienen indicaciones más simples: la mayoría solo piden un nombre. El tipo de entidad field es más detallado: pide el nombre del campo, etiqueta, tipo (de una lista de todos los tipos de campo disponibles como TEXT, NUMBER, SELECT, RELATION, etc.) y el universalIdentifier del objeto de destino.

Ruta de salida personalizada

Usa la opción --path para colocar el archivo generado en una ubicación personalizada:

yarn twenty dev:add logicFunction --path src/custom-folder

Resumen

Aplicaciones

API

Autoalojamiento

Contribuir

Tipos de entidad disponibles

Qué genera el generador

Ruta de salida personalizada

​Tipos de entidad disponibles

​Qué genera el generador

​Ruta de salida personalizada

Tipos de entidad disponibles

Qué genera el generador

Ruta de salida personalizada