Files
twenty/packages/twenty-apps/hello-world
2a44bde848 Dynamic grql api wrapper on application sync (#15791)
# Introduction

Important note: for the moment testing this locally will require some
hack due to latest twenty-sdk not being published.
You will need to build twenty-cli and `cd packages/twenty-cli && yarn
link`
To finally sync the app in your app folder as `cd app-folder && twenty
app sync`

close https://github.com/twentyhq/core-team-issues/issues/1863

In this PR is introduced the generate sdk programmatic call to
[genql](https://genql.dev/) exposed in a `client` barrel of `twenty-sdk`
located in this package as there's high chances that will add a codegen
layer above it at some point ?

The cli calls this method after a sync application and writes a client
in a generated folder. It will make a graql introspection query on the
whole workspace. We should later improve that and only filter by current
applicationId and its dependencies ( when twenty-standard application is
introduced )

Fully typesafe ( input, output, filters etc ) auto-completed client

## Hello-world app serverless refactor

<img width="2480" height="1326" alt="image"
src="https://github.com/user-attachments/assets/b18ea372-b21d-4560-8fbc-1dc348427a95"
/>

---------

Co-authored-by: martmull <martmull@hotmail.fr>
2025-11-17 14:46:59 +01:00
..

Hello world

A minimal hello-world application built with an alpha version of the twenty-cli.

⚠️ Since this project uses an early alpha release, expect breaking changes and evolving features.

This example will gradually gain complexity and capabilities as the twenty-cli matures with future updates.

Requirements

  • twenty-cli npm install -g twenty-cli
  • an apiKey. Go to /settings/api-webhooks to generate one

Install to your Twenty workspace

cp .env.example .env
  • replace <SET_YOUR_TWENTY_API_KEY> and <SET_YOUR_TWENTY_API_URL> accordingly
twenty auth login
twenty app sync

What it does

  • creates a new object postCard with a name field
  • creates a serverless function create-new-post-card
  • two triggers on create-new-post-card:
    • one route trigger on GET /post-card/create?recipient=RecipientName
    • one databaseEvent trigger on people.created events

Development

Run dev mode and see application updates on your workspace instantly

twenty app dev