Create Twenty App

Create Twenty App is the official scaffolding CLI for building apps on top of [Twenty CRM](https://twenty.com). It sets up a ready‑to‑run project that works seamlessly with the [twenty-sdk](https://www.npmjs.com/package/twenty-sdk). - Zero‑config project bootstrap - Preconfigured scripts for auth, dev mode (watch & sync), uninstall, and function management - Strong TypeScript support and typed client generation ## Documentation See Twenty application documentation https://docs.twenty.com/developers/extend/capabilities/apps ## Prerequisites - Node.js 24+ (recommended) and Yarn 4 - A Twenty workspace and an API key (create one at https://app.twenty.com/settings/api-webhooks) ## Quick start ```bash npx create-twenty-app@latest my-twenty-app cd my-twenty-app # If you don't use yarn@4 corepack enable yarn install # Get help and list all available commands yarn twenty help # Authenticate using your API key (you'll be prompted) yarn twenty auth:login # Add a new entity to your application (guided) yarn twenty entity:add # Start dev mode: watches, builds, and syncs local changes to your workspace # (also auto-generates a typed API client in node_modules/twenty-sdk/generated) yarn twenty app:dev # Watch your application's function logs yarn twenty function:logs # Execute a function with a JSON payload yarn twenty function:execute -n my-function -p '{"key": "value"}' # Execute the post-install function yarn twenty function:execute --postInstall # Uninstall the application from the current workspace yarn twenty app:uninstall ``` ## Scaffolding modes Control which example files are included when creating a new app: | Flag | Behavior | |------|----------| | `-e, --exhaustive` | **(default)** Creates all example files without prompting | | `-m, --minimal` | Creates only core files (`application-config.ts` and `default-role.ts`) | | `-i, --interactive` | Prompts you to select which examples to include | ```bash # Default: all examples included npx create-twenty-app@latest my-app # Minimal: only core files npx create-twenty-app@latest my-app -m # Interactive: choose which examples to include npx create-twenty-app@latest my-app -i ``` In interactive mode, you can pick from: - **Example object** — a custom CRM object definition (`objects/example-object.ts`) - **Example field** — a custom field on the example object (`fields/example-field.ts`) - **Example logic function** — a server-side handler with HTTP trigger (`logic-functions/hello-world.ts`) - **Example front component** — a React UI component (`front-components/hello-world.tsx`) - **Example view** — a saved view for the example object (`views/example-view.ts`) - **Example navigation menu item** — a sidebar link (`navigation-menu-items/example-navigation-menu-item.ts`) ## What gets scaffolded **Core files (always created):** - `application-config.ts` — Application metadata configuration - `roles/default-role.ts` — Default role for logic functions - `logic-functions/post-install.ts` — Post-install logic function (runs after app installation) - TypeScript configuration, ESLint, package.json, .gitignore - A prewired `twenty` script that delegates to the `twenty` CLI from twenty-sdk **Example files (controlled by scaffolding mode):** - `objects/example-object.ts` — Example custom object with a text field - `fields/example-field.ts` — Example standalone field extending the example object - `logic-functions/hello-world.ts` — Example logic function with HTTP trigger - `front-components/hello-world.tsx` — Example front component - `views/example-view.ts` — Example saved view for the example object - `navigation-menu-items/example-navigation-menu-item.ts` — Example sidebar navigation link ## Next steps - Run `yarn twenty help` to see all available commands. - Use `yarn twenty auth:login` to authenticate with your Twenty workspace. - Explore the generated project and add your first entity with `yarn twenty entity:add` (logic functions, front components, objects, roles, views, navigation menu items). - Use `yarn twenty app:dev` while you iterate — it watches, builds, and syncs changes to your workspace in real time. - Types are auto‑generated by `yarn twenty app:dev` and stored in `node_modules/twenty-sdk/generated`. ## Publish your application Applications are currently stored in `twenty/packages/twenty-apps`. You can share your application with all Twenty users: ```bash # pull the Twenty project git clone https://github.com/twentyhq/twenty.git cd twenty # create a new branch git checkout -b feature/my-awesome-app ``` - Copy your app folder into `twenty/packages/twenty-apps`. - Commit your changes and open a pull request on https://github.com/twentyhq/twenty ```bash git commit -m "Add new application" git push ``` Our team reviews contributions for quality, security, and reusability before merging. ## Troubleshooting - Auth prompts not appearing: run `yarn twenty auth:login` again and verify the API key permissions. - Types not generated: ensure `yarn twenty app:dev` is running — it auto‑generates the typed client. ## Contributing - See our [GitHub](https://github.com/twentyhq/twenty) - Join our [Discord](https://discord.gg/cx5n4Jzs57)