Files
twenty/packages/twenty-apps/hello-world
Paul Rastoin 75bb3a904d [SDK] Refactor clients (#18433)
# Intoduction

Closes https://github.com/twentyhq/core-team-issues/issues/2289

In this PR all the clients becomes available under `twenty-sdk/clients`,
this is a breaking change but generated was too vague and thats still
the now or never best timing to do so

## CoreClient
The core client is now shipped with a default stub empty class for both
the schema and the client
Allowing its import, will still raises typescript errors when consumed
as generated but not generated

## MetadataClient
The metadata client is workspace agnostic, it's now generated and
commited in the repo. added a ci that prevents any schema desync due to
twenty-server additions

Same behavior than for the twenty-front generated graphql schema
2026-03-09 15:32:13 +00:00
..
2026-03-09 15:32:13 +00:00
2026-03-09 15:32:13 +00:00
2026-03-09 15:32:13 +00:00
2026-03-09 15:32:13 +00:00
2026-03-09 15:32:13 +00:00

This is a Twenty application project bootstrapped with create-twenty-app.

Getting Started

First, authenticate to your workspace:

yarn twenty auth:login

Then, start development mode to sync your app and watch for changes:

yarn twenty app:dev

Open your Twenty instance and go to /settings/applications section to see the result.

Available Commands

Run yarn twenty help to list all available commands. Common commands:

# Authentication
yarn twenty auth:login     # Authenticate with Twenty
yarn twenty auth:logout    # Remove credentials
yarn twenty auth:status    # Check auth status
yarn twenty auth:switch    # Switch default workspace
yarn twenty auth:list      # List all configured workspaces

# Application
yarn twenty app:dev        # Start dev mode (watch, build, sync, and auto-generate typed client)
yarn twenty entity:add     # Add a new entity (object, field, function, front-component, role, view, navigation-menu-item)
yarn twenty function:logs  # Stream function logs
yarn twenty function:execute  # Execute a function with JSON payload
yarn twenty app:uninstall  # Uninstall app from workspace

Integration Tests

If your project includes the example integration test (src/__tests__/app-install.integration-test.ts), you can run it with:

# Make sure a Twenty server is running at http://localhost:3000
yarn test

The test builds and installs the app, then verifies it appears in the applications list. Test configuration (API URL and API key) is defined in vitest.config.ts.

LLMs instructions

Main docs and pitfalls are available in LLMS.md file.

Learn More

To learn more about Twenty applications, take a look at the following resources:

You can check out the Twenty GitHub repository - your feedback and contributions are welcome!