fix: replace MetadataEvent double cast with proper EventStreamMetadataEvent type

The broadcaster produces a simpler shape than the workspace-migration MetadataEvent discriminated union, and includes updatedCollectionHash which MetadataEvent lacks. Define EventStreamMetadataEvent to match what the broadcaster actually produces, removing the as unknown as cast. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu
chore: regenerate GraphQL types and client SDK
2026-04-02 06:35:08 +00:00 · 2026-04-02 06:15:04 +00:00 · 2026-04-02 06:15:04 +00:00 · 2026-04-02 06:15:03 +00:00 · 2026-04-02 06:15:03 +00:00 · 2026-04-02 06:15:03 +00:00
1035 changed files with 15715 additions and 44372 deletions
@@ -1,186 +0,0 @@
-name: CI Create App E2E minimal
-
-on:
-  push:
-    branches:
-      - main
-
-  pull_request:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        packages/create-twenty-app/**
-        packages/twenty-sdk/**
-        packages/twenty-client-sdk/**
-        packages/twenty-shared/**
-        packages/twenty-server/**
-        !packages/create-twenty-app/package.json
-        !packages/twenty-sdk/package.json
-        !packages/twenty-client-sdk/package.json
-        !packages/twenty-shared/package.json
-        !packages/twenty-server/package.json
-  create-app-e2e-minimal:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: ubuntu-latest-4-cores
-    services:
-      postgres:
-        image: postgres:18
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    env:
-      PUBLISHABLE_PACKAGES: twenty-client-sdk twenty-sdk create-twenty-app
-    steps:
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 10
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Set CI version and prepare packages for publish
-        run: |
-          CI_VERSION="0.0.0-ci.$(date +%s)"
-          echo "CI_VERSION=$CI_VERSION" >> $GITHUB_ENV
-          npx nx run-many -t set-local-version -p $PUBLISHABLE_PACKAGES --releaseVersion=$CI_VERSION
-
-      - name: Build packages
-        run: |
-          for pkg in $PUBLISHABLE_PACKAGES; do
-            npx nx build $pkg
-          done
-
-      - name: Install and start Verdaccio
-        run: |
-          npx verdaccio --config .github/verdaccio-config.yaml &
-
-          for i in $(seq 1 30); do
-            if curl -s http://localhost:4873 > /dev/null 2>&1; then
-              echo "Verdaccio is ready"
-              break
-            fi
-            echo "Waiting for Verdaccio... ($i/30)"
-            sleep 1
-          done
-
-      - name: Publish packages to local registry
-        run: |
-          yarn config set npmRegistryServer http://localhost:4873
-          yarn config set unsafeHttpWhitelist --json '["localhost"]'
-          yarn config set npmAuthToken ci-auth-token
-
-          for pkg in $PUBLISHABLE_PACKAGES; do
-            cd packages/$pkg
-            yarn npm publish --tag ci
-            cd ../..
-          done
-
-      - name: Scaffold app using published create-twenty-app
-        run: |
-          npm install -g create-twenty-app@$CI_VERSION --registry http://localhost:4873
-          create-twenty-app --version
-          mkdir -p /tmp/e2e-test-workspace
-          cd /tmp/e2e-test-workspace
-          create-twenty-app test-app --display-name "Test scaffolded app" --description "E2E test scaffolded app" --skip-local-instance
-
-      - name: Install scaffolded app dependencies
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          echo 'npmRegistryServer: "http://localhost:4873"' >> .yarnrc.yml
-          echo 'unsafeHttpWhitelist: ["localhost"]' >> .yarnrc.yml
-          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn install --no-immutable
-
-      - name: Verify installed app versions
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          echo "--- Checking package.json references correct SDK version ---"
-          node -e "
-            const pkg = require('./package.json');
-            const sdkVersion = pkg.dependencies['twenty-sdk'];
-            if (!sdkVersion.startsWith('0.0.0-ci.')) {
-              console.error('Expected twenty-sdk version to start with 0.0.0-ci., got:', sdkVersion);
-              process.exit(1);
-            }
-            console.log('SDK version in scaffolded app:', sdkVersion);
-          "
-
-      - name: Verify SDK CLI is available
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty --version
-
-      - name: Setup server environment
-        run: npx nx reset:env:e2e-testing-server twenty-server
-
-      - name: Build server
-        run: npx nx build twenty-server
-
-      - name: Create and setup database
-        run: |
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-          npx nx run twenty-server:database:reset
-
-      - name: Start server
-        run: |
-          npx nx start twenty-server &
-          echo "Waiting for server to be ready..."
-          timeout 60 bash -c 'until curl -s http://localhost:3000/health; do sleep 2; done'
-
-      - name: Authenticate with twenty-server
-        env:
-          SEED_API_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik'
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty remote add --api-key $SEED_API_KEY --api-url http://localhost:3000
-
-      - name: Deploy scaffolded app
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty deploy
-
-      - name: Install scaffolded app
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty install
-
-      - name: Run scaffolded app integration test
-        env:
-          TWENTY_API_URL: http://localhost:3000
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          yarn test
-
-  ci-create-app-e2e-minimal-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    needs: [changed-files-check, create-app-e2e-minimal]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1
@@ -1,204 +0,0 @@
-name: CI Postcard App E2E
-
-on:
-  # Temporarily disabled — will be re-enabled when example apps are published.
-  # push:
-  #   branches:
-  #     - main
-  #
-  # pull_request:
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        packages/create-twenty-app/**
-        packages/twenty-sdk/**
-        packages/twenty-client-sdk/**
-        packages/twenty-shared/**
-        packages/twenty-server/**
-        !packages/create-twenty-app/package.json
-        !packages/twenty-sdk/package.json
-        !packages/twenty-client-sdk/package.json
-        !packages/twenty-shared/package.json
-        !packages/twenty-server/package.json
-  create-app-e2e-postcard:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: ubuntu-latest-4-cores
-    services:
-      postgres:
-        image: postgres:18
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    env:
-      PUBLISHABLE_PACKAGES: twenty-client-sdk twenty-sdk create-twenty-app
-    steps:
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 10
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Set CI version and prepare packages for publish
-        run: |
-          CI_VERSION="0.0.0-ci.$(date +%s)"
-          echo "CI_VERSION=$CI_VERSION" >> $GITHUB_ENV
-          npx nx run-many -t set-local-version -p $PUBLISHABLE_PACKAGES --releaseVersion=$CI_VERSION
-
-      - name: Build packages
-        run: |
-          for pkg in $PUBLISHABLE_PACKAGES; do
-            npx nx build $pkg
-          done
-
-      - name: Install and start Verdaccio
-        run: |
-          npx verdaccio --config .github/verdaccio-config.yaml &
-
-          for i in $(seq 1 30); do
-            if curl -s http://localhost:4873 > /dev/null 2>&1; then
-              echo "Verdaccio is ready"
-              break
-            fi
-            echo "Waiting for Verdaccio... ($i/30)"
-            sleep 1
-          done
-
-      - name: Publish packages to local registry
-        run: |
-          yarn config set npmRegistryServer http://localhost:4873
-          yarn config set unsafeHttpWhitelist --json '["localhost"]'
-          yarn config set npmAuthToken ci-auth-token
-
-          for pkg in $PUBLISHABLE_PACKAGES; do
-            cd packages/$pkg
-            yarn npm publish --tag ci
-            cd ../..
-          done
-
-      - name: Scaffold app using published create-twenty-app
-        run: |
-          npm install -g create-twenty-app@$CI_VERSION --registry http://localhost:4873
-          create-twenty-app --version
-          mkdir -p /tmp/e2e-test-workspace
-          cd /tmp/e2e-test-workspace
-          create-twenty-app test-app --example postcard --display-name "Test postcard app" --description "E2E test postcard app" --skip-local-instance
-
-      - name: Install scaffolded app dependencies
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          echo 'npmRegistryServer: "http://localhost:4873"' >> .yarnrc.yml
-          echo 'unsafeHttpWhitelist: ["localhost"]' >> .yarnrc.yml
-          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn install --no-immutable
-          echo "--- Installing last SDK versions ---"
-          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn add twenty-sdk twenty-client-sdk
-
-      - name: Verify installed app versions
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          echo "--- Checking package.json references correct SDK version ---"
-          node -e "
-            const pkg = require('./package.json');
-            const sdkVersion = pkg.dependencies['twenty-sdk'];
-            if (!sdkVersion.startsWith('0.0.0-ci.')) {
-              console.error('Expected twenty-sdk version to start with 0.0.0-ci., got:', sdkVersion);
-              process.exit(1);
-            }
-            console.log('SDK version in scaffolded app:', sdkVersion);
-          "
-
-      - name: Verify SDK CLI is available
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty --version
-
-      - name: Setup server environment
-        run: npx nx reset:env:e2e-testing-server twenty-server
-
-      - name: Build server
-        run: npx nx build twenty-server
-
-      - name: Create and setup database
-        run: |
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
-          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-          npx nx run twenty-server:database:reset
-
-      - name: Start server
-        run: |
-          npx nx start twenty-server &
-          echo "Waiting for server to be ready..."
-          timeout 60 bash -c 'until curl -s http://localhost:3000/health; do sleep 2; done'
-
-      - name: Authenticate with twenty-server
-        env:
-          SEED_API_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik'
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty remote add --api-key $SEED_API_KEY --api-url http://localhost:3000
-
-      - name: Deploy scaffolded app
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty deploy
-
-      - name: Install scaffolded app
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty install
-
-      - name: Execute postcard logic function
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          EXEC_OUTPUT=$(npx --no-install twenty exec --functionName postcard-logic-function)
-          echo "$EXEC_OUTPUT"
-          echo "$EXEC_OUTPUT" | grep -q "Hello, World!"
-
-      - name: Execute create-postcard-company logic function
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          EXEC_OUTPUT=$(npx --no-install twenty exec --functionName create-postcard-company)
-          echo "$EXEC_OUTPUT"
-          echo "$EXEC_OUTPUT" | grep -q 'Created company.*Hello World.*with id'
-
-      - name: Run scaffolded app integration test
-        env:
-          TWENTY_API_URL: http://localhost:3000
-        run: |
-          cd /tmp/e2e-test-workspace/test-app
-          yarn test
-
-  ci-create-app-e2e-postcard-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    needs: [changed-files-check, create-app-e2e-postcard]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1
@@ -1,13 +1,11 @@
-name: CI Hello world App E2E
+name: CI Create App E2E

 on:
-  # Temporarily disabled — will be re-enabled when example apps are published.
-  # push:
-  #   branches:
-  #     - main
-  #
-  # pull_request:
-  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+  pull_request:

 permissions:
  contents: read
@@ -31,7 +29,7 @@ jobs:
        !packages/twenty-client-sdk/package.json
        !packages/twenty-shared/package.json
        !packages/twenty-server/package.json
-  create-app-e2e-hello-world:
+  create-app-e2e:
    needs: changed-files-check
    if: needs.changed-files-check.outputs.any_changed == 'true'
    timeout-minutes: 30
@@ -68,9 +66,7 @@ jobs:
        run: |
          CI_VERSION="0.0.0-ci.$(date +%s)"
          echo "CI_VERSION=$CI_VERSION" >> $GITHUB_ENV
-          for pkg in $PUBLISHABLE_PACKAGES; do
-            npx nx run $pkg:set-local-version --releaseVersion=$CI_VERSION
-          done
+          npx nx run-many -t set-local-version -p $PUBLISHABLE_PACKAGES --releaseVersion=$CI_VERSION

      - name: Build packages
        run: |
@@ -109,7 +105,7 @@ jobs:
          create-twenty-app --version
          mkdir -p /tmp/e2e-test-workspace
          cd /tmp/e2e-test-workspace
-          create-twenty-app test-app --example hello-world --display-name "Test hello-world app" --description "E2E test hello-world app" --skip-local-instance
+          create-twenty-app test-app --exhaustive --display-name "Test App" --description "E2E test app" --skip-local-instance

      - name: Install scaffolded app dependencies
        run: |
@@ -117,8 +113,6 @@ jobs:
          echo 'npmRegistryServer: "http://localhost:4873"' >> .yarnrc.yml
          echo 'unsafeHttpWhitelist: ["localhost"]' >> .yarnrc.yml
          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn install --no-immutable
-          echo "--- Installing last SDK versions ---"
-          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn add twenty-sdk twenty-client-sdk

      - name: Verify installed app versions
        run: |
@@ -126,7 +120,7 @@ jobs:
          echo "--- Checking package.json references correct SDK version ---"
          node -e "
            const pkg = require('./package.json');
-            const sdkVersion = pkg.dependencies['twenty-sdk'];
+            const sdkVersion = pkg.devDependencies['twenty-sdk'];
            if (!sdkVersion.startsWith('0.0.0-ci.')) {
              console.error('Expected twenty-sdk version to start with 0.0.0-ci., got:', sdkVersion);
              process.exit(1);
@@ -195,11 +189,11 @@ jobs:
          cd /tmp/e2e-test-workspace/test-app
          yarn test

-  ci-create-app-e2e-hello-world-status-check:
+  ci-create-app-e2e-status-check:
    if: always() && !cancelled()
    timeout-minutes: 5
    runs-on: ubuntu-latest
-    needs: [changed-files-check, create-app-e2e-hello-world]
+    needs: [changed-files-check, create-app-e2e]
    steps:
      - name: Fail job if any needs failed
        if: contains(needs.*.result, 'failure')
@@ -52,4 +52,3 @@ mcp.json
 /.junie/
 TRANSLATION_QA_REPORT.md
 .playwright-mcp/
-.playwright-cli/
@@ -82,11 +82,11 @@
    "@sentry/types": "^8",
    "@storybook-community/storybook-addon-cookie": "^5.0.0",
    "@storybook/addon-coverage": "^3.0.0",
-    "@storybook/addon-docs": "^10.3.3",
-    "@storybook/addon-links": "^10.3.3",
-    "@storybook/addon-vitest": "^10.3.3",
+    "@storybook/addon-docs": "^10.2.13",
+    "@storybook/addon-links": "^10.2.13",
+    "@storybook/addon-vitest": "^10.2.13",
    "@storybook/icons": "^2.0.1",
-    "@storybook/react-vite": "^10.3.3",
+    "@storybook/react-vite": "^10.2.13",
    "@storybook/test-runner": "^0.24.2",
    "@swc-node/register": "^1.11.1",
    "@swc/cli": "^0.7.10",
@@ -154,9 +154,9 @@
    "raw-loader": "^4.0.2",
    "rimraf": "^5.0.5",
    "source-map-support": "^0.5.20",
-    "storybook": "^10.3.3",
+    "storybook": "^10.2.13",
    "storybook-addon-mock-date": "2.0.0",
-    "storybook-addon-pseudo-states": "^10.3.3",
+    "storybook-addon-pseudo-states": "^10.2.13",
    "supertest": "^6.1.3",
    "ts-jest": "^29.1.1",
    "ts-loader": "^9.2.3",
@@ -24,27 +24,24 @@ yarn twenty dev

 The scaffolder will:

-1. Create a new project with TypeScript, linting, tests, and a preconfigured `twenty` CLI
+1. Create a new project with TypeScript, linting, and a preconfigured `twenty` CLI
 2. Optionally start a local Twenty server (Docker)
 3. Open the browser for OAuth authentication
+4. Scaffold example entities and an integration test

-## Options
+## Scaffolding modes

-| Flag                           | Description                             |
-| ------------------------------ | --------------------------------------- |
-| `--example <name>`             | Initialize from an example              |
-| `--name <name>`                | Set the app name (skips the prompt)     |
-| `--display-name <displayName>` | Set the display name (skips the prompt) |
-| `--description <description>`  | Set the description (skips the prompt)  |
-| `--skip-local-instance`        | Skip the local server setup prompt      |
+| Flag           | Behavior                                                                                                       |
+| -------------- | -------------------------------------------------------------------------------------------------------------- |
+| `--minimal`    | **(default)** Creates only core files (`application-config.ts`, `default-role.ts`, pre/post-install functions) |
+| `--exhaustive` | Creates all example entities                                                                                   |

-By default (no flags), a minimal app is generated with core files and an integration test. Use `--example` to start from a richer example:
+Other flags:

-```bash
-npx create-twenty-app@latest my-twenty-app --example hello-world
-```
-
-Examples are sourced from [twentyhq/twenty/packages/twenty-apps/examples](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples).
+- `--name <name>` — set the app name (skips the prompt)
+- `--display-name <displayName>` — set the display name (skips the prompt)
+- `--description <description>` — set the description (skips the prompt)
+- `--skip-local-instance` — skip the local server setup prompt

 ## Documentation

@@ -1,6 +1,6 @@
 {
  "name": "create-twenty-app",
-  "version": "0.8.0-canary.9",
+  "version": "0.8.0-canary.8",
  "description": "Command-line interface to create Twenty application",
  "main": "dist/cli.cjs",
  "bin": "dist/cli.cjs",
@@ -2,6 +2,7 @@
 import chalk from 'chalk';
 import { Command, CommanderError } from 'commander';
 import { CreateAppCommand } from '@/create-app.command';
+import { type ScaffoldingMode } from '@/types/scaffolding-options';
 import packageJson from '../package.json';

 const program = new Command(packageJson.name)
@@ -12,7 +13,11 @@ const program = new Command(packageJson.name)
    'Output the current version of create-twenty-app.',
  )
  .argument('[directory]')
-  .option('--example <name>', 'Initialize from an example')
+  .option('-e, --exhaustive', 'Create all example entities')
+  .option(
+    '-m, --minimal',
+    'Create only core entities (application-config and default-role) (default)',
+  )
  .option('-n, --name <name>', 'Application name (skips prompt)')
  .option(
    '-d, --display-name <displayName>',
@@ -31,13 +36,25 @@ const program = new Command(packageJson.name)
    async (
      directory?: string,
      options?: {
-        example?: string;
+        exhaustive?: boolean;
+        minimal?: boolean;
        name?: string;
        displayName?: string;
        description?: string;
        skipLocalInstance?: boolean;
      },
    ) => {
+      const modeFlags = [options?.exhaustive, options?.minimal].filter(Boolean);
+
+      if (modeFlags.length > 1) {
+        console.error(
+          chalk.red(
+            'Error: --exhaustive and --minimal are mutually exclusive.',
+          ),
+        );
+        process.exit(1);
+      }
+
      if (directory && !/^[a-z0-9-]+$/.test(directory)) {
        console.error(
          chalk.red(
@@ -52,9 +69,13 @@ const program = new Command(packageJson.name)
        process.exit(1);
      }

+      const mode: ScaffoldingMode = options?.exhaustive
+        ? 'exhaustive'
+        : 'minimal';
+
      await new CreateAppCommand().execute({
        directory,
-        example: options?.example,
+        mode,
        name: options?.name,
        displayName: options?.displayName,
        description: options?.description,
@@ -1,7 +1,7 @@
 ## Base documentation

- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
+- Documentation: https://docs.twenty.com/developers/extend/capabilities/apps
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/postcard-app

 ## UUID requirement

@@ -6,6 +6,6 @@ Run `yarn twenty help` to list all available commands.

 ## Learn More

- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started)
+- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/capabilities/apps)
 - [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)
 - [Discord](https://discord.gg/cx5n4Jzs57)
@@ -33,10 +33,5 @@
    "**/*.test.ts",
    "**/*.spec.ts",
    "**/*.integration-test.ts"
-  ],
-  "references": [
-    {
-      "path": "./tsconfig.spec.json"
-    }
  ]
 }
@@ -1,14 +0,0 @@
-## Base documentation
-
- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples/postcard
-
-## UUID requirement
-
- All generated UUIDs must be valid UUID v4.
-
-## Common Pitfalls
-
- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -1,14 +0,0 @@
-## Base documentation
-
- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples/postcard
-
-## UUID requirement
-
- All generated UUIDs must be valid UUID v4.
-
-## Common Pitfalls
-
- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -1,11 +0,0 @@
-This is a [Twenty](https://twenty.com) application bootstrapped with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app).
-
-## Getting Started
-
-Run `yarn twenty help` to list all available commands.
-
-## Learn More
-
- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started)
- [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)
- [Discord](https://discord.gg/cx5n4Jzs57)
@@ -1,38 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.*
-.yarn
-
-# codegen
-generated
-
-# testing
-/coverage
-
-# dev
-/dist/
-
-.twenty
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# env files (can opt-in for committing if needed)
-.env*
-
-# typescript
-*.tsbuildinfo
-*.d.ts
@@ -1,35 +0,0 @@
-{
-  "name": "TO-BE-GENERATED",
-  "version": "0.1.0",
-  "license": "MIT",
-  "engines": {
-    "node": "^24.5.0",
-    "npm": "please-use-yarn",
-    "yarn": ">=4.0.2"
-  },
-  "keywords": [
-    "twenty-app"
-  ],
-  "packageManager": "[email protected]",
-  "scripts": {
-    "twenty": "twenty",
-    "lint": "oxlint -c .oxlintrc.json .",
-    "lint:fix": "oxlint --fix -c .oxlintrc.json .",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "twenty-client-sdk": "TO-BE-GENERATED",
-    "twenty-sdk": "TO-BE-GENERATED"
-  },
-  "devDependencies": {
-    "@types/node": "^24.7.2",
-    "@types/react": "^19.0.0",
-    "oxlint": "^0.16.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^4.2.1",
-    "vitest": "^3.1.1"
-  }
-}
@@ -1,70 +0,0 @@
-import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
-import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
-import { MetadataApiClient } from 'twenty-client-sdk/metadata';
-import { afterAll, beforeAll, describe, expect, it } from 'vitest';
-
-const APP_PATH = process.cwd();
-
-describe('App installation', () => {
-  beforeAll(async () => {
-    const buildResult = await appBuild({
-      appPath: APP_PATH,
-      tarball: true,
-      onProgress: (message: string) => console.log(`[build] ${message}`),
-    });
-
-    if (!buildResult.success) {
-      throw new Error(
-        `Build failed: ${buildResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-
-    const deployResult = await appDeploy({
-      tarballPath: buildResult.data.tarballPath!,
-      onProgress: (message: string) => console.log(`[deploy] ${message}`),
-    });
-
-    if (!deployResult.success) {
-      throw new Error(
-        `Deploy failed: ${deployResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-
-    const installResult = await appInstall({ appPath: APP_PATH });
-
-    if (!installResult.success) {
-      throw new Error(
-        `Install failed: ${installResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-  });
-
-  afterAll(async () => {
-    const uninstallResult = await appUninstall({ appPath: APP_PATH });
-
-    if (!uninstallResult.success) {
-      console.warn(
-        `App uninstall failed: ${uninstallResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-  });
-
-  it('should find the installed app in the applications list', async () => {
-    const metadataClient = new MetadataApiClient();
-
-    const result = await metadataClient.query({
-      findManyApplications: {
-        id: true,
-        name: true,
-        universalIdentifier: true,
-      },
-    });
-
-    const installedApp = result.findManyApplications.find(
-      (application: { universalIdentifier: string }) =>
-        application.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
-    );
-
-    expect(installedApp).toBeDefined();
-  });
-});
@@ -1,45 +0,0 @@
-import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-import { beforeAll } from 'vitest';
-
-const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
-const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
-
-const assertServerIsReachable = async () => {
-  let response: Response;
-
-  try {
-    response = await fetch(`${TWENTY_API_URL}/healthz`);
-  } catch {
-    throw new Error(
-      `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
-        'Make sure the server is running before executing integration tests.',
-    );
-  }
-
-  if (!response.ok) {
-    throw new Error(`Server at ${TWENTY_API_URL} returned ${response.status}`);
-  }
-};
-
-beforeAll(async () => {
-  await assertServerIsReachable();
-
-  fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
-
-  const configFile = {
-    remotes: {
-      local: {
-        apiUrl: process.env.TWENTY_API_URL,
-        apiKey: process.env.TWENTY_API_KEY,
-      },
-    },
-    defaultRemote: 'local',
-  };
-
-  fs.writeFileSync(
-    path.join(TEST_CONFIG_DIR, 'config.json'),
-    JSON.stringify(configFile, null, 2),
-  );
-});
@@ -1,15 +0,0 @@
-import { defineApplication } from 'twenty-sdk';
-
-import {
-  APP_DESCRIPTION,
-  APP_DISPLAY_NAME,
-  APPLICATION_UNIVERSAL_IDENTIFIER,
-  DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-} from 'src/constants/universal-identifiers';
-
-export default defineApplication({
-  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
-  displayName: APP_DISPLAY_NAME,
-  description: APP_DESCRIPTION,
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-});
@@ -1,4 +0,0 @@
-export const APP_DISPLAY_NAME = 'DISPLAY-NAME-TO-BE-GENERATED';
-export const APP_DESCRIPTION = 'DESCRIPTION-TO-BE-GENERATED';
-export const APPLICATION_UNIVERSAL_IDENTIFIER = 'UUID-TO-BE-GENERATED';
-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER = 'UUID-TO-BE-GENERATED';
@@ -1,16 +0,0 @@
-import { defineRole } from 'twenty-sdk';
-
-import {
-  APP_DISPLAY_NAME,
-  DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-} from 'src/constants/universal-identifiers';
-
-export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-  label: `${APP_DISPLAY_NAME} default function role`,
-  description: `${APP_DISPLAY_NAME} default function role`,
-  canReadAllObjectRecords: true,
-  canUpdateAllObjectRecords: true,
-  canSoftDeleteAllObjectRecords: true,
-  canDestroyAllObjectRecords: false,
-});
@@ -1,42 +0,0 @@
-{
-  "compileOnSave": false,
-  "compilerOptions": {
-    "sourceMap": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": ".",
-    "jsx": "react-jsx",
-    "moduleResolution": "node",
-    "allowSyntheticDefaultImports": true,
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "importHelpers": true,
-    "allowUnreachableCode": false,
-    "strict": true,
-    "alwaysStrict": true,
-    "noImplicitAny": true,
-    "strictBindCallApply": false,
-    "target": "es2018",
-    "module": "esnext",
-    "lib": ["es2020", "dom"],
-    "skipLibCheck": true,
-    "skipDefaultLibCheck": true,
-    "resolveJsonModule": true,
-    "paths": {
-      "src/*": ["./src/*"],
-      "~/*": ["./*"]
-    }
-  },
-  "exclude": [
-    "node_modules",
-    "dist",
-    "**/*.test.ts",
-    "**/*.spec.ts",
-    "**/*.integration-test.ts"
-  ],
-  "references": [
-    {
-      "path": "./tsconfig.spec.json"
-    }
-  ]
-}
@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "composite": true,
-    "types": ["vitest/globals", "node"]
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "dist"]
-}
@@ -1,21 +0,0 @@
-import tsconfigPaths from 'vite-tsconfig-paths';
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  plugins: [
-    tsconfigPaths({
-      projects: ['tsconfig.spec.json'],
-      ignoreConfigErrors: true,
-    }),
-  ],
-  test: {
-    testTimeout: 120_000,
-    hookTimeout: 120_000,
-    include: ['src/**/*.integration-test.ts'],
-    setupFiles: ['src/__tests__/setup-test.ts'],
-    env: {
-      TWENTY_API_KEY:
-        'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik',
-    },
-  },
-});
@@ -1,2 +0,0 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
-# yarn lockfile v1
@@ -1,5 +1,4 @@
 import { copyBaseApplicationProject } from '@/utils/app-template';
-import { downloadExample } from '@/utils/download-example';
 import { convertToLabel } from '@/utils/convert-to-label';
 import { install } from '@/utils/install';
 import { tryGitInit } from '@/utils/try-git-init';
@@ -11,18 +10,22 @@ import * as path from 'path';
 import { basename } from 'path';
 import {
  authLoginOAuth,
-  ConfigService,
  detectLocalServer,
  serverStart,
  type ServerStartResult,
 } from 'twenty-sdk/cli';
 import { isDefined } from 'twenty-shared/utils';

+import {
+  type ExampleOptions,
+  type ScaffoldingMode,
+} from '@/types/scaffolding-options';
+
 const CURRENT_EXECUTION_DIRECTORY = process.env.INIT_CWD || process.cwd();

 type CreateAppOptions = {
  directory?: string;
-  example?: string;
+  mode?: ScaffoldingMode;
  name?: string;
  displayName?: string;
  description?: string;
@@ -35,34 +38,23 @@ export class CreateAppCommand {
      await this.getAppInfos(options);

    try {
+      const exampleOptions = this.resolveExampleOptions(
+        options.mode ?? 'minimal',
+      );
+
      await this.validateDirectory(appDirectory);

      this.logCreationInfo({ appDirectory, appName });

      await fs.ensureDir(appDirectory);

-      if (options.example) {
-        const exampleSucceeded = await this.tryDownloadExample(
-          options.example,
-          appDirectory,
-        );
-
-        if (!exampleSucceeded) {
-          await copyBaseApplicationProject({
-            appName,
-            appDisplayName,
-            appDescription,
-            appDirectory,
-          });
-        }
-      } else {
-        await copyBaseApplicationProject({
-          appName,
-          appDisplayName,
-          appDescription,
-          appDirectory,
-        });
-      }
+      await copyBaseApplicationProject({
+        appName,
+        appDisplayName,
+        appDescription,
+        appDirectory,
+        exampleOptions,
+      });

      await install(appDirectory);

@@ -108,14 +100,13 @@ export class CreateAppCommand {
    const hasName = isDefined(options.name) || isDefined(directory);
    const hasDisplayName = isDefined(options.displayName);
    const hasDescription = isDefined(options.description);
-    const hasExample = isDefined(options.example);

    const { name, displayName, description } = await inquirer.prompt([
      {
        type: 'input',
        name: 'name',
        message: 'Application name:',
-        when: () => !hasName && !hasExample,
+        when: () => !hasName,
        default: 'my-twenty-app',
        validate: (input) => {
          if (input.length === 0) return 'Application name is required';
@@ -126,7 +117,7 @@ export class CreateAppCommand {
        type: 'input',
        name: 'displayName',
        message: 'Application display name:',
-        when: () => !hasDisplayName && !hasExample,
+        when: () => !hasDisplayName,
        default: (answers: { name?: string }) => {
          return convertToLabel(
            answers?.name ?? options.name ?? directory ?? '',
@@ -137,7 +128,7 @@ export class CreateAppCommand {
        type: 'input',
        name: 'description',
        message: 'Application description (optional):',
-        when: () => !hasDescription && !hasExample,
+        when: () => !hasDescription,
        default: '',
      },
    ]);
@@ -146,7 +137,6 @@ export class CreateAppCommand {
      options.name ??
      name ??
      directory ??
-      options.example ??
      'my-twenty-app'
    ).trim();

@@ -162,6 +152,34 @@ export class CreateAppCommand {
    return { appName, appDisplayName, appDirectory, appDescription };
  }

+  private resolveExampleOptions(mode: ScaffoldingMode): ExampleOptions {
+    if (mode === 'minimal') {
+      return {
+        includeExampleObject: false,
+        includeExampleField: false,
+        includeExampleLogicFunction: false,
+        includeExampleFrontComponent: false,
+        includeExampleView: false,
+        includeExampleNavigationMenuItem: false,
+        includeExampleSkill: false,
+        includeExampleAgent: false,
+        includeExampleIntegrationTest: true,
+      };
+    }
+
+    return {
+      includeExampleObject: true,
+      includeExampleField: true,
+      includeExampleLogicFunction: true,
+      includeExampleFrontComponent: true,
+      includeExampleView: true,
+      includeExampleNavigationMenuItem: true,
+      includeExampleSkill: true,
+      includeExampleIntegrationTest: true,
+      includeExampleAgent: true,
+    };
+  }
+
  private async validateDirectory(appDirectory: string): Promise<void> {
    if (!(await fs.pathExists(appDirectory))) {
      return;
@@ -175,41 +193,6 @@ export class CreateAppCommand {
    }
  }

-  private async tryDownloadExample(
-    example: string,
-    appDirectory: string,
-  ): Promise<boolean> {
-    try {
-      await downloadExample(example, appDirectory);
-
-      return true;
-    } catch (error) {
-      console.error(
-        chalk.red(
-          `\n${error instanceof Error ? error.message : 'Failed to download example.'}`,
-        ),
-      );
-
-      const { useTemplate } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'useTemplate',
-          message: 'Would you like to create a default template app instead?',
-          default: true,
-        },
-      ]);
-
-      if (!useTemplate) {
-        process.exit(1);
-      }
-
-      // Clean up any partial files from the failed download
-      await fs.emptyDir(appDirectory);
-
-      return false;
-    }
-  }
-
  private logCreationInfo({
    appDirectory,
    appName,
@@ -256,7 +239,7 @@ export class CreateAppCommand {
    if (!shouldAuthenticate) {
      console.log(
        chalk.gray(
-          'Authentication skipped. Run `yarn twenty remote add --local` manually.',
+          'Authentication skipped. Run `yarn twenty remote add` manually.',
        ),
      );

@@ -269,14 +252,10 @@ export class CreateAppCommand {
        remote: 'local',
      });

-      if (result.success) {
-        const configService = new ConfigService();
-
-        await configService.setDefaultRemote('local');
-      } else {
+      if (!result.success) {
        console.log(
          chalk.yellow(
-            'Authentication failed. Run `yarn twenty remote add --local` manually.',
+            'Authentication failed. Run `yarn twenty remote add` manually.',
          ),
        );
      }
@@ -0,0 +1,13 @@
+export type ScaffoldingMode = 'exhaustive' | 'minimal';
+
+export type ExampleOptions = {
+  includeExampleObject: boolean;
+  includeExampleField: boolean;
+  includeExampleLogicFunction: boolean;
+  includeExampleFrontComponent: boolean;
+  includeExampleView: boolean;
+  includeExampleNavigationMenuItem: boolean;
+  includeExampleSkill: boolean;
+  includeExampleAgent: boolean;
+  includeExampleIntegrationTest: boolean;
+};
@@ -0,0 +1,177 @@
+import { scaffoldIntegrationTest } from '@/utils/test-template';
+import * as fs from 'fs-extra';
+import { tmpdir } from 'os';
+import { join } from 'path';
+
+describe('scaffoldIntegrationTest', () => {
+  let testAppDirectory: string;
+  let sourceFolderPath: string;
+
+  beforeEach(async () => {
+    testAppDirectory = join(
+      tmpdir(),
+      `test-twenty-app-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+    );
+    sourceFolderPath = join(testAppDirectory, 'src');
+    await fs.ensureDir(sourceFolderPath);
+
+    await fs.writeJson(join(testAppDirectory, 'tsconfig.json'), {
+      compilerOptions: {
+        paths: { 'src/*': ['./src/*'] },
+      },
+      exclude: ['node_modules', 'dist', '**/*.integration-test.ts'],
+    });
+  });
+
+  afterEach(async () => {
+    if (testAppDirectory && (await fs.pathExists(testAppDirectory))) {
+      await fs.remove(testAppDirectory);
+    }
+  });
+
+  describe('integration test file', () => {
+    it('should create app-install.integration-test.ts with correct structure', async () => {
+      await scaffoldIntegrationTest({
+        appDirectory: testAppDirectory,
+        sourceFolderPath,
+      });
+
+      const testPath = join(
+        sourceFolderPath,
+        '__tests__',
+        'app-install.integration-test.ts',
+      );
+
+      expect(await fs.pathExists(testPath)).toBe(true);
+
+      const content = await fs.readFile(testPath, 'utf8');
+
+      expect(content).toContain(
+        "import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli'",
+      );
+      expect(content).toContain(
+        "import { MetadataApiClient } from 'twenty-client-sdk/metadata'",
+      );
+      expect(content).toContain(
+        "import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config'",
+      );
+      expect(content).toContain('appBuild');
+      expect(content).toContain('appDeploy');
+      expect(content).toContain('appInstall');
+      expect(content).toContain('appUninstall');
+      expect(content).toContain('new MetadataApiClient()');
+      expect(content).toContain('findManyApplications');
+      expect(content).toContain('APPLICATION_UNIVERSAL_IDENTIFIER');
+    });
+  });
+
+  describe('setup-test file', () => {
+    it('should create setup-test.ts with SDK config bootstrap', async () => {
+      await scaffoldIntegrationTest({
+        appDirectory: testAppDirectory,
+        sourceFolderPath,
+      });
+
+      const setupTestPath = join(
+        sourceFolderPath,
+        '__tests__',
+        'setup-test.ts',
+      );
+
+      expect(await fs.pathExists(setupTestPath)).toBe(true);
+
+      const content = await fs.readFile(setupTestPath, 'utf8');
+
+      expect(content).toContain('.twenty-sdk-test');
+      expect(content).toContain('config.json');
+      expect(content).toContain('process.env.TWENTY_API_URL');
+      expect(content).toContain('process.env.TWENTY_API_KEY');
+      expect(content).toContain('assertServerIsReachable');
+    });
+  });
+
+  describe('vitest config', () => {
+    it('should create vitest.config.ts with env vars and setup file', async () => {
+      await scaffoldIntegrationTest({
+        appDirectory: testAppDirectory,
+        sourceFolderPath,
+      });
+
+      const vitestConfigPath = join(testAppDirectory, 'vitest.config.ts');
+
+      expect(await fs.pathExists(vitestConfigPath)).toBe(true);
+
+      const content = await fs.readFile(vitestConfigPath, 'utf8');
+
+      expect(content).toContain('TWENTY_API_KEY');
+      expect(content).not.toContain('TWENTY_TEST_API_KEY');
+      expect(content).toContain('setup-test.ts');
+      expect(content).toContain('tsconfig.spec.json');
+      expect(content).toContain('integration-test.ts');
+    });
+  });
+
+  describe('github workflow', () => {
+    it('should create .github/workflows/ci.yml with correct structure', async () => {
+      await scaffoldIntegrationTest({
+        appDirectory: testAppDirectory,
+        sourceFolderPath,
+      });
+
+      const workflowPath = join(
+        testAppDirectory,
+        '.github',
+        'workflows',
+        'ci.yml',
+      );
+
+      expect(await fs.pathExists(workflowPath)).toBe(true);
+
+      const content = await fs.readFile(workflowPath, 'utf8');
+
+      expect(content).toContain('name: CI');
+      expect(content).toContain('TWENTY_VERSION: latest');
+      expect(content).toContain('twenty-version: ${{ env.TWENTY_VERSION }}');
+      expect(content).toContain('actions/checkout@v4');
+      expect(content).toContain('spawn-twenty-docker-image@main');
+      expect(content).toContain('actions/setup-node@v4');
+      expect(content).toContain('yarn install --immutable');
+      expect(content).toContain('yarn test');
+      expect(content).toContain('TWENTY_API_URL');
+      expect(content).toContain('TWENTY_API_KEY');
+    });
+  });
+
+  describe('tsconfig.spec.json', () => {
+    it('should create tsconfig.spec.json extending the base tsconfig', async () => {
+      await scaffoldIntegrationTest({
+        appDirectory: testAppDirectory,
+        sourceFolderPath,
+      });
+
+      const tsconfigSpecPath = join(testAppDirectory, 'tsconfig.spec.json');
+
+      expect(await fs.pathExists(tsconfigSpecPath)).toBe(true);
+
+      const tsconfigSpec = await fs.readJson(tsconfigSpecPath);
+
+      expect(tsconfigSpec.extends).toBe('./tsconfig.json');
+      expect(tsconfigSpec.compilerOptions.composite).toBe(true);
+      expect(tsconfigSpec.include).toContain('src/**/*.ts');
+      expect(tsconfigSpec.exclude).not.toContain('**/*.integration-test.ts');
+    });
+
+    it('should add a reference to tsconfig.spec.json in tsconfig.json', async () => {
+      await scaffoldIntegrationTest({
+        appDirectory: testAppDirectory,
+        sourceFolderPath,
+      });
+
+      const tsconfig = await fs.readJson(
+        join(testAppDirectory, 'tsconfig.json'),
+      );
+
+      expect(tsconfig.references).toEqual([{ path: './tsconfig.spec.json' }]);
+    });
+  });
+});
@@ -1,9 +1,11 @@
 import * as fs from 'fs-extra';
 import { join } from 'path';
+import { ASSETS_DIR } from 'twenty-shared/application';
 import { v4 } from 'uuid';

+import { type ExampleOptions } from '@/types/scaffolding-options';
+import { scaffoldIntegrationTest } from '@/utils/test-template';
 import createTwentyAppPackageJson from 'package.json';
-import chalk from 'chalk';

 const SRC_FOLDER = 'src';

@@ -12,77 +14,795 @@ export const copyBaseApplicationProject = async ({
  appDisplayName,
  appDescription,
  appDirectory,
+  exampleOptions,
 }: {
  appName: string;
  appDisplayName: string;
  appDescription: string;
  appDirectory: string;
+  exampleOptions: ExampleOptions;
 }) => {
-  console.log(chalk.gray('Generating application project...'));
-  await fs.copy(join(__dirname, './constants/template'), appDirectory);
+  await fs.copy(join(__dirname, './constants/base-application'), appDirectory);

-  await renameGitignore({ appDirectory });
-
-  await generateUniversalIdentifiers({
-    appDisplayName,
-    appDescription,
+  await createPackageJson({
+    appName,
    appDirectory,
+    includeExampleIntegrationTest: exampleOptions.includeExampleIntegrationTest,
  });

-  await updatePackageJson({ appName, appDirectory });
-};
+  await createYarnLock(appDirectory);

-const renameGitignore = async ({ appDirectory }: { appDirectory: string }) => {
-  const gitignorePath = join(appDirectory, 'gitignore');
+  await createGitignore(appDirectory);

-  if (await fs.pathExists(gitignorePath)) {
-    await fs.rename(gitignorePath, join(appDirectory, '.gitignore'));
+  await createNvmrc(appDirectory);
+
+  await createPublicAssetDirectory(appDirectory);
+
+  const sourceFolderPath = join(appDirectory, SRC_FOLDER);
+
+  await fs.ensureDir(sourceFolderPath);
+
+  await createDefaultRoleConfig({
+    displayName: appDisplayName,
+    appDirectory: sourceFolderPath,
+    fileFolder: 'roles',
+    fileName: 'default-role.ts',
+  });
+
+  if (exampleOptions.includeExampleObject) {
+    await createExampleObject({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'objects',
+      fileName: 'example-object.ts',
+    });
  }
+
+  if (exampleOptions.includeExampleField) {
+    await createExampleField({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'fields',
+      fileName: 'example-field.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleLogicFunction) {
+    await createDefaultFunction({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'logic-functions',
+      fileName: 'hello-world.ts',
+    });
+
+    await createCreateCompanyFunction({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'logic-functions',
+      fileName: 'create-hello-world-company.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleFrontComponent) {
+    await createDefaultFrontComponent({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'front-components',
+      fileName: 'hello-world.tsx',
+    });
+
+    await createExamplePageLayout({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'page-layouts',
+      fileName: 'example-record-page-layout.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleView) {
+    await createExampleView({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'views',
+      fileName: 'example-view.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleNavigationMenuItem) {
+    await createExampleNavigationMenuItem({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'navigation-menu-items',
+      fileName: 'example-navigation-menu-item.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleSkill) {
+    await createExampleSkill({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'skills',
+      fileName: 'example-skill.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleAgent) {
+    await createExampleAgent({
+      appDirectory: sourceFolderPath,
+      fileFolder: 'agents',
+      fileName: 'example-agent.ts',
+    });
+  }
+
+  if (exampleOptions.includeExampleIntegrationTest) {
+    await scaffoldIntegrationTest({
+      appDirectory,
+      sourceFolderPath,
+    });
+  }
+
+  await createDefaultPreInstallFunction({
+    appDirectory: sourceFolderPath,
+    fileFolder: 'logic-functions',
+    fileName: 'pre-install.ts',
+  });
+
+  await createDefaultPostInstallFunction({
+    appDirectory: sourceFolderPath,
+    fileFolder: 'logic-functions',
+    fileName: 'post-install.ts',
+  });
+
+  await createApplicationConfig({
+    displayName: appDisplayName,
+    description: appDescription,
+    appDirectory: sourceFolderPath,
+    fileName: 'application-config.ts',
+  });
 };

-const generateUniversalIdentifiers = async ({
-  appDisplayName,
-  appDescription,
+const createPublicAssetDirectory = async (appDirectory: string) => {
+  await fs.ensureDir(join(appDirectory, ASSETS_DIR));
+};
+
+const createGitignore = async (appDirectory: string) => {
+  const gitignoreContent = `# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn
+
+# codegen
+generated
+
+# testing
+/coverage
+
+# dev
+/dist/
+
+.twenty
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# typescript
+*.tsbuildinfo
+*.d.ts
+`;
+
+  await fs.writeFile(join(appDirectory, '.gitignore'), gitignoreContent);
+};
+
+const createNvmrc = async (appDirectory: string) => {
+  await fs.writeFile(join(appDirectory, '.nvmrc'), '24.5.0\n');
+};
+
+const createDefaultRoleConfig = async ({
+  displayName,
  appDirectory,
+  fileFolder,
+  fileName,
 }: {
-  appDisplayName: string;
-  appDescription: string;
+  displayName: string;
  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
 }) => {
-  const universalIdentifiersPath = join(
-    appDirectory,
-    SRC_FOLDER,
-    'constants',
-    'universal-identifiers.ts',
-  );
+  const universalIdentifier = v4();

-  const universalIdentifiersFileContent = await fs.readFile(
-    universalIdentifiersPath,
-    'utf-8',
-  );
+  const content = `import { defineRole } from 'twenty-sdk';

-  await fs.writeFile(
-    universalIdentifiersPath,
-    universalIdentifiersFileContent
-      .replace('DISPLAY-NAME-TO-BE-GENERATED', appDisplayName)
-      .replace('DESCRIPTION-TO-BE-GENERATED', appDescription)
-      .replace(/UUID-TO-BE-GENERATED/g, () => v4()),
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+  '${universalIdentifier}';
+
+export default defineRole({
+  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  label: '${displayName} default function role',
+  description: '${displayName} default function role',
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: true,
+  canDestroyAllObjectRecords: false,
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createDefaultFrontComponent = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { useEffect, useState } from 'react';
+import { CoreApiClient, CoreSchema } from 'twenty-client-sdk/core';
+import { defineFrontComponent } from 'twenty-sdk';
+
+export const HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER =
+  '${universalIdentifier}';
+
+export const HelloWorld = () => {
+  const client = new CoreApiClient();
+  const [data, setData] = useState<
+    Pick<CoreSchema.Company, 'name' | 'id'> | undefined
+  >(undefined);
+
+  useEffect(() => {
+    const fetchData = async () => {
+      const response = await client.query({
+        company: {
+          name: true,
+          id: true,
+          __args: {
+            filter: {
+              position: {
+                eq: 1,
+              },
+            },
+          },
+        },
+      });
+
+      setData(response.company);
+    };
+
+    fetchData();
+  }, []);
+
+  return (
+    <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
+      <h1>Hello, World!</h1>
+      <p>This is your first front component.</p>
+      {data ? (
+        <div>
+          <p>Company name: {data.name}</p>
+          <p>Company id: {data.id}</p>
+        </div>
+      ) : (
+        <p>Company not found</p>
+      )}
+    </div>
  );
 };

-const updatePackageJson = async ({
+export default defineFrontComponent({
+  universalIdentifier: HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+  name: 'hello-world-front-component',
+  description: 'A sample front component',
+  component: HelloWorld,
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExamplePageLayout = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const pageLayoutUniversalIdentifier = v4();
+  const tabUniversalIdentifier = v4();
+  const widgetUniversalIdentifier = v4();
+
+  const content = `import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from 'src/objects/example-object';
+import { HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from 'src/front-components/hello-world';
+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk';
+
+export default definePageLayout({
+  universalIdentifier: '${pageLayoutUniversalIdentifier}',
+  name: 'Example Record Page',
+  type: 'RECORD_PAGE',
+  objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+  tabs: [
+    {
+      universalIdentifier: '${tabUniversalIdentifier}',
+      title: 'Hello World',
+      position: 50,
+      icon: 'IconWorld',
+      layoutMode: PageLayoutTabLayoutMode.CANVAS,
+      widgets: [
+        {
+          universalIdentifier: '${widgetUniversalIdentifier}',
+          title: 'Hello World',
+          type: 'FRONT_COMPONENT',
+          configuration: {
+            configurationType: 'FRONT_COMPONENT',
+            frontComponentUniversalIdentifier:
+              HELLO_WORLD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+          },
+        },
+      ],
+    },
+  ],
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createDefaultFunction = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { defineLogicFunction } from 'twenty-sdk';
+
+const handler = async (): Promise<{ message: string }> => {
+  return { message: 'Hello, World!' };
+};
+
+export default defineLogicFunction({
+  universalIdentifier: '${universalIdentifier}',
+  name: 'hello-world-logic-function',
+  description: 'A simple logic function',
+  timeoutSeconds: 5,
+  handler,
+  httpRouteTriggerSettings: {
+    path: '/hello-world-logic-function',
+    httpMethod: 'GET',
+    isAuthRequired: false,
+  },
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createCreateCompanyFunction = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { CoreApiClient } from 'twenty-client-sdk/core';
+import { defineLogicFunction } from 'twenty-sdk';
+
+const handler = async (): Promise<{ message: string }> => {
+  const client = new CoreApiClient();
+
+  const { createCompany } = await client.mutation({
+    createCompany: {
+      __args: {
+        data: {
+          name: 'Hello World',
+        },
+      },
+      id: true,
+      name: true,
+    },
+  });
+
+  if (!createCompany?.id || !createCompany?.name) {
+    throw new Error('Failed to create company: missing id or name in response');
+  }
+
+  return {
+    message: \`Created company "\${createCompany.name}" with id \${createCompany.id}\`,
+  };
+};
+
+export default defineLogicFunction({
+  universalIdentifier: '${universalIdentifier}',
+  name: 'create-hello-world-company',
+  description: 'Creates a company called Hello World',
+  timeoutSeconds: 5,
+  handler,
+  httpRouteTriggerSettings: {
+    path: '/create-hello-world-company',
+    httpMethod: 'POST',
+    isAuthRequired: true,
+  },
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createDefaultPreInstallFunction = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { definePreInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+
+const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
+  console.log('Pre install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePreInstallLogicFunction({
+  universalIdentifier: '${universalIdentifier}',
+  name: 'pre-install',
+  description: 'Runs before installation to prepare the application.',
+  timeoutSeconds: 300,
+  handler,
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createDefaultPostInstallFunction = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+
+const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
+  console.log('Post install logic function executed successfully!', payload.previousVersion);
+};
+
+export default definePostInstallLogicFunction({
+  universalIdentifier: '${universalIdentifier}',
+  name: 'post-install',
+  description: 'Runs after installation to set up the application.',
+  timeoutSeconds: 300,
+  handler,
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExampleObject = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const objectUniversalIdentifier = v4();
+  const nameFieldUniversalIdentifier = v4();
+
+  const content = `import { defineObject, FieldType } from 'twenty-sdk';
+
+export const EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER =
+  '${objectUniversalIdentifier}';
+
+export const NAME_FIELD_UNIVERSAL_IDENTIFIER =
+  '${nameFieldUniversalIdentifier}';
+
+export default defineObject({
+  universalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+  nameSingular: 'exampleItem',
+  namePlural: 'exampleItems',
+  labelSingular: 'Example item',
+  labelPlural: 'Example items',
+  description: 'A sample custom object',
+  icon: 'IconBox',
+  labelIdentifierFieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+  fields: [
+    {
+      universalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+      type: FieldType.TEXT,
+      name: 'name',
+      label: 'Name',
+      description: 'Name of the example item',
+      icon: 'IconAbc',
+    },
+  ],
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExampleField = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { defineField, FieldType } from 'twenty-sdk';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from 'src/objects/example-object';
+
+export default defineField({
+  objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+  universalIdentifier: '${universalIdentifier}',
+  type: FieldType.NUMBER,
+  name: 'priority',
+  label: 'Priority',
+  description: 'Priority level for the example item (1-10)',
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExampleView = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+  const viewFieldUniversalIdentifier = v4();
+
+  const content = `import { defineView, ViewKey } from 'twenty-sdk';
+import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER, NAME_FIELD_UNIVERSAL_IDENTIFIER } from 'src/objects/example-object';
+
+export const EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER = '${universalIdentifier}';
+
+export default defineView({
+  universalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+  name: 'All example items',
+  objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,
+  icon: 'IconList',
+  key: ViewKey.INDEX,
+  position: 0,
+  fields: [
+    {
+      universalIdentifier: '${viewFieldUniversalIdentifier}',
+      fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+      position: 0,
+      isVisible: true,
+      size: 200,
+    },
+  ],
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExampleNavigationMenuItem = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { defineNavigationMenuItem } from 'twenty-sdk';
+import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from 'src/views/example-view';
+
+export default defineNavigationMenuItem({
+  universalIdentifier: '${universalIdentifier}',
+  name: 'example-navigation-menu-item',
+  icon: 'IconList',
+  color: 'blue',
+  position: 0,
+  type: 'VIEW',
+  viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExampleSkill = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { defineSkill } from 'twenty-sdk';
+
+export const EXAMPLE_SKILL_UNIVERSAL_IDENTIFIER =
+  '${universalIdentifier}';
+
+export default defineSkill({
+  universalIdentifier: EXAMPLE_SKILL_UNIVERSAL_IDENTIFIER,
+  name: 'example-skill',
+  label: 'Example Skill',
+  description: 'A sample skill for your application',
+  icon: 'IconBrain',
+  content: 'Add your skill instructions here. Skills provide context and capabilities to AI agents.',
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createExampleAgent = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { defineAgent } from 'twenty-sdk';
+
+export const EXAMPLE_AGENT_UNIVERSAL_IDENTIFIER =
+  '${universalIdentifier}';
+
+export default defineAgent({
+  universalIdentifier: EXAMPLE_AGENT_UNIVERSAL_IDENTIFIER,
+  name: 'example-agent',
+  label: 'Example Agent',
+  description: 'A sample AI agent for your application',
+  icon: 'IconRobot',
+  prompt: 'You are a helpful assistant. Help users with their questions and tasks.',
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createApplicationConfig = async ({
+  displayName,
+  description,
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  displayName: string;
+  description?: string;
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const universalIdentifier = v4();
+
+  const content = `import { defineApplication } from 'twenty-sdk';
+import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+
+export const APPLICATION_UNIVERSAL_IDENTIFIER =
+  '${universalIdentifier}';
+
+export default defineApplication({
+  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
+  displayName: '${displayName}',
+  description: '${description ?? ''}',
+  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createYarnLock = async (appDirectory: string) => {
+  const yarnLockContent = `# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+`;
+
+  await fs.writeFile(join(appDirectory, 'yarn.lock'), yarnLockContent);
+};
+
+const createPackageJson = async ({
  appName,
  appDirectory,
+  includeExampleIntegrationTest,
 }: {
  appName: string;
  appDirectory: string;
+  includeExampleIntegrationTest: boolean;
 }) => {
-  const packageJson = await fs.readJson(join(appDirectory, 'package.json'));
+  const scripts: Record<string, string> = {
+    twenty: 'twenty',
+    lint: 'oxlint -c .oxlintrc.json .',
+    'lint:fix': 'oxlint --fix -c .oxlintrc.json .',
+  };

-  packageJson.name = appName;
-  packageJson.dependencies['twenty-sdk'] = createTwentyAppPackageJson.version;
-  packageJson.dependencies['twenty-client-sdk'] =
-    createTwentyAppPackageJson.version;
+  const devDependencies: Record<string, string> = {
+    typescript: '^5.9.3',
+    '@types/node': '^24.7.2',
+    '@types/react': '^19.0.0',
+    react: '^19.0.0',
+    'react-dom': '^19.0.0',
+    oxlint: '^0.16.0',
+    'twenty-sdk': createTwentyAppPackageJson.version,
+    'twenty-client-sdk': createTwentyAppPackageJson.version,
+  };
+
+  if (includeExampleIntegrationTest) {
+    scripts.test = 'vitest run';
+    scripts['test:watch'] = 'vitest';
+    devDependencies.vitest = '^3.1.1';
+    devDependencies['vite-tsconfig-paths'] = '^4.2.1';
+  }
+
+  const packageJson = {
+    name: appName,
+    version: '0.1.0',
+    license: 'MIT',
+    engines: {
+      node: '^24.5.0',
+      npm: 'please-use-yarn',
+      yarn: '>=4.0.2',
+    },
+    keywords: ['twenty-app'],
+    packageManager: '[email protected]',
+    scripts,
+    devDependencies,
+  };

  await fs.writeFile(
    join(appDirectory, 'package.json'),
@@ -1,179 +0,0 @@
-import { execSync } from 'node:child_process';
-import * as fs from 'fs-extra';
-import { join } from 'path';
-import { tmpdir } from 'node:os';
-import chalk from 'chalk';
-
-const TWENTY_REPO_OWNER = 'twentyhq';
-const TWENTY_REPO_NAME = 'twenty';
-const TWENTY_FALLBACK_REF = 'main';
-const TWENTY_EXAMPLES_PATH = 'packages/twenty-apps/examples';
-const TWENTY_EXAMPLES_URL = `https://github.com/${TWENTY_REPO_OWNER}/${TWENTY_REPO_NAME}/tree/${TWENTY_FALLBACK_REF}/${TWENTY_EXAMPLES_PATH}`;
-
-// Fetches the latest release tag from the repo, or falls back to main
-const resolveRef = async (): Promise<string> => {
-  const response = await fetch(
-    `https://api.github.com/repos/${TWENTY_REPO_OWNER}/${TWENTY_REPO_NAME}/releases/latest`,
-    { headers: { Accept: 'application/vnd.github.v3+json' } },
-  );
-
-  if (response.ok) {
-    const release = (await response.json()) as { tag_name: string };
-
-    return release.tag_name;
-  }
-
-  return TWENTY_FALLBACK_REF;
-};
-
-// Uses the GitHub Contents API to list directories — fast and doesn't download the repo
-const fetchGitHubDirectoryContents = async (
-  path: string,
-  ref: string,
-): Promise<{ name: string; type: string }[] | null> => {
-  const apiUrl = `https://api.github.com/repos/${TWENTY_REPO_OWNER}/${TWENTY_REPO_NAME}/contents/${path}?ref=${ref}`;
-
-  const response = await fetch(apiUrl, {
-    headers: { Accept: 'application/vnd.github.v3+json' },
-  });
-
-  if (!response.ok) {
-    return null;
-  }
-
-  const data = await response.json();
-
-  if (!Array.isArray(data)) {
-    return null;
-  }
-
-  return data as { name: string; type: string }[];
-};
-
-const listAvailableExamples = async (ref: string): Promise<string[]> => {
-  const contents = await fetchGitHubDirectoryContents(
-    TWENTY_EXAMPLES_PATH,
-    ref,
-  );
-
-  if (!contents) {
-    return [];
-  }
-
-  return contents
-    .filter((entry) => entry.type === 'dir')
-    .map((entry) => entry.name);
-};
-
-const validateExampleExists = async (
-  exampleName: string,
-  ref: string,
-): Promise<void> => {
-  const examplePath = `${TWENTY_EXAMPLES_PATH}/${exampleName}`;
-
-  const contents = await fetchGitHubDirectoryContents(examplePath, ref);
-
-  if (contents !== null) {
-    return;
-  }
-
-  const availableExamples = await listAvailableExamples(ref);
-
-  throw new Error(
-    `Example "${exampleName}" not found.\n\n` +
-      (availableExamples.length > 0
-        ? `Available examples:\n${availableExamples.map((name) => `  - ${name}`).join('\n')}\n\n`
-        : '') +
-      `Browse all examples: ${TWENTY_EXAMPLES_URL}`,
-  );
-};
-
-export const downloadExample = async (
-  exampleName: string,
-  targetDirectory: string,
-): Promise<void> => {
-  if (
-    exampleName.includes('/') ||
-    exampleName.includes('\\') ||
-    exampleName.includes('..')
-  ) {
-    throw new Error(
-      `Invalid example name: "${exampleName}". Example names must be simple directory names (e.g., "hello-world").`,
-    );
-  }
-
-  const ref = await resolveRef();
-  const examplePath = `${TWENTY_EXAMPLES_PATH}/${exampleName}`;
-
-  console.log(chalk.gray(`Resolving examples from ref '${ref}'...`));
-
-  await validateExampleExists(exampleName, ref);
-
-  console.log(chalk.gray(`Example '${examplePath}' validated successfully.`));
-
-  const tarballUrl = `https://codeload.github.com/${TWENTY_REPO_OWNER}/${TWENTY_REPO_NAME}/tar.gz/${ref}`;
-
-  const tempDir = join(
-    tmpdir(),
-    `create-twenty-app-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-  );
-
-  try {
-    await fs.ensureDir(tempDir);
-
-    console.log(chalk.gray(`Downloading tarball from ${tarballUrl}...`));
-
-    const response = await fetch(tarballUrl);
-
-    if (!response.ok) {
-      if (response.status === 404) {
-        throw new Error(
-          `Could not find repository: ${TWENTY_REPO_OWNER}/${TWENTY_REPO_NAME} (ref: ${ref})`,
-        );
-      }
-      throw new Error(
-        `Failed to download from GitHub: ${response.status} ${response.statusText}`,
-      );
-    }
-
-    console.log(chalk.gray('Tarball downloaded. Writing to disk...'));
-
-    const tarballPath = join(tempDir, 'archive.tar.gz');
-
-    const buffer = Buffer.from(await response.arrayBuffer());
-
-    await fs.writeFile(tarballPath, buffer);
-
-    console.log(
-      chalk.gray(
-        `Tarball saved (${(buffer.length / 1024 / 1024).toFixed(1)} MB). Extracting...`,
-      ),
-    );
-
-    execSync(`tar xzf "${tarballPath}" -C "${tempDir}"`, {
-      stdio: 'pipe',
-    });
-
-    // GitHub tarballs extract to a directory named {repo}-{ref}/
-    const extractedEntries = await fs.readdir(tempDir);
-    const extractedDir = extractedEntries.find(
-      (entry) => entry !== 'archive.tar.gz',
-    );
-
-    if (!extractedDir) {
-      throw new Error('Failed to extract archive: no directory found');
-    }
-
-    const sourcePath = join(tempDir, extractedDir, examplePath);
-
-    if (!(await fs.pathExists(sourcePath))) {
-      throw new Error(
-        `Example directory not found in archive: "${examplePath}"`,
-      );
-    }
-
-    await fs.copy(sourcePath, targetDirectory);
-  } finally {
-    await fs.remove(tempDir);
-  }
-};
@@ -0,0 +1,279 @@
+import * as fs from 'fs-extra';
+import { join } from 'path';
+
+const SEED_API_KEY =
+  'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik';
+
+export const scaffoldIntegrationTest = async ({
+  appDirectory,
+  sourceFolderPath,
+}: {
+  appDirectory: string;
+  sourceFolderPath: string;
+}) => {
+  await createIntegrationTest({
+    appDirectory: sourceFolderPath,
+    fileFolder: '__tests__',
+    fileName: 'app-install.integration-test.ts',
+  });
+
+  await createSetupTest({
+    appDirectory: sourceFolderPath,
+    fileFolder: '__tests__',
+    fileName: 'setup-test.ts',
+  });
+
+  await createVitestConfig(appDirectory);
+  await createTsconfigSpec(appDirectory);
+  await createGithubWorkflow(appDirectory);
+};
+
+const createVitestConfig = async (appDirectory: string) => {
+  const content = `import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  plugins: [
+    tsconfigPaths({
+      projects: ['tsconfig.spec.json'],
+      ignoreConfigErrors: true,
+    }),
+  ],
+  test: {
+    testTimeout: 120_000,
+    hookTimeout: 120_000,
+    include: ['src/**/*.integration-test.ts'],
+    setupFiles: ['src/__tests__/setup-test.ts'],
+    env: {
+      TWENTY_API_KEY:
+        '${SEED_API_KEY}',
+    },
+  },
+});
+`;
+
+  await fs.writeFile(join(appDirectory, 'vitest.config.ts'), content);
+};
+
+const createTsconfigSpec = async (appDirectory: string) => {
+  const tsconfigSpec = {
+    extends: './tsconfig.json',
+    compilerOptions: {
+      composite: true,
+      types: ['vitest/globals'],
+    },
+    include: ['src/**/*.ts', 'src/**/*.tsx'],
+    exclude: ['node_modules', 'dist'],
+  };
+
+  await fs.writeFile(
+    join(appDirectory, 'tsconfig.spec.json'),
+    JSON.stringify(tsconfigSpec, null, 2),
+  );
+
+  const tsconfigPath = join(appDirectory, 'tsconfig.json');
+  const tsconfig = await fs.readJson(tsconfigPath);
+
+  tsconfig.references = [{ path: './tsconfig.spec.json' }];
+
+  await fs.writeFile(tsconfigPath, JSON.stringify(tsconfig, null, 2));
+};
+
+const createSetupTest = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const content = `import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+const assertServerIsReachable = async () => {
+  let response: Response;
+
+  try {
+    response = await fetch(\`\${TWENTY_API_URL}/healthz\`);
+  } catch {
+    throw new Error(
+      \`Twenty server is not reachable at \${TWENTY_API_URL}. \` +
+        'Make sure the server is running before executing integration tests.',
+    );
+  }
+
+  if (!response.ok) {
+    throw new Error(\`Server at \${TWENTY_API_URL} returned \${response.status}\`);
+  }
+};
+
+beforeAll(async () => {
+  await assertServerIsReachable();
+
+  fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+  const configFile = {
+    remotes: {
+      local: {
+        apiUrl: process.env.TWENTY_API_URL,
+        apiKey: process.env.TWENTY_API_KEY,
+      },
+    },
+    defaultRemote: 'local',
+  };
+
+  fs.writeFileSync(
+    path.join(TEST_CONFIG_DIR, 'config.json'),
+    JSON.stringify(configFile, null, 2),
+  );
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const createIntegrationTest = async ({
+  appDirectory,
+  fileFolder,
+  fileName,
+}: {
+  appDirectory: string;
+  fileFolder?: string;
+  fileName: string;
+}) => {
+  const content = `import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application-config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+  beforeAll(async () => {
+    const buildResult = await appBuild({
+      appPath: APP_PATH,
+      tarball: true,
+      onProgress: (message: string) => console.log(\`[build] \${message}\`),
+    });
+
+    if (!buildResult.success) {
+      throw new Error(
+        \`Build failed: \${buildResult.error?.message ?? 'Unknown error'}\`,
+      );
+    }
+
+    const deployResult = await appDeploy({
+      tarballPath: buildResult.data.tarballPath!,
+      onProgress: (message: string) => console.log(\`[deploy] \${message}\`),
+    });
+
+    if (!deployResult.success) {
+      throw new Error(
+        \`Deploy failed: \${deployResult.error?.message ?? 'Unknown error'}\`,
+      );
+    }
+
+    const installResult = await appInstall({ appPath: APP_PATH });
+
+    if (!installResult.success) {
+      throw new Error(
+        \`Install failed: \${installResult.error?.message ?? 'Unknown error'}\`,
+      );
+    }
+  });
+
+  afterAll(async () => {
+    const uninstallResult = await appUninstall({ appPath: APP_PATH });
+
+    if (!uninstallResult.success) {
+      console.warn(
+        \`App uninstall failed: \${uninstallResult.error?.message ?? 'Unknown error'}\`,
+      );
+    }
+  });
+
+  it('should find the installed app in the applications list', async () => {
+    const metadataClient = new MetadataApiClient();
+
+    const result = await metadataClient.query({
+      findManyApplications: {
+        id: true,
+        name: true,
+        universalIdentifier: true,
+      },
+    });
+
+    const installedApp = result.findManyApplications.find(
+      (application: { universalIdentifier: string }) =>
+        application.universalIdentifier ===
+        APPLICATION_UNIVERSAL_IDENTIFIER,
+    );
+
+    expect(installedApp).toBeDefined();
+  });
+});
+`;
+
+  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
+  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+};
+
+const DEFAULT_TWENTY_VERSION = 'latest';
+
+const createGithubWorkflow = async (appDirectory: string) => {
+  const content = `name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+env:
+  TWENTY_VERSION: ${DEFAULT_TWENTY_VERSION}
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Spawn Twenty instance
+        id: twenty
+        uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+        with:
+          twenty-version: \${{ env.TWENTY_VERSION }}
+          github-token: \${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Run integration tests
+        run: yarn test
+        env:
+          TWENTY_API_URL: \${{ steps.twenty.outputs.server-url }}
+          TWENTY_API_KEY: \${{ steps.twenty.outputs.access-token }}
+`;
+
+  const workflowDir = join(appDirectory, '.github', 'workflows');
+
+  await fs.ensureDir(workflowDir);
+  await fs.writeFile(join(workflowDir, 'ci.yml'), content);
+};
@@ -24,9 +24,5 @@
    "vite.config.ts",
    "jest.config.mjs"
  ],
-  "exclude": [
-    "src/constants/template/vitest.config.ts",
-    "src/constants/template/src/**",
-    "src/constants/template/tsconfig.spec.json"
-  ]
+  "exclude": ["src/constants/base-application/vitest.config.ts"]
 }
@@ -18,9 +18,6 @@
    "dist",
    "**/*.test.ts",
    "**/*.spec.ts",
-    "**/__tests__/**",
-    "src/constants/template/src/**",
-    "src/constants/template/vitest.config.ts",
-    "src/constants/template/tsconfig.spec.json"
+    "**/__tests__/**"
  ]
 }
@@ -62,8 +62,8 @@ export default defineConfig(() => {
      dts({ entryRoot: './src', tsconfigPath: tsConfigPath }),
      copyAssetPlugin([
        {
-          src: 'src/constants/template',
-          dest: 'dist/constants/template',
+          src: 'src/constants/base-application',
+          dest: 'dist/constants/base-application',
        },
      ]),
    ],
@@ -1,7 +1,7 @@
 ## Base documentation

 - Documentation: https://docs.twenty.com/developers/extend/capabilities/apps
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/postcard-app

 ## UUID requirement
 - All generated UUIDs must be valid UUID v4.
@@ -1,42 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - main
-  pull_request: {}
-
-env:
-  TWENTY_VERSION: latest
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Spawn Twenty instance
-        id: twenty
-        uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
-        with:
-          twenty-version: ${{ env.TWENTY_VERSION }}
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Enable Corepack
-        run: corepack enable
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-
-      - name: Install dependencies
-        run: yarn install --immutable
-
-      - name: Run integration tests
-        run: yarn test
-        env:
-          TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
-          TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
@@ -1,14 +0,0 @@
-## Base documentation
-
- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
-
-## UUID requirement
-
- All generated UUIDs must be valid UUID v4.
-
-## Common Pitfalls
-
- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -1,42 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - main
-  pull_request: {}
-
-env:
-  TWENTY_VERSION: latest
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Spawn Twenty instance
-        id: twenty
-        uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
-        with:
-          twenty-version: ${{ env.TWENTY_VERSION }}
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Enable Corepack
-        run: corepack enable
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-
-      - name: Install dependencies
-        run: yarn install --immutable
-
-      - name: Run integration tests
-        run: yarn test
-        env:
-          TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
-          TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
@@ -1,38 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.*
-.yarn
-
-# codegen
-generated
-
-# testing
-/coverage
-
-# dev
-/dist/
-
-.twenty
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# env files (can opt-in for committing if needed)
-.env*
-
-# typescript
-*.tsbuildinfo
-*.d.ts
@@ -1 +0,0 @@
-24.5.0
@@ -1 +0,0 @@
-nodeLinker: node-modules
@@ -1,14 +0,0 @@
-## Base documentation
-
- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
-
-## UUID requirement
-
- All generated UUIDs must be valid UUID v4.
-
-## Common Pitfalls
-
- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -1,14 +0,0 @@
-## Base documentation
-
- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
-
-## UUID requirement
-
- All generated UUIDs must be valid UUID v4.
-
-## Common Pitfalls
-
- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -1,42 +0,0 @@
-# Postcard App — Twenty App Example
-
-A rich example app showcasing all Twenty app entity types. Use this as a reference when building your own apps.
-
-## What's included
-
-This app demonstrates every entity type available in the Twenty SDK:
-
-| Entity | Files | What it shows |
-|--------|-------|---------------|
-| **Application** | `src/application.config.ts` | App metadata, application variables, server variables |
-| **Objects** | `src/objects/` | Custom objects with inline fields, junction tables |
-| **Fields** | `src/fields/` | Standalone fields, relations (ONE_TO_MANY, MANY_TO_ONE), extending standard objects |
-| **Logic Functions** | `src/logic-functions/` | HTTP routes, database event triggers, cron schedules, tool functions, install hooks |
-| **Front Components** | `src/components/` | React components rendered inside Twenty's UI |
-| **Roles** | `src/roles/` | Permission roles with object and field-level access control |
-| **Views** | `src/views/` | Saved table views with column configuration |
-| **Navigation** | `src/navigation-menu-items/` | Sidebar links targeting views |
-| **Skills** | `src/skills/` | AI skill providing context to agents |
-| **Agents** | `src/agents/` | AI agent with a system prompt |
-| **Page Layouts** | `src/page-layouts/` | Custom record page with a front component widget |
-
-## Getting started
-
-```bash
-# From this directory
-yarn install
-yarn twenty dev
-```
-
-Or use it as a template via create-twenty-app:
-
-```bash
-npx create-twenty-app@latest my-app --example postcard
-```
-
-## Learn more
-
- [Getting Started](https://docs.twenty.com/developers/extend/apps/getting-started)
- [Building Apps](https://docs.twenty.com/developers/extend/apps/building)
- [Publishing](https://docs.twenty.com/developers/extend/apps/publishing)
- [Discord](https://discord.gg/cx5n4Jzs57)
@@ -1,35 +0,0 @@
-{
-  "name": "postcard",
-  "version": "0.1.0",
-  "license": "MIT",
-  "engines": {
-    "node": "^24.5.0",
-    "npm": "please-use-yarn",
-    "yarn": ">=4.0.2"
-  },
-  "keywords": [
-    "twenty-app"
-  ],
-  "packageManager": "[email protected]",
-  "scripts": {
-    "twenty": "twenty",
-    "lint": "oxlint -c .oxlintrc.json .",
-    "lint:fix": "oxlint --fix -c .oxlintrc.json .",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "twenty-client-sdk": "0.8.0-canary.8",
-    "twenty-sdk": "0.8.0-canary.8"
-  },
-  "devDependencies": {
-    "@types/node": "^24.7.2",
-    "@types/react": "^19.0.0",
-    "oxlint": "^0.16.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^4.2.1",
-    "vitest": "^3.1.1"
-  }
-}
@@ -1,70 +0,0 @@
-import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application.config';
-import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
-import { MetadataApiClient } from 'twenty-client-sdk/metadata';
-import { afterAll, beforeAll, describe, expect, it } from 'vitest';
-
-const APP_PATH = process.cwd();
-
-describe('App installation', () => {
-  beforeAll(async () => {
-    const buildResult = await appBuild({
-      appPath: APP_PATH,
-      tarball: true,
-      onProgress: (message: string) => console.log(`[build] ${message}`),
-    });
-
-    if (!buildResult.success) {
-      throw new Error(
-        `Build failed: ${buildResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-
-    const deployResult = await appDeploy({
-      tarballPath: buildResult.data.tarballPath!,
-      onProgress: (message: string) => console.log(`[deploy] ${message}`),
-    });
-
-    if (!deployResult.success) {
-      throw new Error(
-        `Deploy failed: ${deployResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-
-    const installResult = await appInstall({ appPath: APP_PATH });
-
-    if (!installResult.success) {
-      throw new Error(
-        `Install failed: ${installResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-  });
-
-  afterAll(async () => {
-    const uninstallResult = await appUninstall({ appPath: APP_PATH });
-
-    if (!uninstallResult.success) {
-      console.warn(
-        `App uninstall failed: ${uninstallResult.error?.message ?? 'Unknown error'}`,
-      );
-    }
-  });
-
-  it('should find the installed app in the applications list', async () => {
-    const metadataClient = new MetadataApiClient();
-
-    const result = await metadataClient.query({
-      findManyApplications: {
-        id: true,
-        name: true,
-        universalIdentifier: true,
-      },
-    });
-
-    const installedApp = result.findManyApplications.find(
-      (application: { universalIdentifier: string }) =>
-        application.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
-    );
-
-    expect(installedApp).toBeDefined();
-  });
-});
@@ -1,45 +0,0 @@
-import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-import { beforeAll } from 'vitest';
-
-const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
-const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
-
-const assertServerIsReachable = async () => {
-  let response: Response;
-
-  try {
-    response = await fetch(`${TWENTY_API_URL}/healthz`);
-  } catch {
-    throw new Error(
-      `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
-        'Make sure the server is running before executing integration tests.',
-    );
-  }
-
-  if (!response.ok) {
-    throw new Error(`Server at ${TWENTY_API_URL} returned ${response.status}`);
-  }
-};
-
-beforeAll(async () => {
-  await assertServerIsReachable();
-
-  fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
-
-  const configFile = {
-    remotes: {
-      local: {
-        apiUrl: process.env.TWENTY_API_URL,
-        apiKey: process.env.TWENTY_API_KEY,
-      },
-    },
-    defaultRemote: 'local',
-  };
-
-  fs.writeFileSync(
-    path.join(TEST_CONFIG_DIR, 'config.json'),
-    JSON.stringify(configFile, null, 2),
-  );
-});
@@ -1,13 +0,0 @@
-import { defineAgent } from 'twenty-sdk';
-
-export default defineAgent({
-  universalIdentifier: 'b8d4f2a3-9c5e-4f7b-a012-3e4d5c6b7a8f',
-  name: 'postcard-drafter',
-  label: 'Postcard Drafter',
-  icon: 'IconRobot',
-  description: 'Helps draft postcard messages',
-  prompt:
-    'You are a postcard writing assistant. Help users draft concise, warm ' +
-    'postcard messages. Follow the postcard writing guidelines. Ask for the ' +
-    'recipient name and the occasion if not provided.',
-});
@@ -1,33 +0,0 @@
-import { defineApplication } from 'twenty-sdk';
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from './roles/default-function.role';
-
-export const APPLICATION_UNIVERSAL_IDENTIFIER =
-  '8b2df3cc-23ad-4e1b-87fd-f880d4cefd58';
-
-export default defineApplication({
-  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
-  displayName: 'Postcard App',
-  description: 'Send postcards easily with Twenty',
-  icon: 'IconWorld',
-  applicationVariables: {
-    DEFAULT_RECIPIENT_NAME: {
-      universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
-      description: 'Default recipient name for postcards',
-      value: 'Alex Karp',
-      isSecret: false,
-    },
-  },
-  serverVariables: {
-    POSTCARD_API_KEY: {
-      description: 'API key for the postcard printing service',
-      isSecret: true,
-      isRequired: true,
-    },
-    POSTCARD_SENDER_NAME: {
-      description: 'Default sender name on postcards',
-      isSecret: false,
-      isRequired: false,
-    },
-  },
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-});
@@ -1,189 +0,0 @@
-import { useCallback, useEffect, useState } from 'react';
-import { defineFrontComponent, useRecordId } from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-client-sdk/core';
-import { isDefined } from 'twenty-shared/utils';
-
-export const CARD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER =
-  '88c15ae2-5f87-4a6b-b48f-1974bbe62eb7';
-
-type PostCardRecord = {
-  name: string;
-  content: string;
-  status: string;
-};
-
-const STATUS_COLORS: Record<string, string> = {
-  DRAFT: '#999',
-  SENT: '#e88c30',
-  DELIVERED: '#4caf50',
-  RETURNED: '#e05252',
-};
-
-const CardDisplay = ({
-  name,
-  content,
-  status,
-}: {
-  name: string;
-  content: string;
-  status: string;
-}) => {
-  return (
-    <div style={{ padding: '24px', fontFamily: 'sans-serif' }}>
-      <div
-        style={{
-          display: 'flex',
-          alignItems: 'center',
-          gap: '8px',
-          marginBottom: '16px',
-        }}
-      >
-        <span style={{ fontSize: '15px', fontWeight: 600, color: '#333' }}>
-          {name || 'Untitled'}
-        </span>
-        <span
-          style={{
-            fontSize: '11px',
-            fontWeight: 600,
-            padding: '2px 8px',
-            borderRadius: '4px',
-            color: '#fff',
-            backgroundColor: STATUS_COLORS[status] ?? '#999',
-          }}
-        >
-          {status}
-        </span>
-      </div>
-
-      <p
-        style={{
-          fontSize: '14px',
-          lineHeight: '1.6',
-          color: '#555',
-          margin: 0,
-          whiteSpace: 'pre-line',
-        }}
-      >
-        {content || 'No content yet...'}
-      </p>
-    </div>
-  );
-};
-
-const PostCardPreview = () => {
-  const recordId = useRecordId();
-  const [postCard, setPostCard] = useState<PostCardRecord | null>(null);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<string | null>(null);
-
-  const fetchPostCard = useCallback(async () => {
-    if (!isDefined(recordId)) {
-      setLoading(false);
-      setError('No record ID');
-      return;
-    }
-
-    try {
-      setError(null);
-      const client = new CoreApiClient();
-
-      const result = await client.query({
-        postCard: {
-          __args: {
-            filter: { id: { eq: recordId } },
-          },
-          name: true,
-          content: true,
-          status: true,
-        },
-      });
-
-      const record = result?.postCard;
-
-      if (!isDefined(record)) {
-        setError('Record not found');
-        setPostCard(null);
-      } else {
-        setPostCard({
-          name: record.name ?? '',
-          content: record.content ?? '',
-          status: record.status ?? 'DRAFT',
-        });
-      }
-    } catch (fetchError) {
-      setError(
-        fetchError instanceof Error ? fetchError.message : String(fetchError),
-      );
-      setPostCard(null);
-    }
-    setLoading(false);
-  }, [recordId]);
-
-  useEffect(() => {
-    fetchPostCard();
-
-    const interval = setInterval(fetchPostCard, 3000);
-
-    return () => {
-      clearInterval(interval);
-      setPostCard(null);
-      setLoading(false);
-      setError(null);
-    };
-  }, [fetchPostCard]);
-
-  if (loading) {
-    return (
-      <div
-        style={{
-          display: 'flex',
-          alignItems: 'center',
-          justifyContent: 'center',
-          height: '100%',
-          color: '#b0a89a',
-          fontFamily: 'Georgia, serif',
-          fontSize: '14px',
-        }}
-      >
-        Loading postcard...
-      </div>
-    );
-  }
-
-  if (!isDefined(postCard)) {
-    return (
-      <div
-        style={{
-          padding: '16px',
-          color: '#b0a89a',
-          fontFamily: 'sans-serif',
-          fontSize: '13px',
-        }}
-      >
-        <div>{error ?? 'No postcard data'}</div>
-        <div style={{ marginTop: '8px', fontSize: '11px', color: '#ccc' }}>
-          recordId: {recordId ?? 'null'} | apiUrl:{' '}
-          {process.env.TWENTY_API_URL ? 'set' : 'missing'} | token:{' '}
-          {process.env.TWENTY_APP_ACCESS_TOKEN ?? process.env.TWENTY_API_KEY
-            ? 'set'
-            : 'missing'}
-        </div>
-      </div>
-    );
-  }
-
-  return (
-    <CardDisplay
-      name={postCard.name}
-      content={postCard.content}
-      status={postCard.status}
-    />
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: CARD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
-  name: 'card-component',
-  description: 'A component using an external component file',
-  component: PostCardPreview,
-});
@@ -1,125 +0,0 @@
-import { useEffect } from 'react';
-import {
-  defineFrontComponent,
-  useRecordId,
-  updateProgress,
-  enqueueSnackbar,
-  unmountFrontComponent,
-} from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-client-sdk/core';
-import { isDefined } from 'twenty-shared/utils';
-import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
-
-const SYSTEM_PROMPT =
-  'You are a postcard writing assistant. Write a short, warm postcard message ' +
-  'under 150 words. Use a personal tone. Output ONLY the postcard message ' +
-  'text, nothing else — no greeting label, no sign-off label, just the message.';
-
-const GeneratePostCardEffect = () => {
-  const recordId = useRecordId();
-
-  useEffect(() => {
-    if (!isDefined(recordId)) {
-      enqueueSnackbar({
-        message: 'No record selected',
-        variant: 'error',
-      });
-      unmountFrontComponent();
-      return;
-    }
-
-    const generate = async () => {
-      try {
-        const client = new CoreApiClient();
-
-        const userPrompt = 'Write a postcard message for a friend.';
-
-        const apiBaseUrl = process.env.TWENTY_API_URL;
-        const token =
-          process.env.TWENTY_APP_ACCESS_TOKEN ?? process.env.TWENTY_API_KEY;
-
-        if (!apiBaseUrl || !token) {
-          throw new Error('API configuration missing');
-        }
-
-        const response = await fetch(`${apiBaseUrl}/rest/ai/generate-text`, {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            Authorization: `Bearer ${token}`,
-          },
-          body: JSON.stringify({
-            systemPrompt: SYSTEM_PROMPT,
-            userPrompt,
-          }),
-        });
-
-        if (!response.ok) {
-          const errorBody = await response.text();
-
-          if (errorBody.includes('No AI models are available')) {
-            throw new Error(
-              'No AI models configured. Go to Settings > Admin Panel > AI to add a provider API key.',
-            );
-          }
-
-          throw new Error(`AI request failed with status ${response.status}`);
-        }
-
-        const data = (await response.json()) as { text?: string };
-        const generatedContent = data.text ?? '';
-
-        await updateProgress(0.7);
-
-        await client.mutation({
-          updatePostCard: {
-            __args: {
-              id: recordId,
-              data: { content: generatedContent },
-            },
-            id: true,
-          },
-        });
-
-        await updateProgress(1);
-
-        await enqueueSnackbar({
-          message: 'Post card content generated!',
-          variant: 'success',
-        });
-
-        await unmountFrontComponent();
-      } catch (error) {
-        await enqueueSnackbar({
-          message:
-            error instanceof Error
-              ? error.message
-              : 'Failed to generate content',
-          variant: 'error',
-        });
-        await unmountFrontComponent();
-      }
-    };
-
-    generate();
-  }, [recordId]);
-
-  return null;
-};
-
-export default defineFrontComponent({
-  universalIdentifier: 'bd7649c0-7540-4267-ac4b-f062fbd635a3',
-  name: 'Generate Post Card',
-  description: 'Generates postcard content using AI',
-  isHeadless: true,
-  component: GeneratePostCardEffect,
-  command: {
-    universalIdentifier: '0f795c1c-8e25-44da-8962-80bef9602ee2',
-    label: 'Generate post card content',
-    shortLabel: 'Generate content',
-    icon: 'IconSparkles',
-    isPinned: true,
-    availabilityType: 'RECORD_SELECTION',
-    availabilityObjectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
-  },
-});
@@ -1,102 +0,0 @@
-import { useEffect } from 'react';
-import {
-  defineFrontComponent,
-  useRecordId,
-  updateProgress,
-  enqueueSnackbar,
-  unmountFrontComponent,
-} from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-client-sdk/core';
-import { isDefined } from 'twenty-shared/utils';
-import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
-
-const SendPostCardsEffect = () => {
-  const recordId = useRecordId();
-
-  useEffect(() => {
-    const send = async () => {
-      try {
-        await updateProgress(0.1);
-        const client = new CoreApiClient();
-
-        let idsToSend: string[] = [];
-
-        if (isDefined(recordId)) {
-          idsToSend = [recordId];
-        } else {
-          const { postCards } = await client.query({
-            postCards: {
-              __args: {
-                filter: { status: { eq: 'DRAFT' } },
-              },
-              edges: { node: { id: true } },
-            },
-          });
-
-          idsToSend =
-            postCards?.edges?.map(
-              (edge: { node: { id: string; status: true } }) => edge.node.id,
-            ) ?? [];
-        }
-
-        if (idsToSend.length === 0) {
-          await updateProgress(1);
-          await unmountFrontComponent();
-          return;
-        }
-
-        await updateProgress(0.3);
-
-        for (let i = 0; i < idsToSend.length; i++) {
-          await client.mutation({
-            updatePostCard: {
-              __args: {
-                id: idsToSend[i],
-                data: { status: 'SENT' },
-              },
-              id: true,
-            },
-          });
-
-          await updateProgress(0.3 + (0.7 * (i + 1)) / idsToSend.length);
-        }
-
-        const count = idsToSend.length;
-
-        await enqueueSnackbar({
-          message: `${count} postcard${count > 1 ? 's' : ''} sent`,
-          variant: 'success',
-        });
-
-        await unmountFrontComponent();
-      } catch (error) {
-        const message =
-          error instanceof Error ? error.message : 'Failed to send postcards';
-
-        await enqueueSnackbar({ message, variant: 'error' });
-        await unmountFrontComponent();
-      }
-    };
-
-    send();
-  }, [recordId]);
-
-  return null;
-};
-
-export default defineFrontComponent({
-  universalIdentifier: 'a3b7c2d1-4e5f-4a8b-9c0d-1e2f3a4b5c6d',
-  name: 'Send Post Cards',
-  description: 'Sets postcard status to Sent',
-  isHeadless: true,
-  component: SendPostCardsEffect,
-  command: {
-    universalIdentifier: 'bd75de13-87a1-4f7a-94e2-92e19e97523c',
-    label: 'Send post cards',
-    shortLabel: 'Send',
-    icon: 'IconSend',
-    isPinned: true,
-    availabilityType: 'RECORD_SELECTION',
-    availabilityObjectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
-  },
-});
@@ -1,18 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-
-// Field on existing company object
-export default defineField({
-  universalIdentifier: 'f922fdb8-10a9-4f11-a1d0-992a779f6dff',
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
-  type: FieldType.BOOLEAN,
-  name: 'canReceivePostcards',
-  label: 'Can Receive Postcards',
-  description: 'Whether the company can receive postcards',
-  icon: 'IconMailbox',
-  defaultValue: true,
-});
@@ -1,27 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  RelationType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
-import {
-  POST_CARDS_ON_PERSON_ID,
-  RECIPIENT_ON_POST_CARD_ID,
-} from './recipient-on-post-card.field';
-
-export default defineField({
-  universalIdentifier: POST_CARDS_ON_PERSON_ID,
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
-  type: FieldType.RELATION,
-  name: 'postCards',
-  label: 'Post Cards',
-  icon: 'IconMail',
-  relationTargetObjectMetadataUniversalIdentifier:
-    POST_CARD_UNIVERSAL_IDENTIFIER,
-  relationTargetFieldMetadataUniversalIdentifier: RECIPIENT_ON_POST_CARD_ID,
-  universalSettings: {
-    relationType: RelationType.ONE_TO_MANY,
-  },
-});
@@ -1,28 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  RelationType,
-  OnDeleteAction,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
-
-export const RECIPIENT_ON_POST_CARD_ID = 'c44f158e-2747-42c6-9295-75b8cbae7039';
-export const POST_CARDS_ON_PERSON_ID = 'd4aa40b9-077b-46f3-a685-5f0f08ad318c';
-
-export default defineField({
-  universalIdentifier: RECIPIENT_ON_POST_CARD_ID,
-  objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
-  type: FieldType.RELATION,
-  name: 'recipient',
-  label: 'Recipient',
-  icon: 'IconUser',
-  relationTargetObjectMetadataUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
-  relationTargetFieldMetadataUniversalIdentifier: POST_CARDS_ON_PERSON_ID,
-  universalSettings: {
-    relationType: RelationType.MANY_TO_ONE,
-    onDelete: OnDeleteAction.SET_NULL,
-    joinColumnName: 'recipientId',
-  },
-});
@@ -1,94 +0,0 @@
-import { defineObject, FieldType } from 'twenty-sdk';
-
-enum PostCardStatus {
-  DRAFT = 'DRAFT',
-  SENT = 'SENT',
-  DELIVERED = 'DELIVERED',
-  RETURNED = 'RETURNED',
-}
-
-export const POST_CARD_UNIVERSAL_IDENTIFIER =
-  '54b589ca-eeed-4950-a176-358418b85c05';
-
-export const CONTENT_FIELD_UNIVERSAL_IDENTIFIER =
-  'cb9679ff-8f10-4dba-9e75-d571922c6d29';
-
-export const NAME_FIELD_UNIVERSAL_IDENTIFIER =
-  'f84f131c-1cfb-4800-916f-7f98e0bdf748';
-
-export default defineObject({
-  universalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
-  nameSingular: 'postCard',
-  namePlural: 'postCards',
-  labelSingular: 'Post card',
-  labelPlural: 'Post cards',
-  description: 'A post card object',
-  icon: 'IconMail',
-  labelIdentifierFieldMetadataUniversalIdentifier:
-    NAME_FIELD_UNIVERSAL_IDENTIFIER,
-  fields: [
-    {
-      universalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
-      type: FieldType.TEXT,
-      label: 'Name',
-      description: "Postcard's name",
-      icon: 'IconAbc',
-      name: 'name',
-    },
-    {
-      universalIdentifier: CONTENT_FIELD_UNIVERSAL_IDENTIFIER,
-      type: FieldType.TEXT,
-      label: 'Content',
-      description: "Postcard's content",
-      icon: 'IconAbc',
-      name: 'content',
-    },
-    {
-      universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
-      type: FieldType.SELECT,
-      label: 'Status',
-      icon: 'IconSend',
-      defaultValue: `'${PostCardStatus.DRAFT}'`,
-      options: [
-        {
-          id: 'a1b2c3d4-0001-4000-8000-000000000001',
-          value: PostCardStatus.DRAFT,
-          label: 'Draft',
-          position: 0,
-          color: 'gray',
-        },
-        {
-          id: 'a1b2c3d4-0002-4000-8000-000000000002',
-          value: PostCardStatus.SENT,
-          label: 'Sent',
-          position: 1,
-          color: 'orange',
-        },
-        {
-          id: 'a1b2c3d4-0003-4000-8000-000000000003',
-          value: PostCardStatus.DELIVERED,
-          label: 'Delivered',
-          position: 2,
-          color: 'green',
-        },
-        {
-          id: 'a1b2c3d4-0004-4000-8000-000000000004',
-          value: PostCardStatus.RETURNED,
-          label: 'Returned',
-          position: 3,
-          color: 'orange',
-        },
-      ],
-      name: 'status',
-    },
-    {
-      universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
-      type: FieldType.DATE_TIME,
-      label: 'Delivered at',
-      icon: 'IconCheck',
-      isNullable: true,
-      defaultValue: null,
-      name: 'deliveredAt',
-    },
-  ],
-});
@@ -1,47 +0,0 @@
-import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk';
-import { POST_CARD_UNIVERSAL_IDENTIFIER } from 'src/objects/post-card.object';
-import { CARD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER } from 'src/components/card.front-component';
-
-export default definePageLayout({
-  universalIdentifier: 'f2bf4b9f-0485-46f0-89bb-9a65d2b939b1',
-  name: 'Post Card Record Page',
-  type: 'RECORD_PAGE',
-  objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
-  tabs: [
-    {
-      universalIdentifier: 'a8c3d1e2-4f5b-4a6c-9d0e-1f2a3b4c5d6e',
-      title: 'Fields',
-      position: 0,
-      icon: 'IconList',
-      layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,
-      widgets: [
-        {
-          universalIdentifier: '3d388201-f421-4189-8266-f632e494091b',
-          title: 'Post Card Fields',
-          type: 'FIELDS',
-          configuration: {
-            configurationType: 'FIELDS',
-          },
-        },
-      ],
-    },
-    {
-      universalIdentifier: '14dbc57a-5080-48d8-b276-bea9146edff9',
-      title: 'Preview',
-      position: 50,
-      icon: 'IconEye',
-      widgets: [
-        {
-          universalIdentifier: 'd70f837e-8d0c-4fe2-b70e-89b5bc173499',
-          title: 'Card Preview',
-          type: 'FRONT_COMPONENT',
-          configuration: {
-            configurationType: 'FRONT_COMPONENT',
-            frontComponentUniversalIdentifier:
-              CARD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
-          },
-        },
-      ],
-    },
-  ],
-});
@@ -1,15 +0,0 @@
-import { defineSkill } from 'twenty-sdk';
-
-export default defineSkill({
-  universalIdentifier: 'a7c3e1f2-8b4d-4e6a-9f01-2d3c4b5a6e7f',
-  name: 'postcard-writing-guidelines',
-  label: 'Postcard Writing Guidelines',
-  icon: 'IconPencil',
-  description: 'Guidelines for writing effective postcards',
-  content:
-    'When writing a postcard: keep the message under 150 words, use a warm ' +
-    'and personal tone, mention the recipient by name, and include a clear ' +
-    'call-to-action if the postcard is business-related. Always fill in both ' +
-    'the recipientName and recipientAddress fields before marking the status ' +
-    'as SENT.',
-});
@@ -1,56 +0,0 @@
-import { defineView } from 'twenty-sdk';
-import {
-  CONTENT_FIELD_UNIVERSAL_IDENTIFIER,
-  NAME_FIELD_UNIVERSAL_IDENTIFIER,
-  POST_CARD_UNIVERSAL_IDENTIFIER,
-} from '../objects/post-card.object';
-import { RECIPIENT_ON_POST_CARD_ID } from '../fields/recipient-on-post-card.field';
-import { ViewType } from 'twenty-shared/types';
-
-export const ALL_POST_CARDS_VIEW_ID = 'b1a2b3c4-0001-4a7b-8c9d-0e1f2a3b4c5d';
-
-export default defineView({
-  universalIdentifier: ALL_POST_CARDS_VIEW_ID,
-  name: 'All Post Cards',
-  objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
-  type: ViewType.TABLE,
-  icon: 'IconMail',
-  position: 0,
-  fields: [
-    {
-      universalIdentifier: '501adcc2-6c2b-48bd-a042-042478e839ec',
-      fieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
-      position: 0,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: '38d9c9d1-a55c-4662-9727-e1e19bed6d82',
-      fieldMetadataUniversalIdentifier: RECIPIENT_ON_POST_CARD_ID,
-      position: 1,
-      isVisible: true,
-      size: 300,
-    },
-    {
-      universalIdentifier: '75956ae8-5725-48be-a785-c6d1d4c74b60',
-      fieldMetadataUniversalIdentifier: CONTENT_FIELD_UNIVERSAL_IDENTIFIER,
-      position: 2,
-      isVisible: true,
-      size: 500,
-    },
-    {
-      universalIdentifier: 'cedd1429-c589-41d7-bae2-81b26c3534a0',
-      fieldMetadataUniversalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
-      position: 3,
-      isVisible: true,
-      size: 150,
-    },
-    {
-      universalIdentifier: 'babf6f19-6261-40cb-85fa-6c67eccf75f9',
-      fieldMetadataUniversalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
-      position: 4,
-      isVisible: true,
-      size: 150,
-    },
-  ],
-});
@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "composite": true,
-    "types": ["vitest/globals", "node"]
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "dist"]
-}
@@ -1,21 +0,0 @@
-import tsconfigPaths from 'vite-tsconfig-paths';
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  plugins: [
-    tsconfigPaths({
-      projects: ['tsconfig.spec.json'],
-      ignoreConfigErrors: true,
-    }),
-  ],
-  test: {
-    testTimeout: 120_000,
-    hookTimeout: 120_000,
-    include: ['src/**/*.integration-test.ts'],
-    setupFiles: ['src/__tests__/setup-test.ts'],
-    env: {
-      TWENTY_API_KEY:
-        'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik',
-    },
-  },
-});
@@ -1,5 +1,5 @@
 {
-  "name": "rich-app",
+  "name": "postcard-app",
  "version": "0.1.0",
  "license": "MIT",
  "engines": {
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Claude	d8622dfd54	fix: replace MetadataEvent double cast with proper EventStreamMetadataEvent type The broadcaster produces a simpler shape than the workspace-migration MetadataEvent discriminated union, and includes updatedCollectionHash which MetadataEvent lacks. Define EventStreamMetadataEvent to match what the broadcaster actually produces, removing the as unknown as cast. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:35:08 +00:00
Claude	63580fa1b6	chore: regenerate GraphQL types and client SDK Include the new sendChatMessage, stopAgentChatStream, and deleteQueuedChatMessage mutations in generated types. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:04 +00:00
Claude	2fae1b97f4	fix: add explicit type for modelId GraphQL arg NestJS GraphQL requires explicit type annotations for nullable string parameters. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:04 +00:00
Claude	14d4b98e8a	fix: fix MetadataEvent type cast in workspace event broadcaster Cast through unknown since the mapped event shape doesn't directly overlap with the MetadataEvent discriminated union type. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:03 +00:00
Claude	326fa38515	fix: add type parameters to Apollo mutate calls https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:03 +00:00
Claude	ac99ce5c68	fix: fix import issues from GraphQL mutation migration - Use value import for AgentChatThreadEntity (needed for @InjectRepository) - Import useApolloClient from @apollo/client/react https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:03 +00:00
Claude	41f398183f	feat: replace REST endpoints with GraphQL mutations for agent chat Replace the REST controller (POST /agent-chat/:threadId/message, DELETE /agent-chat/:threadId/stream, DELETE /agent-chat/queue/:messageId) with GraphQL mutations (sendChatMessage, stopAgentChatStream, deleteQueuedChatMessage) on the resolver. Frontend now uses Apollo client mutations instead of custom useAuthenticatedAgentChatFetch hook. Message IDs are generated on the frontend (v4 UUID) and kept by the server, enabling proper optimistic updates without replace-on-refetch. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:03 +00:00
Claude	6e17e630ed	fix: use toSorted instead of spread+sort for thread sorting https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:03 +00:00
Claude	2e2bc13ea0	fix: return correct messageId instead of threadId for non-queued messages The controller was returning threadId as messageId for non-queued messages, creating an inconsistent API response. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-02 06:15:03 +00:00
Félix MalfaitandGitHub	da90aefa44	Merge branch 'main' into feat/agent-chat-queue-and-sse-refactor	2026-04-02 07:41:33 +02:00
Claude	06fdee5c4b	fix: add ownership check to chatStreamCatchupChunks query Verify the thread belongs to the requesting user before returning accumulated stream chunks, preventing cross-user data access within the same workspace. https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-01 21:01:07 +00:00
Claude	1828223ed8	fix: remove obvious/redundant code comments per PR review Remove comments that restate what the code does (e.g., "Optimistic user message", "Extract usage and title from data parts", "Subscribe to the thread's event stream"). Keep comments that explain WHY (mid-stream adapter, catchup chunks, graphql-sse reconnection). https://claude.ai/code/session_01EcJHCeJy44AKw2rafgQcnu	2026-04-01 21:00:21 +00:00
Félix Malfait	4f5fd92a4e	Fix	2026-04-01 22:46:41 +02:00
Félix Malfait	c96f0433ba	Lint	2026-04-01 22:42:02 +02:00
Félix Malfait	4a010dbf02	Update sdk	2026-04-01 22:37:51 +02:00
Claude	f3cad411ee	fix: resolve merge conflict markers in useLoadStaleMetadataEntities Kept HEAD side (isAiEnabled feature flag) and removed unused isCommandMenuItemEnabled. Added missing imports. https://claude.ai/code/session_01NGv3c62sYGMww7iuVsWzcJ	2026-04-01 20:35:14 +00:00
Claude	9e145925b7	fix: remove retry TODO comment Retry isn't planned for this PR — users can resend naturally. https://claude.ai/code/session_01NGv3c62sYGMww7iuVsWzcJ	2026-04-01 20:31:02 +00:00
Claude	22bbca7b3c	fix: correct migration timestamp to April 2026 The migration timestamp 1774776000000 corresponded to December 2026 (8 months in the future). Updated to 1775001600000 (April 1, 2026). https://claude.ai/code/session_01NGv3c62sYGMww7iuVsWzcJ	2026-04-01 20:26:58 +00:00
Claude	410ef98783	fix: remove dead code, fix naming inconsistency, document migration - Remove unused AGENT_CHAT_RETRY_EVENT_NAME constant (dead code) - Rename agentStreamingService to agentChatStreamingService for consistency - Add comment explaining why migration down() deletes queued messages https://claude.ai/code/session_01NGv3c62sYGMww7iuVsWzcJ	2026-04-01 20:17:30 +00:00
Claude	bfa162de25	fix: address remaining PR review comments - Remove .claude/launch.json (avoid new root-level folder) - Remove redundant comments in useAgentChat.ts - Split mapDBPartsToUIMessageParts into one export per file - Split STREAM_AGENT_CHAT_JOB_NAME constant into its own file - Simplify delete queue endpoint to derive threadId from messageId - Update useDeleteQueuedMessage to match simplified API https://claude.ai/code/session_01NGv3c62sYGMww7iuVsWzcJ	2026-04-01 20:14:01 +00:00
Félix Malfait	0187c8e330	Merge	2026-04-01 22:05:41 +02:00
Félix Malfait	d9686ee642	Iterate	2026-04-01 22:05:28 +02:00
Félix MalfaitandGitHub	6aedeb1cb2	Merge branch 'main' into feat/agent-chat-queue-and-sse-refactor	2026-04-01 19:28:30 +02:00
ClaudeandFélix Malfait	7c70d96120	fix: improve agent chat architecture, security, and idiomatic patterns - Replace Date.now() with v4() for optimistic message IDs (codebase idiom) - Extract useAuthenticatedAgentChatFetch hook to centralize REST auth+retry - Extract useDeleteQueuedMessage hook to remove raw fetch from component - Simplify optimistic rendering: always place in messages atom, let refetch reconcile - Add thread ownership check to subscription resolver (security fix) - Server loads message history from DB instead of receiving from client - Hide broken retry button until retry is properly implemented - Document GraphQLJSON event payload shapes in DTO - Fix duplicate ai import and add suppress comments for imperative useRefs - Add cross-reference comments between parallel mapDBPart functions https://claude.ai/code/session_01F9LW9EAQj6SSd24AcQ29YZ	2026-04-01 18:05:40 +02:00
Félix Malfait	eefc5c1914	feat: replace AI SDK client with GraphQL SSE subscription for agent chat Drop @ai-sdk/react and resumable-stream in favor of a unified GraphQL SSE subscription for all agent chat events (token streaming, message persistence, queue updates). This makes the architecture server-driven and eliminates the class of bugs caused by dual-state (AI SDK internal state vs Jotai atoms). Key changes: - Backend: publish UIMessageChunks via Redis PubSub instead of HTTP SSE + resumable-stream. New AgentChatEventPublisherService, subscription resolver, and unified POST /:threadId/message endpoint (server decides queue vs stream). - Frontend: new useAgentChatSubscription hook bridges graphql-sse events into readUIMessageStream (from ai package) for chunk accumulation. Optimistic rendering preserves user messages during streaming. SSE client recycling triggers automatic resubscription. - Queue: messages sent during active streaming are placed directly in queue atoms (no flash). Server auto-flushes next queued message after stream ends. Made-with: Cursor	2026-04-01 13:18:58 +02:00
Félix Malfait	f5b2c71943	Fix	2026-03-31 18:28:16 +02:00
Félix Malfait	74e6e20921	Merge branch 'feat/agent-chat-message-queue' of github.com:twentyhq/twenty into pr/19118	2026-03-31 17:57:07 +02:00
Félix MalfaitandClaude Opus 4.6	c3ee312d26	Fix client SDK generated types: make turnId nullable The DTO exposes turnId as nullable for queued messages, update generated schema to match. Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-31 17:45:52 +02:00
Félix MalfaitandGitHub	6cdca784fd	Merge branch 'main' into feat/agent-chat-message-queue	2026-03-31 17:31:36 +02:00
Félix MalfaitandClaude Opus 4.6	9573e11879	Fix front typecheck and update client SDK generated types - Cast status to union type in mapDBMessagesToUIMessages - Update client SDK generated schema/types to include status field Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-31 09:57:51 +02:00
Félix MalfaitandClaude Opus 4.6	717989d36d	Fix circular dependency and improve code quality - Extract STREAM_AGENT_CHAT_JOB_NAME and StreamAgentChatJobData to separate types file to break circular dependency between stream-agent-chat.job.ts and agent-chat-streaming.service.ts - Optimize flushNextQueuedMessage to check queued messages first (lightweight query) before loading full conversation - Add missing state field to reasoning parts in server-side mapper - Use entity status value in controller response instead of string literal - Narrow ExtendedUIMessage.status to 'queued' \| 'sent' union type Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-31 09:45:09 +02:00
Félix MalfaitandClaude Opus 4.6	e6cfa46998	fix: typecheck errors for status field and reasoning part - Add optional status field to ExtendedUIMessage in twenty-shared - Remove invalid providerOptions from reasoning part mapper Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-31 09:34:03 +02:00
Félix MalfaitandClaude Opus 4.6	d4acf77338	fix: migration schema prefix, review fixes - Add "core" schema prefix to migration SQL (fixes CI) - Remove unused modelId param from queueMessage - Scope promoteQueuedMessage to QUEUED status only - Use AgentMessageStatus enum instead of string literals - Create proper mapDBPartsToUIMessageParts server-side mapper (fixes lossy mapping that dropped tool calls, reasoning, etc.) - Merge getQueuedMessages + getMessagesForThread into single query - Pass hasTitle from job data to avoid redundant thread lookup - Remove modelId from frontend queue POST body Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-31 09:28:18 +02:00
Félix MalfaitandClaude Opus 4.6	220b32b19b	feat: server-side message queue for agent chat Replace localStorage-based frontend queue with server-side persistence. When a user sends a message while streaming, the message is stored in the database with status='queued'. When streaming finishes, the worker automatically picks up the next queued message and starts processing it. - Add `status` column (queued/sent) and make `turnId` nullable on AgentMessage - Add REST endpoints POST/:threadId/queue and DELETE/:threadId/queue/:messageId - Add auto-flush logic in stream job's finally block - Frontend reads queued messages from GraphQL instead of localStorage - Delete queued messages via REST DELETE endpoint Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-30 22:40:50 +02:00
Félix MalfaitandClaude Opus 4.6	f8d92f9626	feat: queue messages sent while AI is streaming When the user sends a message while the AI is still streaming a response, instead of silently dropping it, queue it per-thread. The queue is persisted to localStorage so it survives page refreshes. When streaming completes, the next queued message is automatically sent. - New Jotai state: agentChatQueuedMessagesByThreadIdState (localStorage-backed) - New UI component: AIChatQueuedMessages showing queued items with remove buttons - Modified handleSendMessage to push to queue when streaming is active - Added flushNextQueuedMessage to auto-send after stream completion Co-Authored-By: Claude Opus 4.6 <[email protected]>	2026-03-30 22:28:16 +02:00