feat: app registration UI, OAuth consent screen, and CLI integration

Frontend:
- SettingsAppRegistrationDetails page with general info, OAuth credentials,
  redirect URI management (with URL validation), server variables, and
  install stats sections
- Developer tab replacing the Create tab on Settings > Applications
- OAuth consent screen (Authorize page) updated for AppRegistration
- GraphQL queries, mutations, and fragments for app registrations
- SettingsAdminTableCard copy-on-click enhancement
- New route and navigation item for app registration details

CLI/SDK:
- RegisterAppOrchestratorStep for automatic server-side registration
- API service methods for app registration CRUD
- Config service persists clientId and clientSecret locally
- Dev mode orchestrator wires registration into the dev flow

Made-with: Cursor

.github/actions/nx-affected/action.yaml

@@ -19,10 +19,4 @@ runs:
       uses: nrwl/nx-set-shas@v4
     - name: Run affected command
       shell: bash
-      env:
-        NX_CONFIGURATION: ${{ inputs.configuration }}
-        NX_TASKS: ${{ inputs.tasks }}
-        NX_PARALLEL: ${{ inputs.parallel }}
-        NX_TAG: ${{ inputs.tag }}
-        NX_ARGS: ${{ inputs.args }}
-      run: npx nx affected --nxBail --configuration="$NX_CONFIGURATION" -t="$NX_TASKS" --parallel="$NX_PARALLEL" --exclude="*,!tag:$NX_TAG" $NX_ARGS
+      run: npx nx affected --nxBail --configuration=${{ inputs.configuration }} -t=${{ inputs.tasks }} --parallel=${{ inputs.parallel }} --exclude='*,!tag:${{ inputs.tag }}' ${{ inputs.args }}

.github/actions/restore-cache/action.yaml

@@ -19,11 +19,8 @@ runs:
     - name: Cache primary key builder
       id: cache-primary-key-builder
       shell: bash
-      env:
-        CACHE_KEY: ${{ inputs.key }}
-        REF_NAME: ${{ github.ref_name }}
       run: |
-        echo "CACHE_PRIMARY_KEY_PREFIX=v4-${CACHE_KEY}-${REF_NAME}" >> "${GITHUB_OUTPUT}"
+        echo "CACHE_PRIMARY_KEY_PREFIX=v4-${{ inputs.key }}-${{ github.ref_name }}" >> "${GITHUB_OUTPUT}"
     - name: Restore cache
       uses: actions/cache/restore@v4
       id: restore-cache

.github/actions/spawn-twenty-docker-image/action.yaml

@@ -1,80 +0,0 @@
-name: Spawn Twenty Docker Image
-description: >
-  Starts a full Twenty instance (server, worker, database, redis) using Docker
-  Compose. The server is available at http://localhost:3000 for subsequent steps
-  in the caller's job.
-  Pulls the specified semver image tag from Docker Hub.
-  Designed to be consumed from external repositories (e.g., twenty-app).
-
-inputs:
-  twenty-version:
-    description: 'Twenty Docker Hub image tag as semver (e.g., v0.40.0, v1.0.0).'
-    required: true
-  twenty-repository:
-    description: 'Twenty repository to checkout docker compose files from.'
-    required: false
-    default: 'twentyhq/twenty'
-  github-token:
-    description: 'GitHub token for cross-repo checkout. Required when calling from an external repository.'
-    required: false
-    default: ${{ github.token }}
-
-outputs:
-  server-url:
-    description: 'URL where the Twenty server can be reached'
-    value: http://localhost:3000
-  access-token:
-    description: 'Admin access token for the Twenty instance'
-    value: ${{ steps.admin-token.outputs.access-token }}
-
-runs:
-  using: 'composite'
-  steps:
-    - name: Validate version
-      shell: bash
-      run: |
-        VERSION="${{ inputs.twenty-version }}"
-        if ! echo "$VERSION" | grep -qE '^v[0-9]+\.[0-9]+\.[0-9]+$'; then
-          echo "::error::twenty-version must be a semver tag (e.g., v0.40.0). Got: '$VERSION'"
-          exit 1
-        fi
-
-    - name: Checkout docker compose files
-      uses: actions/checkout@v4
-      with:
-        repository: ${{ inputs.twenty-repository }}
-        ref: ${{ inputs.twenty-version }}
-        token: ${{ inputs.github-token }}
-        sparse-checkout: |
-          packages/twenty-docker
-        sparse-checkout-cone-mode: false
-        path: .twenty-spawn
-
-    - name: Prepare environment
-      shell: bash
-      working-directory: ./.twenty-spawn/packages/twenty-docker
-      run: |
-        cp .env.example .env
-        echo "" >> .env
-        echo "TAG=${{ inputs.twenty-version }}" >> .env
-        echo "APP_SECRET=replace_me_with_a_random_string" >> .env
-        echo "SERVER_URL=http://localhost:3000" >> .env
-
-    - name: Start Twenty instance
-      shell: bash
-      working-directory: ./.twenty-spawn/packages/twenty-docker
-      run: |
-        docker compose up -d --wait || {
-          echo "::error::Docker compose failed to start or health checks timed out"
-          docker compose logs
-          exit 1
-        }
-        echo "Twenty instance is ready at http://localhost:3000"
-
-    - name: Set admin access token
-      id: admin-token
-      shell: bash
-      run: |
-        ACCESS_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik"
-        echo "::add-mask::$ACCESS_TOKEN"
-        echo "access-token=$ACCESS_TOKEN" >> "$GITHUB_OUTPUT"

.github/workflows/cd-deploy-main.yaml

@@ -11,7 +11,7 @@ on:
 jobs:
   deploy-main:
     timeout-minutes: 3
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Repository Dispatch
         uses: peter-evans/repository-dispatch@v2

.github/workflows/cd-deploy-tag.yaml

@@ -11,7 +11,7 @@ on:
 jobs:
   deploy-tag:
     timeout-minutes: 3
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Repository Dispatch
         uses: peter-evans/repository-dispatch@v2

.github/workflows/changed-files.yaml

@@ -16,7 +16,7 @@ permissions:
 jobs:
   changed-files:
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     outputs:
       any_changed: ${{ steps.changed-files.outputs.any_changed }}
     steps:

.github/workflows/ci-breaking-changes.yaml

@@ -16,6 +16,8 @@ env:
 
 permissions:
   contents: read
+  pull-requests: write
+  checks: write
 
 jobs:
   changed-files-check:
@@ -32,7 +34,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 45
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -582,16 +584,182 @@ jobs:
             echo "::warning::REST Metadata API analysis tool error - continuing workflow"
           fi
 
-      - name: Upload breaking changes report
+      - name: Comment API Changes on PR
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/github-script@v7
         with:
-          name: breaking-changes-report
-          path: |
-            *-diff.md
-            *-diff.json
-          if-no-files-found: ignore
-          retention-days: 3
+          script: |
+            const fs = require('fs');
+            let hasChanges = false;
+            let comment = '';
+
+            try {
+              if (fs.existsSync('graphql-schema-diff.md')) {
+                const graphqlDiff = fs.readFileSync('graphql-schema-diff.md', 'utf8');
+                if (graphqlDiff.trim()) {
+                  if (!hasChanges) {
+                    comment = '## 📊 API Changes Report\n\n';
+                    hasChanges = true;
+                  }
+                  comment += '### GraphQL Schema Changes\n' + graphqlDiff + '\n\n';
+                }
+              }
+
+              if (fs.existsSync('graphql-metadata-diff.md')) {
+                const graphqlMetadataDiff = fs.readFileSync('graphql-metadata-diff.md', 'utf8');
+                if (graphqlMetadataDiff.trim()) {
+                  if (!hasChanges) {
+                    comment = '## 📊 API Changes Report\n\n';
+                    hasChanges = true;
+                  }
+                  comment += '### GraphQL Metadata Schema Changes\n' + graphqlMetadataDiff + '\n\n';
+                }
+              }
+
+              if (fs.existsSync('rest-api-diff.md')) {
+                const restDiff = fs.readFileSync('rest-api-diff.md', 'utf8');
+                if (restDiff.trim()) {
+                  if (!hasChanges) {
+                    comment = '## 📊 API Changes Report\n\n';
+                    hasChanges = true;
+                  }
+                  comment += restDiff + '\n\n';
+                }
+              }
+
+              if (fs.existsSync('rest-metadata-api-diff.md')) {
+                const metadataDiff = fs.readFileSync('rest-metadata-api-diff.md', 'utf8');
+                if (metadataDiff.trim()) {
+                  if (!hasChanges) {
+                    comment = '## 📊 API Changes Report\n\n';
+                    hasChanges = true;
+                  }
+                  comment += metadataDiff + '\n\n';
+                }
+              }
+
+              // Only post comment if there are changes
+              if (hasChanges) {
+                // Add branch state information only if there were conflicts
+                const branchState = process.env.BRANCH_STATE || 'unknown';
+                let branchStateNote = '';
+
+                if (branchState === 'conflicts') {
+                  branchStateNote = '\n\n⚠️ **Note**: Could not merge with `main` due to conflicts. This comparison shows changes between the current branch and `main` as separate states.\n';
+                }
+                // Check if there are any breaking changes detected
+                let hasBreakingChanges = false;
+                let breakingChangeNote = '';
+
+                // Check for breaking changes in any of the diff files
+                if (fs.existsSync('rest-api-diff.md')) {
+                  const restDiff = fs.readFileSync('rest-api-diff.md', 'utf8');
+                  if (restDiff.includes('Breaking Changes') || restDiff.includes('🚨') ||
+                      restDiff.includes('Removed Endpoints') || restDiff.includes('Changed Operations')) {
+                    hasBreakingChanges = true;
+                  }
+                }
+
+                if (fs.existsSync('rest-metadata-api-diff.md')) {
+                  const metadataDiff = fs.readFileSync('rest-metadata-api-diff.md', 'utf8');
+                  if (metadataDiff.includes('Breaking Changes') || metadataDiff.includes('🚨') ||
+                      metadataDiff.includes('Removed Endpoints') || metadataDiff.includes('Changed Operations')) {
+                    hasBreakingChanges = true;
+                  }
+                }
+
+                // Also check GraphQL changes for breaking changes indicators
+                if (fs.existsSync('graphql-schema-diff.md')) {
+                  const graphqlDiff = fs.readFileSync('graphql-schema-diff.md', 'utf8');
+                  if (graphqlDiff.includes('Breaking changes') || graphqlDiff.includes('BREAKING')) {
+                    hasBreakingChanges = true;
+                  }
+                }
+
+                if (fs.existsSync('graphql-metadata-diff.md')) {
+                  const graphqlMetadataDiff = fs.readFileSync('graphql-metadata-diff.md', 'utf8');
+                  if (graphqlMetadataDiff.includes('Breaking changes') || graphqlMetadataDiff.includes('BREAKING')) {
+                    hasBreakingChanges = true;
+                  }
+                }
+
+                // Check PR title for "breaking"
+                const prTitle = ${{ toJSON(github.event.pull_request.title) }};
+                const titleContainsBreaking = prTitle.toLowerCase().includes('breaking');
+
+                if (hasBreakingChanges) {
+                  if (titleContainsBreaking) {
+                    breakingChangeNote = '\n\n## ✅ Breaking Change Protocol\n\n' +
+                      '**This PR title contains "breaking" and breaking changes were detected - the CI will fail as expected.**\n\n' +
+                      '📝 **Action Required**: Please add `BREAKING CHANGE:` to your commit message to trigger a major version bump.\n\n' +
+                      'Example:\n```\nfeat: add new API endpoint\n\nBREAKING CHANGE: removed deprecated field from User schema\n```';
+                  } else {
+                    breakingChangeNote = '\n\n## ⚠️ Breaking Change Protocol\n\n' +
+                      '**Breaking changes detected but PR title does not contain "breaking" - CI will pass but action needed.**\n\n' +
+                      '🔄 **Options**:\n' +
+                      '1. **If this IS a breaking change**: Add "breaking" to your PR title and add `BREAKING CHANGE:` to your commit message\n' +
+                      '2. **If this is NOT a breaking change**: The API diff tool may have false positives - please review carefully\n\n' +
+                      'For breaking changes, add to commit message:\n```\nfeat: add new API endpoint\n\nBREAKING CHANGE: removed deprecated field from User schema\n```';
+                  }
+                }
+
+                const COMMENT_MARKER = '<!-- API_CHANGES_REPORT -->';
+                const commentBody = COMMENT_MARKER + '\n' + comment + branchStateNote + '\n⚠️ **Please review these API changes carefully before merging.**' + breakingChangeNote;
+
+                // Get all comments to find existing API changes comment
+                const {data: comments} = await github.rest.issues.listComments({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.issue.number,
+                });
+
+                // Find our existing comment
+                const botComment = comments.find(comment => comment.body.includes(COMMENT_MARKER));
+
+                if (botComment) {
+                  // Update existing comment
+                  await github.rest.issues.updateComment({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    comment_id: botComment.id,
+                    body: commentBody
+                  });
+                  console.log('Updated existing API changes comment');
+                } else {
+                  // Create new comment
+                  await github.rest.issues.createComment({
+                    issue_number: context.issue.number,
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    body: commentBody
+                  });
+                  console.log('Created new API changes comment');
+                }
+              } else {
+                console.log('No API changes detected - skipping PR comment');
+
+                // Check if there's an existing comment to remove
+                const {data: comments} = await github.rest.issues.listComments({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.issue.number,
+                });
+
+                const COMMENT_MARKER = '<!-- API_CHANGES_REPORT -->';
+                const botComment = comments.find(comment => comment.body.includes(COMMENT_MARKER));
+
+                if (botComment) {
+                  await github.rest.issues.deleteComment({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    comment_id: botComment.id,
+                  });
+                  console.log('Deleted existing API changes comment (no changes detected)');
+                }
+              }
+            } catch (error) {
+              console.log('Could not post comment:', error);
+            }
 
       - name: Cleanup servers
         if: always()
@@ -603,4 +771,16 @@ jobs:
             kill $(cat /tmp/main-server.pid) || true
           fi
 
+      # - name: Upload API specifications and diffs
+      #   if: always()
+      #   uses: actions/upload-artifact@v4
+      #   with:
+      #     name: api-specifications-and-diffs
+      #     path: |
+      #       /tmp/main-server.log
+      #       /tmp/current-server.log
+      #       *-api.json
+      #       *-schema-introspection.json
+      #       *-diff.md
+      #       *-diff.json
 

.github/workflows/ci-create-app.yaml

@@ -25,7 +25,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     strategy:
       matrix:
         task: [lint, typecheck, test]
@@ -50,7 +50,7 @@ jobs:
   ci-create-app-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, create-app-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-docs.yaml

@@ -27,7 +27,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 10
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Cancel Previous Runs
         uses: styfle/[email protected]

.github/workflows/ci-emails.yaml

@@ -25,7 +25,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 10
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     steps:
       - name: Fetch custom Github Actions and base branch history
         uses: actions/checkout@v4
@@ -56,7 +56,7 @@ jobs:
   ci-emails-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, emails-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-front.yaml

@@ -14,8 +14,8 @@ concurrency:
 
 env:
   # restore-cache action adds 'v4-' prefix and '-<branch>-<sha>' suffix to the key
-  STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION: storybook-build-ubuntu-latest-8-cores-runner
-  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v4-storybook-build-ubuntu-latest-8-cores-runner-${{ github.ref_name }}-${{ github.sha }}
+  STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION: storybook-build-depot-ubuntu-24.04-8-runner
+  STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION: v4-storybook-build-depot-ubuntu-24.04-8-runner-${{ github.ref_name }}-${{ github.sha }}
 
 jobs:
   changed-files-check:
@@ -42,7 +42,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       REACT_APP_SERVER_BASE_URL: http://localhost:3000
     steps:
@@ -68,7 +68,7 @@ jobs:
           key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_SAVE_ACTION }}
   front-sb-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: front-sb-build
     strategy:
       fail-fast: false
@@ -115,7 +115,7 @@ jobs:
       #     path: packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
   # merge-reports-and-check-coverage:
   #   timeout-minutes: 30
-  #   runs-on: ubuntu-latest
+  #   runs-on: depot-ubuntu-24.04
   #   needs: front-sb-test
   #   env:
   #     PATH_TO_COVERAGE: packages/twenty-front/coverage/storybook
@@ -143,7 +143,7 @@ jobs:
     timeout-minutes: 30
     if: false
     needs: front-sb-build
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       REACT_APP_SERVER_BASE_URL: http://127.0.0.1:3000
       CHROMATIC_PROJECT_TOKEN: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
@@ -169,7 +169,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     env:
       NODE_OPTIONS: '--max-old-space-size=4096'
       TASK_CACHE_KEY: front-task-${{ matrix.task }}
@@ -211,7 +211,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     env:
       NODE_OPTIONS: "--max-old-space-size=10240"
     steps:
@@ -236,7 +236,7 @@ jobs:
       #     path: packages/twenty-front/build
       #     retention-days: 1
   e2e-test:
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check-e2e, front-build]
     if: |
       always() &&
@@ -349,7 +349,7 @@ jobs:
   ci-front-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs:
       [
         changed-files-check,
@@ -366,7 +366,7 @@ jobs:
   ci-e2e-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check-e2e, e2e-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-release-create.yaml

@@ -25,7 +25,7 @@ defaults:
 jobs:
   create_pr:
     timeout-minutes: 10
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/ci-release-merge.yaml

@@ -15,7 +15,7 @@ defaults:
 jobs:
   tag_and_release:
     timeout-minutes: 10
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     if: github.event.pull_request.merged == true && contains(github.event.pull_request.labels.*.name, 'release')
     steps:
       - name: Check PR Author

.github/workflows/ci-sdk.yaml

@@ -23,7 +23,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     strategy:
       matrix:
         task: [lint, typecheck, test:unit, storybook:build, storybook:test, test:integration]
@@ -50,7 +50,7 @@ jobs:
           tasks: ${{ matrix.task }}
   sdk-e2e-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: [changed-files-check, sdk-test]
     if: needs.changed-files-check.outputs.any_changed == 'true'
     services:
@@ -94,7 +94,7 @@ jobs:
   ci-sdk-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, sdk-test, sdk-e2e-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-server.yaml

@@ -31,7 +31,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -143,7 +143,7 @@ jobs:
           key: ${{ steps.restore-server-setup-cache.outputs.cache-primary-key }}
   server-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: server-setup
     steps:
       - name: Fetch custom Github Actions and base branch history
@@ -164,7 +164,7 @@ jobs:
 
   server-integration-test:
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
+    runs-on: depot-ubuntu-24.04-8
     needs: server-setup
     strategy:
       fail-fast: false
@@ -250,7 +250,7 @@ jobs:
   ci-server-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, server-setup, server-test, server-integration-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-shared.yaml

@@ -22,7 +22,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     env:
       NODE_OPTIONS: '--max-old-space-size=4096'
     strategy:
@@ -47,7 +47,7 @@ jobs:
   ci-shared-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, shared-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-test-docker-compose.yaml

@@ -23,7 +23,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -92,7 +92,7 @@ jobs:
   ci-test-docker-compose-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-utils.yaml

@@ -9,7 +9,10 @@ on:
     types: [opened, synchronize, reopened, closed]
 
 permissions:
+  actions: write
   checks: write
+  contents: write
+  issues: write
   pull-requests: write
   statuses: write
 
@@ -22,7 +25,7 @@ concurrency:
 jobs:
   danger-js:
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     if: github.event.action != 'closed'
     steps:
       - uses: actions/checkout@v4
@@ -35,7 +38,7 @@ jobs:
 
   congratulate:
     timeout-minutes: 3
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     if: github.event.action == 'closed' && github.event.pull_request.merged == true
     steps:
       - uses: actions/checkout@v4

.github/workflows/ci-website.yaml

@@ -23,7 +23,7 @@ jobs:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 10
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     services:
       postgres:
         image: twentycrm/twenty-postgres-spilo
@@ -65,7 +65,7 @@ jobs:
   ci-website-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, website-build]
     steps:
       - name: Fail job if any needs failed

.github/workflows/ci-zapier.yaml

@@ -1,9 +1,11 @@
 name: CI Zapier
 
 on:
-  pull_request:
+  push:
+    branches:
+      - main
 
-  merge_group:
+  pull_request:
 
 permissions:
   contents: read
@@ -12,9 +14,6 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
 
-env:
-  SERVER_SETUP_CACHE_KEY: server-setup
-
 jobs:
   changed-files-check:
     uses: ./.github/workflows/changed-files.yaml
@@ -24,81 +23,14 @@ jobs:
         packages/twenty-server/**
         !packages/twenty-zapier/package.json
         !packages/twenty-zapier/CHANGELOG.md
-  server-setup:
+  zapier-test:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
     timeout-minutes: 30
-    runs-on: ubuntu-latest-8-cores
-    services:
-      postgres:
-        image: twentycrm/twenty-postgres-spilo
-        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Build twenty-shared
-        run: npx nx build twenty-shared
-
-      - name: Server / Write .env
-        run: npx nx reset:env:e2e-testing-server twenty-server
-
-      - name: Server / Build
-        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: Server / Start
-        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: Start worker
-        run: |
-          npx nx run twenty-server:worker &
-          echo "Worker started"
-
-      - name: Zapier / Build
-        run: npx nx build twenty-zapier
-
-      - name: Zapier / Run Tests
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:zapier
-          tasks: test
-
-  zapier-test:
-    needs: server-setup
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     strategy:
       matrix:
-        task: [lint, typecheck, validate]
+        task: [lint, typecheck, test, validate]
     steps:
       - name: Cancel Previous Runs
         uses: styfle/[email protected]
@@ -120,7 +52,7 @@ jobs:
   ci-zapier-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     needs: [changed-files-check, zapier-test]
     steps:
       - name: Fail job if any needs failed

.github/workflows/claude.yml

@@ -23,7 +23,7 @@ jobs:
       (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude') && github.event.comment.user.type != 'Bot') ||
       (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude') && github.event.review.user.type != 'Bot') ||
       (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     timeout-minutes: 60
     permissions:
       contents: write
@@ -87,7 +87,7 @@ jobs:
             exit 0
           fi
           ISSUE_NUMBER="${{ github.event.issue.number || github.event.pull_request.number }}"
-          ENCODED_BRANCH=$(python3 -c "import urllib.parse, sys; print(urllib.parse.quote(sys.argv[1], safe=''))" "$BRANCH")
+          ENCODED_BRANCH=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$BRANCH', safe=''))")
           PR_URL="https://github.com/${{ github.repository }}/compare/main...${ENCODED_BRANCH}?quick_pull=1"
           BODY="⚠️ Claude ran out of turns before creating a PR. Work has been pushed to [\`$BRANCH\`](https://github.com/${{ github.repository }}/tree/$ENCODED_BRANCH).\n\n[**Create PR →**]($PR_URL)"
           if [ -n "$ISSUE_NUMBER" ]; then
@@ -96,7 +96,7 @@ jobs:
 
   claude-cross-repo:
     if: github.event_name == 'repository_dispatch'
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     timeout-minutes: 60
     permissions:
       contents: write
@@ -157,11 +157,18 @@ jobs:
                 "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
               }
             }
-      - name: Dispatch response to ci-privileged
+      - name: Post response to source issue
         if: always()
-        uses: peter-evans/repository-dispatch@v2
+        uses: actions/github-script@v7
         with:
-          token: ${{ secrets.CI_PRIVILEGED_DISPATCH_TOKEN }}
-          repository: twentyhq/ci-privileged
-          event-type: claude-cross-repo-response
-          client-payload: '{"repo": ${{ toJSON(steps.prompt.outputs.repo) }}, "issue_number": ${{ toJSON(steps.prompt.outputs.issue_number) }}, "run_id": ${{ toJSON(github.run_id) }}, "run_url": ${{ toJSON(format('{0}/{1}/actions/runs/{2}', github.server_url, github.repository, github.run_id)) }}}'
+          github-token: ${{ secrets.TWENTY_DISPATCH_TOKEN }}
+          script: |
+            const [owner, repo] = '${{ steps.prompt.outputs.repo }}'.split('/');
+            const issueNumber = parseInt('${{ steps.prompt.outputs.issue_number }}', 10);
+
+            await github.rest.issues.createComment({
+              owner,
+              repo,
+              issue_number: issueNumber,
+              body: `Claude finished processing this request. [See workflow run](${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId})`
+            });

.github/workflows/docs-i18n-pull.yaml

@@ -34,7 +34,7 @@ concurrency:
 jobs:
   pull_docs_translations:
     name: Pull docs translations
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/docs-i18n-push.yaml

@@ -21,7 +21,7 @@ concurrency:
 jobs:
   push_docs:
     name: Push documentation to Crowdin
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/i18n-pull.yaml

@@ -32,7 +32,7 @@ concurrency:
 jobs:
   pull_translations:
     name: Pull translations
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/i18n-push.yaml

@@ -17,7 +17,7 @@ concurrency:
 jobs:
   extract_translations:
     name: Extract and upload translations
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Checkout
         uses: actions/checkout@v4

.github/workflows/i18n-qa-report.yaml

@@ -0,0 +1,118 @@
+# Weekly translation QA report using Crowdin's native QA checks
+
+name: 'Weekly Translation QA Report'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+on:
+  schedule:
+    - cron: '0 9 * * 1' # Every Monday at 9am UTC
+  workflow_dispatch: # Allow manual trigger
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  qa_report:
+    name: Generate QA Report
+    runs-on: depot-ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+
+      - name: Build twenty-shared
+        run: npx nx build twenty-shared
+
+      - name: Generate QA report from Crowdin
+        id: generate_report
+        run: |
+          npx ts-node packages/twenty-utils/translation-qa-report.ts || true
+          if [ -f TRANSLATION_QA_REPORT.md ]; then
+            echo "report_generated=true" >> $GITHUB_OUTPUT
+            # Count critical issues (exclude spellcheck)
+            CRITICAL=$(grep -oP '⚠️\s+\K\d+' TRANSLATION_QA_REPORT.md 2>/dev/null || echo "0")
+            echo "critical_issues=$CRITICAL" >> $GITHUB_OUTPUT
+          else
+            echo "report_generated=false" >> $GITHUB_OUTPUT
+            echo "critical_issues=0" >> $GITHUB_OUTPUT
+          fi
+        env:
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+
+      - name: Create QA branch and commit report
+        if: steps.generate_report.outputs.report_generated == 'true'
+        run: |
+          git config --global user.name 'github-actions'
+          git config --global user.email '[email protected]'
+
+          BRANCH_NAME="i18n-qa-report-$(date +%Y-%m-%d)"
+          git checkout -B $BRANCH_NAME
+
+          git add TRANSLATION_QA_REPORT.md
+          if ! git diff --staged --quiet --exit-code; then
+            git commit -m "docs: weekly translation QA report"
+            git push origin HEAD:$BRANCH_NAME --force
+            echo "BRANCH_NAME=$BRANCH_NAME" >> $GITHUB_ENV
+          else
+            echo "No changes to commit"
+            echo "BRANCH_NAME=" >> $GITHUB_ENV
+          fi
+
+      - name: Create pull request
+        if: steps.generate_report.outputs.report_generated == 'true' && env.BRANCH_NAME != ''
+        run: |
+          CRITICAL="${{ steps.generate_report.outputs.critical_issues }}"
+
+          BODY=$(cat <<EOF
+          ## Weekly Translation QA Report
+
+          **Critical issues (excluding spellcheck): $CRITICAL**
+
+          📊 **View in Crowdin**: https://twenty.crowdin.com/u/projects/1/all?filter=qa-issue
+
+          ### For AI-Assisted Fixing
+
+          Open this PR in Cursor and say:
+
+          > "Fix the translation QA issues using the Crowdin API"
+
+          The AI can help fix:
+          - ✅ Variables mismatch (missing/wrong placeholders)
+          - ✅ Escaped Unicode sequences
+          - ⚠️ Tags mismatch
+          - ⚠️ Empty translations
+
+          ### Available Scripts
+
+          \`\`\`bash
+          # View QA report
+          CROWDIN_PERSONAL_TOKEN=xxx npx ts-node packages/twenty-utils/translation-qa-report.ts
+
+          # Fix encoding issues automatically
+          CROWDIN_PERSONAL_TOKEN=xxx npx ts-node packages/twenty-utils/fix-crowdin-translations.ts
+          \`\`\`
+
+          ---
+          *Close without merging after issues are addressed*
+          EOF
+          )
+
+          EXISTING_PR=$(gh pr list --head $BRANCH_NAME --json number --jq '.[0].number' 2>/dev/null || echo "")
+
+          if [ -n "$EXISTING_PR" ]; then
+            gh pr edit $EXISTING_PR --body "$BODY"
+          else
+            gh pr create \
+              --base main \
+              --head $BRANCH_NAME \
+              --title "i18n: Translation QA Report ($CRITICAL critical issues)" \
+              --body "$BODY" || true
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/post-ci-comments.yaml

@@ -1,71 +0,0 @@
-name: Post CI Comments
-
-on:
-  workflow_run:
-    workflows: ['GraphQL and OpenAPI Breaking Changes Detection']
-    types: [completed]
-
-permissions:
-  actions: read
-
-jobs:
-  dispatch-breaking-changes:
-    if: github.event.workflow_run.conclusion == 'success'
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    steps:
-      - name: Get PR number from workflow run
-        id: pr-info
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const runId = context.payload.workflow_run.id;
-            const headSha = context.payload.workflow_run.head_sha;
-            const headBranch = context.payload.workflow_run.head_branch;
-            const headRepo = context.payload.workflow_run.head_repository;
-
-            // workflow_run.pull_requests is empty for fork PRs,
-            // so fall back to searching by head SHA
-            let pullRequests = context.payload.workflow_run.pull_requests;
-            let prNumber;
-
-            if (pullRequests && pullRequests.length > 0) {
-              prNumber = pullRequests[0].number;
-            } else {
-              core.info(`pull_requests is empty (likely a fork PR), searching by SHA ${headSha}`);
-              const owner = context.repo.owner;
-              const repo = context.repo.repo;
-              const headLabel = `${headRepo.owner.login}:${headBranch}`;
-
-              const { data: prs } = await github.rest.pulls.list({
-                owner,
-                repo,
-                state: 'open',
-                head: headLabel,
-                per_page: 1,
-              });
-
-              if (prs.length > 0) {
-                prNumber = prs[0].number;
-              }
-            }
-
-            if (!prNumber) {
-              core.info('No pull request found for this workflow run');
-              core.setOutput('has_pr', 'false');
-              return;
-            }
-
-            core.setOutput('pr_number', prNumber);
-            core.setOutput('run_id', runId);
-            core.setOutput('has_pr', 'true');
-            core.info(`PR #${prNumber}, Run ID: ${runId}`);
-
-      - name: Dispatch to ci-privileged
-        if: steps.pr-info.outputs.has_pr == 'true'
-        uses: peter-evans/repository-dispatch@v2
-        with:
-          token: ${{ secrets.CI_PRIVILEGED_DISPATCH_TOKEN }}
-          repository: twentyhq/ci-privileged
-          event-type: breaking-changes-report
-          client-payload: '{"pr_number": ${{ toJSON(steps.pr-info.outputs.pr_number) }}, "run_id": ${{ toJSON(steps.pr-info.outputs.run_id) }}, "repo": ${{ toJSON(github.repository) }}, "branch_state": ${{ toJSON(github.event.workflow_run.head_branch) }}}'

.github/workflows/preview-env-dispatch.yaml

@@ -2,8 +2,13 @@ name: 'Preview Environment Dispatch'
 
 permissions:
   contents: write
+  actions: write
+  pull-requests: read
 
 on:
+  # Using pull_request_target instead of pull_request to have access to secrets for external contributors
+  # Security note: This is safe because we're only using the repository-dispatch action with limited scope
+  # and not checking out or running any code from the external contributor's PR
   pull_request_target:
     types: [opened, synchronize, reopened, labeled]
     paths:
@@ -19,21 +24,9 @@ concurrency:
 
 jobs:
   trigger-preview:
-    if: |
-      (github.event.action == 'labeled' && github.event.label.name == 'preview-app') ||
-      (
-        (
-          github.event.pull_request.author_association == 'MEMBER' ||
-          github.event.pull_request.author_association == 'OWNER' ||
-          github.event.pull_request.author_association == 'COLLABORATOR'
-        ) && (
-          github.event.action == 'opened' ||
-          github.event.action == 'synchronize' ||
-          github.event.action == 'reopened'
-        )
-      )
+    if: github.event.action == 'opened' || github.event.action == 'synchronize' || github.event.action == 'reopened' || (github.event.action == 'labeled' && github.event.label.name == 'preview-app')
     timeout-minutes: 5
-    runs-on: ubuntu-latest
+    runs-on: depot-ubuntu-24.04
     steps:
       - name: Trigger preview environment workflow
         uses: peter-evans/repository-dispatch@v2
@@ -42,11 +35,3 @@ jobs:
           repository: ${{ github.repository }}
           event-type: preview-environment
           client-payload: '{"pr_number": "${{ github.event.pull_request.number }}", "pr_head_sha": "${{ github.event.pull_request.head.sha }}", "repo_full_name": "${{ github.repository }}"}'
-
-      - name: Dispatch to ci-privileged for PR comment
-        uses: peter-evans/repository-dispatch@v2
-        with:
-          token: ${{ secrets.CI_PRIVILEGED_DISPATCH_TOKEN }}
-          repository: twentyhq/ci-privileged
-          event-type: preview-env-url
-          client-payload: '{"pr_number": ${{ toJSON(github.event.pull_request.number) }}, "keepalive_dispatch_time": ${{ toJSON(github.event.pull_request.updated_at) }}, "repo": ${{ toJSON(github.repository) }}}'

.github/workflows/preview-env-keepalive.yaml

@@ -2,6 +2,7 @@ name: 'Preview Environment Keep Alive'
 
 permissions:
   contents: read
+  pull-requests: write
 
 on:
   repository_dispatch:
@@ -54,15 +55,14 @@ jobs:
           port: 3000
 
       - name: Start services with correct SERVER_URL
-        env:
-          TUNNEL_URL: ${{ steps.expose-tunnel.outputs.tunnel-url }}
         run: |
           cd packages/twenty-docker/
 
-          echo "Setting SERVER_URL to $TUNNEL_URL"
+          # Update the SERVER_URL with the tunnel URL
+          echo "Setting SERVER_URL to ${{ steps.expose-tunnel.outputs.tunnel-url }}"
           sed -i '/SERVER_URL=/d' .env
           echo "" >> .env
-          echo "SERVER_URL=$TUNNEL_URL" >> .env
+          echo "SERVER_URL=${{ steps.expose-tunnel.outputs.tunnel-url }}" >> .env
 
           # Start the services
           echo "Docker compose up..."
@@ -99,26 +99,54 @@ jobs:
           fi
         working-directory: ./
 
-      - name: Output tunnel URL
-        env:
-          TUNNEL_URL: ${{ steps.expose-tunnel.outputs.tunnel-url }}
+      - name: Output tunnel URL to logs
         run: |
           echo "✅ Preview Environment Ready!"
-          echo "🔗 Preview URL: $TUNNEL_URL"
+          echo "🔗 Preview URL: ${{ steps.expose-tunnel.outputs.tunnel-url }}"
           echo "⏱️ This environment will be available for 5 hours"
-          echo "## 🚀 Preview Environment Ready!" >> "$GITHUB_STEP_SUMMARY"
-          echo "" >> "$GITHUB_STEP_SUMMARY"
-          echo "Preview URL: $TUNNEL_URL" >> "$GITHUB_STEP_SUMMARY"
-          echo "" >> "$GITHUB_STEP_SUMMARY"
-          echo "This environment will automatically shut down after 5 hours." >> "$GITHUB_STEP_SUMMARY"
-          echo "$TUNNEL_URL" > tunnel-url.txt
 
-      - name: Upload tunnel URL artifact
-        uses: actions/upload-artifact@v4
+      - name: Post comment on PR
+        uses: actions/github-script@v6
         with:
-          name: tunnel-url
-          path: tunnel-url.txt
-          retention-days: 1
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            const COMMENT_MARKER = '<!-- PR_PREVIEW_ENV -->';
+            const commentBody = `${COMMENT_MARKER}
+            🚀 **Preview Environment Ready!**
+
+            Your preview environment is available at: ${{ steps.expose-tunnel.outputs.tunnel-url }}
+
+            This environment will automatically shut down when the PR is closed or after 5 hours.`;
+
+            // Get all comments
+            const {data: comments} = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: ${{ github.event.client_payload.pr_number }},
+            });
+
+            // Find our comment
+            const botComment = comments.find(comment => comment.body.includes(COMMENT_MARKER));
+
+            if (botComment) {
+              // Update existing comment
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: commentBody
+              });
+              console.log('Updated existing comment');
+            } else {
+              // Create new comment
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: ${{ github.event.client_payload.pr_number }},
+                body: commentBody
+              });
+              console.log('Created new comment');
+            }
 
       - name: Keep tunnel alive for 5 hours
         run: timeout 300m sleep 18000 # Stop on whichever we reach first (300m or 5hour sleep)

.yarn/patches/@wyw-in-js-transform-npm-0.7.0-ba641dc99f.patch

@@ -1,58 +0,0 @@
-diff --git a/esm/cache.js b/esm/cache.js
-index 07cf6d7dd99effb9c3464b620ba67a7f445224f5..248bb527923499a6be8065ee7a3613b55819c58c 100644
---- a/esm/cache.js
-+++ b/esm/cache.js
-@@ -69,17 +69,20 @@ export class TransformCacheCollection {
-       this.invalidate(cacheName, filename);
-     });
-   }
--  invalidateIfChanged(filename, content) {
-+  invalidateIfChanged(filename, content, _visited) {
-+    const visited = _visited || new Set();
-+    if (visited.has(filename)) {
-+      return false;
-+    }
-+    visited.add(filename);
-     const fileEntrypoint = this.get('entrypoints', filename);
- 
--    // We need to check all dependencies of the file
--    // because they might have changed as well.
-     if (fileEntrypoint) {
-       for (const [, dependency] of fileEntrypoint.dependencies) {
-         const dependencyFilename = dependency.resolved;
-         if (dependencyFilename) {
-           const dependencyContent = fs.readFileSync(dependencyFilename, 'utf8');
--          this.invalidateIfChanged(dependencyFilename, dependencyContent);
-+          this.invalidateIfChanged(dependencyFilename, dependencyContent, visited);
-         }
-       }
-     }
-diff --git a/lib/cache.js b/lib/cache.js
-index 0762ed7d3c39b31000f7aa7d8156da15403c8e64..6955410cd3c9ec53cf7a01c8346abc4c47fff791 100644
---- a/lib/cache.js
-+++ b/lib/cache.js
-@@ -77,17 +77,20 @@ class TransformCacheCollection {
-       this.invalidate(cacheName, filename);
-     });
-   }
--  invalidateIfChanged(filename, content) {
-+  invalidateIfChanged(filename, content, _visited) {
-+    const visited = _visited || new Set();
-+    if (visited.has(filename)) {
-+      return false;
-+    }
-+    visited.add(filename);
-     const fileEntrypoint = this.get('entrypoints', filename);
- 
--    // We need to check all dependencies of the file
--    // because they might have changed as well.
-     if (fileEntrypoint) {
-       for (const [, dependency] of fileEntrypoint.dependencies) {
-         const dependencyFilename = dependency.resolved;
-         if (dependencyFilename) {
-           const dependencyContent = _nodeFs.default.readFileSync(dependencyFilename, 'utf8');
--          this.invalidateIfChanged(dependencyFilename, dependencyContent);
-+          this.invalidateIfChanged(dependencyFilename, dependencyContent, visited);
-         }
-       }
-     }

CLAUDE.md

@@ -90,7 +90,7 @@ npx nx run twenty-front:graphql:generate --configuration=metadata
 ## Architecture Overview
 
 ### Tech Stack
-- **Frontend**: React 18, TypeScript, Jotai (state management), Linaria (styling), Vite
+- **Frontend**: React 18, TypeScript, Jotai (state management), Emotion (styling), Vite
 - **Backend**: NestJS, TypeORM, PostgreSQL, Redis, GraphQL (with GraphQL Yoga)
 - **Monorepo**: Nx workspace managed with Yarn 4
 
@@ -175,7 +175,7 @@ IMPORTANT: Use Context7 for code generation, setup or configuration steps, or li
 5. Run `graphql:generate` after any GraphQL schema changes
 
 ### Code Style Notes
-- Use **Linaria** for styling with zero-runtime CSS-in-JS (styled-components pattern)
+- Use **Emotion** for styling with styled-components pattern
 - Follow **Nx** workspace conventions for imports
 - Use **Lingui** for internationalization
 - Apply security first, then formatting (sanitize before format)

README.md

@@ -109,7 +109,7 @@ Below are a few features we have implemented to date:
 - [TypeScript](https://www.typescriptlang.org/)
 - [Nx](https://nx.dev/)
 - [NestJS](https://nestjs.com/), with [BullMQ](https://bullmq.io/), [PostgreSQL](https://www.postgresql.org/), [Redis](https://redis.io/)
-- [React](https://reactjs.org/), with [Jotai](https://jotai.org/), [Linaria](https://linaria.dev/) and [Lingui](https://lingui.dev/)
+- [React](https://reactjs.org/), with [Jotai](https://jotai.org/), [Emotion](https://emotion.sh/) and [Lingui](https://lingui.dev/)
 
 
 

nx.json

@@ -276,7 +276,7 @@
   "generators": {
     "@nx/react": {
       "application": {
-        "style": "@linaria/react",
+        "style": "@emotion/styled",
         "linter": "eslint",
         "bundler": "vite",
         "compiler": "swc",
@@ -284,7 +284,7 @@
         "projectNameAndRootFormat": "derived"
       },
       "library": {
-        "style": "@linaria/react",
+        "style": "@emotion/styled",
         "linter": "eslint",
         "bundler": "vite",
         "compiler": "swc",
@@ -292,7 +292,7 @@
         "projectNameAndRootFormat": "derived"
       },
       "component": {
-        "style": "@linaria/react"
+        "style": "@emotion/styled"
       }
     }
   },

package.json

@@ -2,13 +2,14 @@
   "private": true,
   "dependencies": {
     "@apollo/client": "^3.7.17",
+    "@emotion/react": "^11.11.1",
+    "@emotion/styled": "^11.11.0",
     "@floating-ui/react": "^0.24.3",
     "@linaria/core": "^6.2.0",
     "@linaria/react": "^6.2.1",
     "@radix-ui/colors": "^3.0.0",
     "@sniptt/guards": "^0.2.0",
     "@tabler/icons-react": "^3.31.0",
-    "@wyw-in-js/babel-preset": "^1.0.6",
     "@wyw-in-js/vite": "^0.7.0",
     "archiver": "^7.0.1",
     "danger-plugin-todos": "^1.3.1",
@@ -40,7 +41,6 @@
     "lodash.snakecase": "^4.1.1",
     "lodash.upperfirst": "^4.3.1",
     "microdiff": "^1.3.2",
-    "next-with-linaria": "^1.3.0",
     "planer": "^1.2.0",
     "pluralize": "^8.0.0",
     "react": "^18.2.0",
@@ -83,11 +83,11 @@
     "@sentry/types": "^8",
     "@storybook-community/storybook-addon-cookie": "^5.0.0",
     "@storybook/addon-coverage": "^3.0.0",
-    "@storybook/addon-docs": "^10.2.13",
-    "@storybook/addon-links": "^10.2.13",
-    "@storybook/addon-vitest": "^10.2.13",
+    "@storybook/addon-docs": "^10.1.11",
+    "@storybook/addon-links": "^10.1.11",
+    "@storybook/addon-vitest": "^10.1.11",
     "@storybook/icons": "^2.0.1",
-    "@storybook/react-vite": "^10.2.13",
+    "@storybook/react-vite": "^10.1.11",
     "@storybook/test-runner": "^0.24.2",
     "@stylistic/eslint-plugin": "^1.5.0",
     "@swc-node/register": "1.11.1",
@@ -159,7 +159,7 @@
     "eslint-plugin-react-hooks": "^5.0.0",
     "eslint-plugin-react-refresh": "^0.4.4",
     "eslint-plugin-simple-import-sort": "^10.0.0",
-    "eslint-plugin-storybook": "^10.2.13",
+    "eslint-plugin-storybook": "^10.1.11",
     "eslint-plugin-unicorn": "^56.0.1",
     "eslint-plugin-unused-imports": "^3.0.0",
     "http-server": "^14.1.1",
@@ -175,9 +175,9 @@
     "raw-loader": "^4.0.2",
     "rimraf": "^5.0.5",
     "source-map-support": "^0.5.20",
-    "storybook": "^10.2.13",
+    "storybook": "^10.1.11",
     "storybook-addon-mock-date": "2.0.0",
-    "storybook-addon-pseudo-states": "^10.2.13",
+    "storybook-addon-pseudo-states": "^10.1.11",
     "supertest": "^6.1.3",
     "ts-jest": "^29.1.1",
     "ts-loader": "^9.2.3",
@@ -201,10 +201,10 @@
     "type-fest": "4.10.1",
     "typescript": "5.9.2",
     "graphql-redis-subscriptions/ioredis": "^5.6.0",
+    "prosemirror-view": "1.40.0",
+    "prosemirror-transform": "1.10.4",
     "@lingui/core": "5.1.2",
-    "@types/qs": "6.9.16",
-    "@wyw-in-js/transform@npm:0.6.0": "patch:@wyw-in-js/transform@npm%3A0.7.0#~/.yarn/patches/@wyw-in-js-transform-npm-0.7.0-ba641dc99f.patch",
-    "@wyw-in-js/transform@npm:0.7.0": "patch:@wyw-in-js/transform@npm%3A0.7.0#~/.yarn/patches/@wyw-in-js-transform-npm-0.7.0-ba641dc99f.patch"
+    "@types/qs": "6.9.16"
   },
   "version": "0.2.1",
   "nx": {},

packages/create-twenty-app/README.md

@@ -50,9 +50,6 @@ yarn twenty function:logs
 # Execute a function with a JSON payload
 yarn twenty function:execute -n my-function -p '{"key": "value"}'
 
-# Execute the pre-install function
-yarn twenty function:execute --preInstall
-
 # Execute the post-install function
 yarn twenty function:execute --postInstall
 
@@ -95,7 +92,6 @@ In interactive mode, you can pick from:
 **Core files (always created):**
 - `application-config.ts` — Application metadata configuration
 - `roles/default-role.ts` — Default role for logic functions
-- `logic-functions/pre-install.ts` — Pre-install logic function (runs before app installation)
 - `logic-functions/post-install.ts` — Post-install logic function (runs after app installation)
 - TypeScript configuration, ESLint, package.json, .gitignore
 - A prewired `twenty` script that delegates to the `twenty` CLI from twenty-sdk

packages/create-twenty-app/jest.config.mjs

@@ -15,7 +15,6 @@ const jestConfig = {
   },
   moduleNameMapper: {
     '^@/(.*)$': '<rootDir>/src/$1',
-    '^package.json$': '<rootDir>/package.json',
   },
   moduleFileExtensions: ['ts', 'js'],
   extensionsToTreatAsEsm: ['.ts'],

packages/create-twenty-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-twenty-app",
-  "version": "0.6.3",
+  "version": "0.6.1",
   "description": "Command-line interface to create Twenty application",
   "main": "dist/cli.cjs",
   "bin": "dist/cli.cjs",

packages/create-twenty-app/src/constants/base-application/LLMS.md

@@ -3,9 +3,6 @@
 - Documentation: https://docs.twenty.com/developers/extend/capabilities/apps
 - Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-sdk/src/cli/__tests__/apps/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.

packages/create-twenty-app/src/utils/__tests__/app-template.spec.ts

@@ -4,8 +4,8 @@ import { copyBaseApplicationProject } from '@/utils/app-template';
 import * as fs from 'fs-extra';
 import { tmpdir } from 'os';
 import { join } from 'path';
-import createTwentyAppPackageJson from 'package.json';
 
+// Mock fs-extra's copy function to skip copying base template (not available during tests)
 jest.mock('fs-extra', () => {
   const actual = jest.requireActual('fs-extra');
   return {
@@ -41,6 +41,7 @@ describe('copyBaseApplicationProject', () => {
   let testAppDirectory: string;
 
   beforeEach(async () => {
+    // Create a unique temp directory for each test
     testAppDirectory = join(
       tmpdir(),
       `test-twenty-app-${Date.now()}-${Math.random().toString(36).slice(2)}`,
@@ -50,6 +51,7 @@ describe('copyBaseApplicationProject', () => {
   });
 
   afterEach(async () => {
+    // Clean up temp directory after each test
     if (testAppDirectory && (await fs.pathExists(testAppDirectory))) {
       await fs.remove(testAppDirectory);
     }
@@ -64,12 +66,15 @@ describe('copyBaseApplicationProject', () => {
       exampleOptions: ALL_EXAMPLES,
     });
 
+    // Verify src/ folder exists
     const srcAppPath = join(testAppDirectory, 'src');
     expect(await fs.pathExists(srcAppPath)).toBe(true);
 
+    // Verify application-config.ts exists in src/
     const appConfigPath = join(srcAppPath, APPLICATION_FILE_NAME);
     expect(await fs.pathExists(appConfigPath)).toBe(true);
 
+    // Verify default-role.ts exists in src/
     const roleConfigPath = join(srcAppPath, 'roles', DEFAULT_ROLE_FILE_NAME);
     expect(await fs.pathExists(roleConfigPath)).toBe(true);
   });
@@ -89,9 +94,7 @@ describe('copyBaseApplicationProject', () => {
     const packageJson = await fs.readJson(packageJsonPath);
     expect(packageJson.name).toBe('my-test-app');
     expect(packageJson.version).toBe('0.1.0');
-    expect(packageJson.devDependencies['twenty-sdk']).toBe(
-      createTwentyAppPackageJson.version,
-    );
+    expect(packageJson.dependencies['twenty-sdk']).toBe('latest');
     expect(packageJson.scripts['twenty']).toBe('twenty');
   });
 
@@ -140,25 +143,34 @@ describe('copyBaseApplicationProject', () => {
     const appConfigPath = join(testAppDirectory, 'src', APPLICATION_FILE_NAME);
     const appConfigContent = await fs.readFile(appConfigPath, 'utf8');
 
+    // Verify it uses defineApplication
     expect(appConfigContent).toContain(
       "import { defineApplication } from 'twenty-sdk'",
     );
     expect(appConfigContent).toContain('export default defineApplication({');
 
+    // Verify it imports the role identifier
     expect(appConfigContent).toContain(
       "import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role'",
     );
 
+    // Verify display name and description
     expect(appConfigContent).toContain("displayName: 'My Test App'");
     expect(appConfigContent).toContain("description: 'A test application'");
 
+    // Verify it has a universalIdentifier (UUID format)
     expect(appConfigContent).toMatch(
       /universalIdentifier: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'/,
     );
 
+    // Verify it references the role
     expect(appConfigContent).toContain(
       'defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER',
     );
+
+    // Verify it includes serverVariables example
+    expect(appConfigContent).toContain('serverVariables:');
+    expect(appConfigContent).toContain('EXAMPLE_API_KEY');
   });
 
   it('should create default-role.ts with defineRole and correct values', async () => {
@@ -178,24 +190,29 @@ describe('copyBaseApplicationProject', () => {
     );
     const roleConfigContent = await fs.readFile(roleConfigPath, 'utf8');
 
+    // Verify it uses defineRole
     expect(roleConfigContent).toContain(
       "import { defineRole } from 'twenty-sdk'",
     );
     expect(roleConfigContent).toContain('export default defineRole({');
 
+    // Verify it exports the universal identifier constant
     expect(roleConfigContent).toContain(
       'export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER',
     );
 
+    // Verify role label includes app name
     expect(roleConfigContent).toContain(
       "label: 'My Test App default function role'",
     );
 
+    // Verify default permissions
     expect(roleConfigContent).toContain('canReadAllObjectRecords: true');
     expect(roleConfigContent).toContain('canUpdateAllObjectRecords: true');
     expect(roleConfigContent).toContain('canSoftDeleteAllObjectRecords: true');
     expect(roleConfigContent).toContain('canDestroyAllObjectRecords: false');
 
+    // Verify it has a universalIdentifier (UUID format)
     expect(roleConfigContent).toMatch(
       /universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER/,
     );
@@ -210,6 +227,7 @@ describe('copyBaseApplicationProject', () => {
       exampleOptions: ALL_EXAMPLES,
     });
 
+    // Verify fs.copy was called with correct destination
     expect(fs.copy).toHaveBeenCalledTimes(1);
     expect(fs.copy).toHaveBeenCalledWith(
       expect.stringContaining('base-application'),
@@ -233,6 +251,7 @@ describe('copyBaseApplicationProject', () => {
   });
 
   it('should generate unique UUIDs for each application', async () => {
+    // Create first app
     const firstAppDir = join(testAppDirectory, 'app1');
     await fs.ensureDir(firstAppDir);
     await copyBaseApplicationProject({
@@ -243,6 +262,7 @@ describe('copyBaseApplicationProject', () => {
       exampleOptions: ALL_EXAMPLES,
     });
 
+    // Create second app
     const secondAppDir = join(testAppDirectory, 'app2');
     await fs.ensureDir(secondAppDir);
     await copyBaseApplicationProject({
@@ -253,6 +273,7 @@ describe('copyBaseApplicationProject', () => {
       exampleOptions: ALL_EXAMPLES,
     });
 
+    // Read both app configs
     const firstAppConfig = await fs.readFile(
       join(firstAppDir, 'src', APPLICATION_FILE_NAME),
       'utf8',
@@ -262,6 +283,7 @@ describe('copyBaseApplicationProject', () => {
       'utf8',
     );
 
+    // Extract UUIDs using regex
     const uuidRegex =
       /universalIdentifier: '([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})'/;
     const firstUuid = firstAppConfig.match(uuidRegex)?.[1];
@@ -273,6 +295,7 @@ describe('copyBaseApplicationProject', () => {
   });
 
   it('should generate unique role UUIDs for each application', async () => {
+    // Create first app
     const firstAppDir = join(testAppDirectory, 'app1');
     await fs.ensureDir(firstAppDir);
     await copyBaseApplicationProject({
@@ -283,6 +306,7 @@ describe('copyBaseApplicationProject', () => {
       exampleOptions: ALL_EXAMPLES,
     });
 
+    // Create second app
     const secondAppDir = join(testAppDirectory, 'app2');
     await fs.ensureDir(secondAppDir);
     await copyBaseApplicationProject({
@@ -303,6 +327,7 @@ describe('copyBaseApplicationProject', () => {
       'utf8',
     );
 
+    // Extract UUIDs using regex
     const uuidRegex =
       /DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =\s*'([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})'/;
     const firstUuid = firstRoleConfig.match(uuidRegex)?.[1];
@@ -354,18 +379,6 @@ describe('copyBaseApplicationProject', () => {
             ),
           ),
         ).toBe(true);
-
-        // Install functions should always exist
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'pre-install.ts'),
-          ),
-        ).toBe(true);
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'post-install.ts'),
-          ),
-        ).toBe(true);
       });
     });
 
@@ -381,6 +394,7 @@ describe('copyBaseApplicationProject', () => {
 
         const srcPath = join(testAppDirectory, 'src');
 
+        // Core files should exist
         expect(await fs.pathExists(join(srcPath, APPLICATION_FILE_NAME))).toBe(
           true,
         );
@@ -388,18 +402,7 @@ describe('copyBaseApplicationProject', () => {
           await fs.pathExists(join(srcPath, 'roles', DEFAULT_ROLE_FILE_NAME)),
         ).toBe(true);
 
-        // Install functions should always exist (not gated by exampleOptions)
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'pre-install.ts'),
-          ),
-        ).toBe(true);
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'post-install.ts'),
-          ),
-        ).toBe(true);
-
+        // Example files should not exist
         expect(
           await fs.pathExists(join(srcPath, 'objects', 'example-object.ts')),
         ).toBe(false);
@@ -677,124 +680,4 @@ describe('copyBaseApplicationProject', () => {
       expect(content).toContain('position: 0');
     });
   });
-
-  describe('pre-install logic function', () => {
-    it('should create pre-install.ts with definePreInstallLogicFunction and typed payload', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const preInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'pre-install.ts',
-      );
-
-      expect(await fs.pathExists(preInstallPath)).toBe(true);
-
-      const content = await fs.readFile(preInstallPath, 'utf8');
-
-      expect(content).toContain(
-        "import { definePreInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk'",
-      );
-      expect(content).toContain(
-        'export default definePreInstallLogicFunction({',
-      );
-      expect(content).toContain("name: 'pre-install'");
-      expect(content).toContain('timeoutSeconds: 300');
-      expect(content).toContain(
-        'const handler = async (payload: InstallLogicFunctionPayload): Promise<void>',
-      );
-      expect(content).toContain('payload.previousVersion');
-
-      // Verify it has a universalIdentifier (UUID format)
-      expect(content).toMatch(
-        /universalIdentifier: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'/,
-      );
-    });
-
-    it('should always create pre-install.ts regardless of example options', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const preInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'pre-install.ts',
-      );
-
-      expect(await fs.pathExists(preInstallPath)).toBe(true);
-    });
-  });
-
-  describe('post-install logic function', () => {
-    it('should create post-install.ts with definePostInstallLogicFunction and typed payload', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const postInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'post-install.ts',
-      );
-
-      expect(await fs.pathExists(postInstallPath)).toBe(true);
-
-      const content = await fs.readFile(postInstallPath, 'utf8');
-
-      expect(content).toContain(
-        "import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk'",
-      );
-      expect(content).toContain(
-        'export default definePostInstallLogicFunction({',
-      );
-      expect(content).toContain("name: 'post-install'");
-      expect(content).toContain('timeoutSeconds: 300');
-      expect(content).toContain(
-        'const handler = async (payload: InstallLogicFunctionPayload): Promise<void>',
-      );
-      expect(content).toContain('payload.previousVersion');
-
-      // Verify it has a universalIdentifier (UUID format)
-      expect(content).toMatch(
-        /universalIdentifier: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'/,
-      );
-    });
-
-    it('should always create post-install.ts regardless of example options', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const postInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'post-install.ts',
-      );
-
-      expect(await fs.pathExists(postInstallPath)).toBe(true);
-    });
-  });
 });

packages/create-twenty-app/src/utils/app-template.ts

@@ -4,7 +4,6 @@ import { v4 } from 'uuid';
 import { ASSETS_DIR } from 'twenty-shared/application';
 
 import { type ExampleOptions } from '@/types/scaffolding-options';
-import createTwentyAppPackageJson from 'package.json';
 
 const SRC_FOLDER = 'src';
 
@@ -98,12 +97,6 @@ export const copyBaseApplicationProject = async ({
     });
   }
 
-  await createDefaultPreInstallFunction({
-    appDirectory: sourceFolderPath,
-    fileFolder: 'logic-functions',
-    fileName: 'pre-install.ts',
-  });
-
   await createDefaultPostInstallFunction({
     appDirectory: sourceFolderPath,
     fileFolder: 'logic-functions',
@@ -147,7 +140,8 @@ generated
 # dev
 /dist/
 
-.twenty
+.twenty/*
+!.twenty/output/
 
 # production
 /build
@@ -274,36 +268,6 @@ export default defineLogicFunction({
   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,
@@ -315,14 +279,16 @@ const createDefaultPostInstallFunction = async ({
 }) => {
   const universalIdentifier = v4();
 
-  const content = `import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+  const content = `import { defineLogicFunction } from 'twenty-sdk';
 
-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Post install logic function executed successfully!', payload.previousVersion);
+export const POST_INSTALL_UNIVERSAL_IDENTIFIER = '${universalIdentifier}';
+
+const handler = async (): Promise<void> => {
+  console.log('Post install logic function executed successfully!');
 };
 
-export default definePostInstallLogicFunction({
-  universalIdentifier: '${universalIdentifier}',
+export default defineLogicFunction({
+  universalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
   name: 'post-install',
   description: 'Runs after installation to set up the application.',
   timeoutSeconds: 300,
@@ -511,12 +477,21 @@ const createApplicationConfig = async ({
 }) => {
   const content = `import { defineApplication } from 'twenty-sdk';
 import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';
 
 export default defineApplication({
   universalIdentifier: '${v4()}',
   displayName: '${displayName}',
   description: '${description ?? ''}',
   defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
+  serverVariables: {
+    EXAMPLE_API_KEY: {
+      description: 'An example API key for a third-party service',
+      isSecret: true,
+      isRequired: false,
+    },
+  },
 });
 `;
 
@@ -546,9 +521,10 @@ const createPackageJson = async ({
       lint: 'eslint',
       'lint:fix': 'eslint --fix',
     },
-    dependencies: {},
+    dependencies: {
+      'twenty-sdk': 'latest',
+    },
     devDependencies: {
-      'twenty-sdk': createTwentyAppPackageJson.version,
       typescript: '^5.9.3',
       '@types/node': '^24.7.2',
       '@types/react': '^18.2.0',

packages/create-twenty-app/tsconfig.json

@@ -11,8 +11,7 @@
     "noEmit": true,
     "types": ["jest", "node"],
     "paths": {
-      "@/*": ["./src/*"],
-      "package.json": ["./package.json"]
+      "@/*": ["./src/*"]
     },
     "jsx": "react"
   },

packages/twenty-apps/community/apollo-enrich/.gitignore

@@ -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/*
-!.twenty/output/
-
-# 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

packages/twenty-apps/community/apollo-enrich/.nvmrc

@@ -1 +0,0 @@
-24.5.0

packages/twenty-apps/community/apollo-enrich/.yarnrc.yml

@@ -1 +0,0 @@
-nodeLinker: node-modules

packages/twenty-apps/community/apollo-enrich/LLMS.md

@@ -1,12 +0,0 @@
-## Base documentation
-
-- Documentation: https://docs.twenty.com/developers/extend/capabilities/apps
-- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-sdk/src/cli/__tests__/apps/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.

packages/twenty-apps/community/apollo-enrich/README.md

@@ -1,51 +0,0 @@
-This is a [Twenty](https://twenty.com) application project bootstrapped with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app).
-
-## Getting Started
-
-First, authenticate to your workspace:
-
-```bash
-yarn twenty auth:login
-```
-
-Then, start development mode to sync your app and watch for changes:
-
-```bash
-yarn twenty app:dev
-```
-
-Open your Twenty instance and go to `/settings/applications` section to see the result.
-
-## Available Commands
-
-Run `yarn twenty help` to list all available commands. Common commands:
-
-```bash
-# Authentication
-yarn twenty auth:login     # Authenticate with Twenty
-yarn twenty auth:logout    # Remove credentials
-yarn twenty auth:status    # Check auth status
-yarn twenty auth:switch    # Switch default workspace
-yarn twenty auth:list      # List all configured workspaces
-
-# Application
-yarn twenty app:dev        # Start dev mode (watch, build, sync, and auto-generate typed client)
-yarn twenty entity:add     # Add a new entity (object, field, function, front-component, role, view, navigation-menu-item)
-yarn twenty function:logs  # Stream function logs
-yarn twenty function:execute  # Execute a function with JSON payload
-yarn twenty app:uninstall  # Uninstall app from workspace
-```
-
-## LLMs instructions
-
-Main docs and pitfalls are available in LLMS.md file.
-
-## Learn More
-
-To learn more about Twenty applications, take a look at the following resources:
-
-- [twenty-sdk](https://www.npmjs.com/package/twenty-sdk) - learn about `twenty-sdk` tool.
-- [Twenty doc](https://docs.twenty.com/) - Twenty's documentation.
-- Join our [Discord](https://discord.gg/cx5n4Jzs57)
-
-You can check out [the Twenty GitHub repository](https://github.com/twentyhq/twenty) - your feedback and contributions are welcome!

packages/twenty-apps/community/apollo-enrich/eslint.config.mjs

@@ -1,29 +0,0 @@
-import js from '@eslint/js';
-import tseslint from 'typescript-eslint';
-
-export default [
-  // Base JS recommended rules
-  js.configs.recommended,
-
-  // TypeScript recommended rules
-  ...tseslint.configs.recommended,
-
-  {
-    files: ['**/*.ts', '**/*.tsx'],
-    languageOptions: {
-      parserOptions: {
-        project: true,
-        tsconfigRootDir: import.meta.dirname,
-      },
-    },
-    rules: {
-      // Common TypeScript-friendly tweaks
-      '@typescript-eslint/no-unused-vars': [
-        'warn',
-        { argsIgnorePattern: '^_' },
-      ],
-      '@typescript-eslint/no-explicit-any': 'off',
-      'no-unused-vars': 'off', // handled by TS rule
-    },
-  },
-];

packages/twenty-apps/community/apollo-enrich/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "apollo-enrich",
-  "version": "0.1.0",
-  "license": "MIT",
-  "engines": {
-    "node": "^24.5.0",
-    "npm": "please-use-yarn",
-    "yarn": ">=4.0.2"
-  },
-  "packageManager": "[email protected]",
-  "scripts": {
-    "twenty": "twenty",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix"
-  },
-  "dependencies": {
-    "twenty-sdk": "latest"
-  },
-  "devDependencies": {
-    "@types/node": "^24.7.2",
-    "@types/react": "^18.2.0",
-    "eslint": "^9.32.0",
-    "react": "^18.2.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.0"
-  }
-}

packages/twenty-apps/community/apollo-enrich/src/application-config.ts

@@ -1,54 +0,0 @@
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
-import { defineApplication } from 'twenty-sdk';
-
-export default defineApplication({
-  universalIdentifier: 'ac1d2ed1-8835-4bd4-9043-28b46fdda465',
-  displayName: 'Apollo enrichment',
-  description: 'Data enrichment with Apollo to keep your data accurate',
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-  settingsCustomTabFrontComponentUniversalIdentifier: '50d59f7c-eada-4731-aacd-8e45371e1040',
-  applicationVariables: {
-    APOLLO_CLIENT_ID: {
-      universalIdentifier: '5852219e-7757-463e-9e7c-80980203794c',
-      isSecret: true,
-      value: '',
-      description: 'Apollo Client ID',
-    },
-    APOLLO_CLIENT_SECRET: {
-      universalIdentifier: 'a032349d-9458-4381-8505-82547276434a',
-      isSecret: true,
-      value: '',
-      description: 'Apollo Client Secret',
-    },
-    APOLLO_OAUTH_URL: {
-      universalIdentifier: '1d42411c-5809-4093-873a-8121b1302475',
-      isSecret: false,
-      value: '',
-      description: 'Apollo OAuth URL',
-    },
-    APOLLO_REDIRECT_URI: {
-      universalIdentifier: 'c8d9e0f1-2a3b-4c5d-6e7f-8a9b0c1d2e3f',
-      isSecret: false,
-      value: '',
-      description: 'Apollo OAuth redirect URI',
-    },
-    APOLLO_REGISTERED_URL: {
-      universalIdentifier: '672a6fce-5565-43bc-9a3b-7f2c33620770',
-      isSecret: false,
-      value: '',
-      description: 'Apollo registered URL',
-    },
-    APOLLO_ACCESS_TOKEN: {
-      universalIdentifier: '672a6fce-5565-43bc-9a3b-7f2c33620771',
-      isSecret: true,
-      value: '',
-      description: 'Apollo access token',
-    },
-    APOLLO_REFRESH_TOKEN: {
-      universalIdentifier: '672a6fce-5565-43bc-9a3b-7f2c33620772',
-      isSecret: true,
-      value: '',
-      description: 'Apollo refresh token',
-    },
-  },
-});

packages/twenty-apps/community/apollo-enrich/src/fields/apollo-founded-year.field.ts

@@ -1,16 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-
-export default defineField({
-  universalIdentifier: 'da15cfc6-3657-457d-8757-4ba11b5bb6e1',
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
-  type: FieldType.NUMBER,
-  name: 'apolloFoundedYear',
-  label: 'Founded Year',
-  description: 'Year the company was founded, from Apollo enrichment',
-  icon: 'IconCalendar',
-});

packages/twenty-apps/community/apollo-enrich/src/fields/apollo-industry.field.ts

@@ -1,16 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-
-export default defineField({
-  universalIdentifier: '505532f5-1fc5-4a58-8074-ba9b48650dbc',
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
-  type: FieldType.TEXT,
-  name: 'apolloIndustry',
-  label: 'Apollo Industry',
-  description: 'Industry classification from Apollo enrichment',
-  icon: 'IconBuildingFactory',
-});

packages/twenty-apps/community/apollo-enrich/src/fields/apollo-short-description.field.ts

@@ -1,16 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-
-export default defineField({
-  universalIdentifier: 'be15e062-b065-48b4-979c-65b9a50e0cb1',
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
-  type: FieldType.TEXT,
-  name: 'apolloShortDescription',
-  label: 'Apollo Description',
-  description: 'Short company description from Apollo enrichment',
-  icon: 'IconFileDescription',
-});

packages/twenty-apps/community/apollo-enrich/src/fields/apollo-total-funding.field.ts

@@ -1,16 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-
-export default defineField({
-  universalIdentifier: 'c90ae72d-4ddf-4f22-882f-eef98c91e40e',
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier,
-  type: FieldType.CURRENCY,
-  name: 'apolloTotalFunding',
-  label: 'Total Funding',
-  description: 'Total funding raised by the company, from Apollo enrichment',
-  icon: 'IconCash',
-});

packages/twenty-apps/community/apollo-enrich/src/front-components/apollo-oauth-cta.tsx

@@ -1,220 +0,0 @@
-import styled from '@emotion/styled';
-import { useEffect, useState } from 'react';
-import { OAuthApplicationVariables } from 'src/logic-functions/get-oauth-application-variables';
-import { VERIFY_PAGE_PATH } from 'src/logic-functions/get-verify-page';
-import { defineFrontComponent } from 'twenty-sdk';
-
-const StyledContainer = styled.div`
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-  width: 100%;
-`;
-
-const StyledSectionTitle = styled.h3`
-  color: #333;
-  font-family: 'Inter', sans-serif;
-  font-size: 15px;
-  font-weight: 600;
-  margin: 0 0 4px 0;
-`;
-
-const StyledSectionSubtitle = styled.p`
-  color: #818181;
-  font-family: 'Inter', sans-serif;
-  font-size: 13px;
-  font-weight: 400;
-  margin: 0 0 12px 0;
-`;
-
-const StyledCard = styled.div`
-  align-items: center;
-  background: #fff;
-  border: 1px solid #ebebeb;
-  border-radius: 8px;
-  display: flex;
-  gap: 12px;
-  padding: 16px;
-`;
-
-const StyledIconContainer = styled.div`
-  align-items: center;
-  background: #f5f5f5;
-  border-radius: 8px;
-  color: #666;
-  display: flex;
-  flex-shrink: 0;
-  height: 40px;
-  justify-content: center;
-  width: 40px;
-`;
-
-const StyledTextContainer = styled.div`
-  display: flex;
-  flex: 1;
-  flex-direction: column;
-  gap: 2px;
-  min-width: 0;
-`;
-
-const StyledTitle = styled.span`
-  color: #333;
-  font-family: 'Inter', sans-serif;
-  font-size: 14px;
-  font-weight: 500;
-`;
-
-const StyledDescription = styled.span`
-  color: #818181;
-  font-family: 'Inter', sans-serif;
-  font-size: 13px;
-`;
-
-const StyledLink = styled.a`
-  align-items: center;
-  background: #5e5adb;
-  border: 1px solid rgba(0, 0, 0, 0.04);
-  border-radius: 4px;
-  box-sizing: border-box;
-  color: #fafafa;
-  cursor: pointer;
-  display: inline-flex;
-  flex-shrink: 0;
-  font-family: 'Inter', sans-serif;
-  font-size: 13px;
-  font-weight: 500;
-  gap: 4px;
-  height: 32px;
-  justify-content: center;
-  padding: 0 12px;
-  text-decoration: none;
-  transition: background 0.1s ease;
-  white-space: nowrap;
-
-  &:hover {
-    background: #4b47b8;
-  }
-
-  &:active {
-    background: #3c3996;
-  }
-
-  &:focus {
-    outline: none;
-  }
-`;
-
-const StyledConnectedStatus = styled.span`
-  align-items: center;
-  background: #10b981;
-  border-radius: 4px;
-  color: #fff;
-  display: inline-flex;
-  flex-shrink: 0;
-  font-family: 'Inter', sans-serif;
-  font-size: 13px;
-  font-weight: 500;
-  gap: 6px;
-  height: 32px;
-  padding: 0 12px;
-  white-space: nowrap;
-`;
-
-const StyledIcon = styled.img`
-  height: 24px;
-  width: 24px;
-`;
-
-const APOLLO_ICON_URL = 'https://twenty-icons.com/apollo.io';
-
-const fetchOAuthApplicationVariables = async (): Promise<OAuthApplicationVariables> => {
-  const backEndUrl = `${process.env.TWENTY_API_URL}/s/oauth/application-variables`;
-  const response = await fetch(backEndUrl, {
-    method: 'GET',
-  });
-  const data = await response.json();
-
-  return data;
-};
-
-const buildOAuthUrl = (oauthApplicationVariables: OAuthApplicationVariables): string => {
-  const { apolloOAuthUrl, apolloClientId, apolloRegisteredUrl } = oauthApplicationVariables;
-  const redirectUri = `${apolloRegisteredUrl}auth/oauth-propagator/callback`;
-  const state = encodeURIComponent(`${process.env.TWENTY_API_URL}/s${VERIFY_PAGE_PATH}`);
-  return `${apolloOAuthUrl}?client_id=${apolloClientId}&redirect_uri=${redirectUri}&state=${state}&response_type=code`;
-};
-
-const ApolloOAuthCta = () => {
-  const [oauthApplicationVariables, setOAuthApplicationVariables] =
-    useState<OAuthApplicationVariables | null>(null);
-  const [isLoading, setIsLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-
-  useEffect(() => {
-    fetchOAuthApplicationVariables()
-      .then(setOAuthApplicationVariables)
-      .catch(setError)
-      .finally(() => setIsLoading(false));
-  }, []);
-
-  if (isLoading) {
-    return (
-      <StyledContainer>
-        <StyledSectionTitle>Connect to Apollo</StyledSectionTitle>
-        <StyledSectionSubtitle>Enrich your contacts with Apollo data</StyledSectionSubtitle>
-        <StyledCard>
-          <StyledIconContainer>
-            <StyledIcon src={APOLLO_ICON_URL} alt="Apollo" />
-          </StyledIconContainer>
-          <StyledTextContainer>
-            <StyledTitle>Apollo OAuth</StyledTitle>
-            <StyledDescription>Loading...</StyledDescription>
-          </StyledTextContainer>
-        </StyledCard>
-      </StyledContainer>
-    );
-  }
-
-  if (error || !oauthApplicationVariables) {
-    return null;
-  }
-
-  const isConnected = Boolean(oauthApplicationVariables.apolloAccessToken);
-  const oauthUrl = buildOAuthUrl(oauthApplicationVariables);
-
-  return (
-    <StyledContainer>
-      <StyledSectionTitle>Connect to Apollo</StyledSectionTitle>
-      <StyledSectionSubtitle>Enrich your contacts with Apollo data</StyledSectionSubtitle>
-      <StyledCard>
-        <StyledIconContainer>
-          <StyledIcon src={APOLLO_ICON_URL} alt="Apollo" />
-        </StyledIconContainer>
-        <StyledTextContainer>
-          <StyledTitle>Apollo OAuth</StyledTitle>
-          <StyledDescription>
-            {isConnected
-              ? 'Your Apollo account is connected'
-              : 'Connect your Apollo account to enrich contacts'}
-          </StyledDescription>
-        </StyledTextContainer>
-        {isConnected ? (
-          <StyledConnectedStatus>
-            ✓ Connected
-          </StyledConnectedStatus>
-        ) : (
-          <StyledLink href={oauthUrl} rel="noopener noreferrer">
-            Connect
-          </StyledLink>
-        )}
-      </StyledCard>
-    </StyledContainer>
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: '50d59f7c-eada-4731-aacd-8e45371e1040',
-  name: 'apollo-oauth-cta',
-  description: 'CTA button to connect to Apollo Enrichment via OAuth',
-  component: ApolloOAuthCta,
-});

packages/twenty-apps/community/apollo-enrich/src/logic-functions/get-authentication-token-pairs.ts

@@ -1,105 +0,0 @@
-import { defineLogicFunction, RoutePayload } from "twenty-sdk";
-import { MetadataApiClient } from 'twenty-sdk/generated';
-
-
-export const OAUTH_TOKEN_PAIRS_PATH = '/oauth/token-pairs';
-
-type ApolloTokenResponse = {
-  access_token: string;
-  token_type: string;
-  expires_in: number;
-  refresh_token: string;
-  scope: string;
-  created_at: number;
-};
-
-const getAuthenticationTokenPairs = async (
-  code: string,
-  clientId: string,
-  clientSecret: string,
-): Promise<ApolloTokenResponse> => {
-  const formData = new URLSearchParams({
-    grant_type: 'authorization_code',
-    client_id: clientId,
-    client_secret: clientSecret,
-    code: code,
-    redirect_uri: 'https://hjsm0q38-3000.uks1.devtunnels.ms/auth/oauth-propagator/callback',
-  });
-
-  const response = await fetch('https://app.apollo.io/api/v1/oauth/token', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/x-www-form-urlencoded',
-    },
-    body: formData.toString(),
-  });
-
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`Failed to exchange code for tokens: ${response.status} - ${errorText}`);
-  }
-
-  return response.json();
-};
-
-const handler = async (event: RoutePayload): Promise<any> => {
-  const { queryStringParameters: { code } } = event;
-
-  if (!code) {
-    throw new Error('Code is required');
-  }
-
-  const apolloClientId = process.env.APOLLO_CLIENT_ID ?? '';
-  const apolloClientSecret = process.env.APOLLO_CLIENT_SECRET ?? '';
-  const applicationId = process.env.APPLICATION_ID ?? '';
-
-
-  const metadataClient = new MetadataApiClient({});
-
-
-
-
-
-
-
-
-  const tokenPairs = await getAuthenticationTokenPairs(
-    code,
-    apolloClientId,
-    apolloClientSecret,
-  );
-
-  await metadataClient.mutation({
-    updateOneApplicationVariable: {
-      __args: {
-          key: 'APOLLO_ACCESS_TOKEN',
-          value: tokenPairs.access_token,
-          applicationId,
-        },
-    },
-  });
-
-   await metadataClient.mutation({
-    updateOneApplicationVariable: {
-      __args: {
-          key: 'APOLLO_REFRESH_TOKEN',
-          value: tokenPairs.refresh_token,
-          applicationId,
-        },
-    },
-  });
-  return {tokenPairs};
-};
-
-export default defineLogicFunction({
-  universalIdentifier: '7ccc63a7-ece1-44c0-adbe-805a1baea03a',
-  name: 'get-authentication-token-pairs',
-  description: 'Returns the Apollo authentication token pairs',
-  timeoutSeconds: 10,
-  handler,
-  httpRouteTriggerSettings: {
-    path: OAUTH_TOKEN_PAIRS_PATH,
-    httpMethod: 'GET',
-    isAuthRequired: false,
-  },
-});

packages/twenty-apps/community/apollo-enrich/src/logic-functions/get-oauth-application-variables.ts

@@ -1,32 +0,0 @@
-import { defineLogicFunction } from 'twenty-sdk';
-
-export type OAuthApplicationVariables = {
-  apolloClientId: string;
-  apolloRegisteredUrl: string;
-  apolloOAuthUrl: string;
-  apolloAccessToken: string;
-  apolloRefreshToken: string;
-};
-
-const handler = async (): Promise<OAuthApplicationVariables> => {
-  const apolloClientId = process.env.APOLLO_CLIENT_ID ?? '';
-  const apolloRegisteredUrl = process.env.APOLLO_REGISTERED_URL ?? '';
-  const apolloOAuthUrl = process.env.APOLLO_OAUTH_URL ?? '';
-  const apolloAccessToken = process.env.APOLLO_ACCESS_TOKEN ?? '';
-  const apolloRefreshToken = process.env.APOLLO_REFRESH_TOKEN ?? '';
-
-  return { apolloClientId, apolloRegisteredUrl, apolloOAuthUrl, apolloAccessToken, apolloRefreshToken };
-};
-
-export default defineLogicFunction({
-  universalIdentifier: 'b7c3e8f1-9d4a-4e2b-8f6c-1a5d3e7b9c2f',
-  name: 'get-oauth-application-variables',
-  description: 'Returns the Apollo OAuth authorization URL',
-  timeoutSeconds: 10,
-  handler,
-  httpRouteTriggerSettings: {
-    path: '/oauth/application-variables',
-    httpMethod: 'GET',
-    isAuthRequired: false,
-  },
-});

packages/twenty-apps/community/apollo-enrich/src/logic-functions/get-verify-page.ts

@@ -1,90 +0,0 @@
-import { defineLogicFunction } from "twenty-sdk";
-
-export const VERIFY_PAGE_PATH = '/oauth/verify';
-
-const buildVerifyPageHtml = (applicationId: string): string => `<!DOCTYPE html>
-<html>
-<head>
-  <title>Apollo OAuth - Verifying...</title>
-  <style>
-    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; max-width: 600px; margin: 50px auto; padding: 20px; text-align: center; }
-    .loading { color: #6b7280; }
-    .success { color: #10b981; }
-    .error { color: #ef4444; }
-    .spinner { border: 3px solid #f3f4f6; border-top: 3px solid #3b82f6; border-radius: 50%; width: 40px; height: 40px; animation: spin 1s linear infinite; margin: 20px auto; }
-    @keyframes spin { 0% { transform: rotate(0deg); } 100% { transform: rotate(360deg); } }
-  </style>
-  <script>
-    (async function() {
-      const applicationId = ${JSON.stringify(applicationId)};
-      const urlParams = new URLSearchParams(window.location.search);
-      const code = urlParams.get('code');
-      const baseUrl = window.location.origin;
-
-      function showError(message) {
-        document.addEventListener('DOMContentLoaded', function() {
-          document.getElementById('spinner').style.display = 'none';
-          document.getElementById('title').textContent = '✗ Connection Failed';
-          document.getElementById('title').className = 'error';
-          document.getElementById('status').textContent = message;
-        });
-
-        if (window.opener) {
-          window.opener.postMessage({ type: 'APOLLO_OAUTH_ERROR', error: message }, '*');
-        }
-      }
-
-      if (!code) {
-        showError('Authorization code is missing. Please try connecting again.');
-        return;
-      }
-
-      try {
-        const response = await fetch(
-          baseUrl + '/s/oauth/token-pairs?code=' + encodeURIComponent(code),
-          {
-            method: 'GET',
-            headers: { 'Content-Type': 'application/json' }
-          }
-        );
-
-        if (!response.ok) {
-          const errorText = await response.text();
-          throw new Error('Failed to get tokens: ' + response.status + ' - ' + errorText);
-        }
-
-        const tokens = await response.json();
-
-        window.location.href = 'http://apple.localhost:3001/settings/applications/' + applicationId + '#custom';
-
-      } catch (error) {
-        showError(error.message);
-      }
-    })();
-  </script>
-</head>
-<body>
-  <div class="spinner" id="spinner"></div>
-  <h1 class="loading" id="title">Connecting to Apollo...</h1>
-  <p id="status">Please wait while we complete the connection.</p>
-</body>
-</html>`;
-
-const handler = async (): Promise<string> => {
-  const applicationId = process.env.APPLICATION_ID ?? '';
-
-  return buildVerifyPageHtml(applicationId);
-};
-
-export default defineLogicFunction({
-  universalIdentifier: '4d74950a-d9c1-4c66-a799-89c1aea4e6b0',
-  name: 'get-verify-page',
-  description: 'Returns the Apollo OAuth verify page',
-  timeoutSeconds: 10,
-  handler,
-  httpRouteTriggerSettings: {
-    path: VERIFY_PAGE_PATH,
-    httpMethod: 'GET',
-    isAuthRequired: false,
-  },
-});

packages/twenty-apps/community/apollo-enrich/src/logic-functions/on-company-updated.ts

@@ -1,234 +0,0 @@
-import {
-  defineLogicFunction,
-  type DatabaseEventPayload,
-  type ObjectRecordUpdateEvent,
-} from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-sdk/generated';
-
-
-
-type CompanyRecord = {
-  id: string;
-  name?: string;
-  domainName?: {
-    primaryLinkUrl?: string;
-    primaryLinkLabel?: string;
-  };
-};
-
-type ApolloOrganization = {
-  name?: string;
-  website_url?: string;
-  linkedin_url?: string;
-  twitter_url?: string;
-  estimated_num_employees?: number;
-  annual_revenue?: number;
-  total_funding?: number;
-  street_address?: string;
-  city?: string;
-  state?: string;
-  postal_code?: string;
-  country?: string;
-  short_description?: string;
-  industry?: string;
-  founded_year?: number;
-};
-
-type ApolloEnrichResponse = {
-  organization?: ApolloOrganization;
-};
-
-
-
-const extractDomain = (
-  domainName?: CompanyRecord['domainName'],
-): string | undefined => {
-  const url = domainName?.primaryLinkUrl;
-
-  if (!url) {
-    return undefined;
-  }
-
-  try {
-    const hostname = new URL(
-      url.startsWith('http') ? url : `https://${url}`,
-    ).hostname;
-
-    return hostname.replace(/^www\./, '');
-  } catch {
-    return url.replace(/^(https?:\/\/)?(www\.)?/, '').split('/')[0];
-  }
-};
-
-const fetchApolloEnrichment = async (
-  domain: string,
-): Promise<ApolloOrganization | undefined> => {
-  const response = await fetch(
-    `https://api.apollo.io/api/v1/organizations/enrich?domain=${encodeURIComponent(domain)}`,
-    {
-      method: 'GET',
-      headers: {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${process.env.APOLLO_ACCESS_TOKEN ?? ''}`,
-      },
-    },
-  );
-
-  const data: ApolloEnrichResponse = await response.json();
-
-  return data.organization;
-};
-
-const buildCompanyUpdateData = (
-  apolloOrganization: ApolloOrganization,
-): Record<string, unknown> => {
-  const updateData: Record<string, unknown> = {};
-
-  if (apolloOrganization.name) {
-    updateData.name = apolloOrganization.name;
-  }
-
-  if (apolloOrganization.estimated_num_employees) {
-    updateData.employees = apolloOrganization.estimated_num_employees;
-  }
-
-  if (apolloOrganization.linkedin_url) {
-    updateData.linkedinLink = {
-      primaryLinkUrl: apolloOrganization.linkedin_url,
-      primaryLinkLabel: 'LinkedIn',
-    };
-  }
-
-  if (apolloOrganization.twitter_url) {
-    updateData.xLink = {
-      primaryLinkUrl: apolloOrganization.twitter_url,
-      primaryLinkLabel: 'X',
-    };
-  }
-
-  if (apolloOrganization.annual_revenue) {
-    updateData.annualRecurringRevenue = {
-      amountMicros: apolloOrganization.annual_revenue * 1_000_000,
-      currencyCode: 'USD',
-    };
-  }
-
-  const hasAddress =
-    apolloOrganization.street_address ||
-    apolloOrganization.city ||
-    apolloOrganization.state ||
-    apolloOrganization.country;
-
-  if (hasAddress) {
-    updateData.address = {
-      addressStreet1: apolloOrganization.street_address ?? '',
-      addressCity: apolloOrganization.city ?? '',
-      addressState: apolloOrganization.state ?? '',
-      addressPostcode: apolloOrganization.postal_code ?? '',
-      addressCountry: apolloOrganization.country ?? '',
-    };
-  }
-
-  if (apolloOrganization.industry) {
-    updateData.apolloIndustry = apolloOrganization.industry;
-  }
-
-  if (apolloOrganization.short_description) {
-    updateData.apolloShortDescription = apolloOrganization.short_description;
-  }
-
-  if (apolloOrganization.founded_year) {
-    updateData.apolloFoundedYear = apolloOrganization.founded_year;
-  }
-
-  if (apolloOrganization.total_funding) {
-    updateData.apolloTotalFunding = {
-      amountMicros: apolloOrganization.total_funding * 1_000_000,
-      currencyCode: 'USD',
-    };
-  }
-
-  return updateData;
-};
-
-const updateCompanyInTwenty = async (
-  companyId: string,
-  updateData: Record<string, unknown>,
-): Promise<void> => {
-  const client = new CoreApiClient();
-
-  const result = await client.mutation({
-    updateCompany: {
-      __args: {
-        id: companyId,
-        data: updateData,
-      },
-      id: true,
-    },
-  });
-
-  if (!result.updateCompany) {
-    throw new Error(`Failed to update company ${companyId}: no result`);
-  }
-};
-
-
-type CompanyUpdateEvent = DatabaseEventPayload<
-  ObjectRecordUpdateEvent<CompanyRecord>
->;
-
-const handler = async (
-  event: CompanyUpdateEvent,
-): Promise<object | undefined> => {
-
-
-    const { recordId, properties } = event;
-    const { after: companyAfter } = properties;
-
-    const domain = extractDomain(companyAfter?.domainName);
-
-    if (!domain) {
-      return { skipped: true, reason: 'no domain found on company' };
-    }
-
-    const apolloOrganization = await fetchApolloEnrichment(domain);
-
-    if (!apolloOrganization) {
-      return {
-        skipped: true,
-        reason: `no Apollo data found for ${domain}`,
-      };
-    }
-
-    const updateData = buildCompanyUpdateData(apolloOrganization);
-
-    if (Object.keys(updateData).length === 0) {
-      return { skipped: true, reason: 'no enrichment data to apply' };
-    }
-
-
-    await updateCompanyInTwenty(recordId, updateData);
-
-    const result = {
-      enriched: true,
-      companyId: recordId,
-      domain,
-      updatedFields: Object.keys(updateData),
-    };
-
-    return result;
-
-};
-
-export default defineLogicFunction({
-  universalIdentifier: '6248b3fe-a8af-404a-8e38-19df98f73d81',
-  name: 'on-company-updated',
-  description:
-    'Enriches company data from Apollo when the company domain is updated',
-  timeoutSeconds: 30,
-  handler,
-  databaseEventTriggerSettings: {
-    eventName: 'company.updated',
-    updatedFields: ['domainName'],
-  },
-});

packages/twenty-apps/community/apollo-enrich/src/logic-functions/post-install.ts

@@ -1,13 +0,0 @@
-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: '08292efc-d7ba-4ec3-ab95-e7c33bd3a3bc',
-  name: 'post-install',
-  description: 'Runs after installation to set up the application.',
-  timeoutSeconds: 300,
-  handler,
-});

packages/twenty-apps/community/apollo-enrich/src/logic-functions/pre-install.ts

@@ -1,13 +0,0 @@
-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: 'af7cd86e-149e-466a-8d60-312b6e46d604',
-  name: 'pre-install',
-  description: 'Runs before installation to prepare the application.',
-  timeoutSeconds: 300,
-  handler,
-});

packages/twenty-apps/community/apollo-enrich/src/roles/default-role.ts

@@ -1,15 +0,0 @@
-import { defineRole } from 'twenty-sdk';
-
-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
-  'b8faae3f-e174-43fa-ab94-715712ae26cb';
-
-export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-  label: 'Apollo enrich default function role',
-  description: 'Apollo enrich default function role',
-  canReadAllObjectRecords: true,
-  canUpdateAllObjectRecords: true,
-  canSoftDeleteAllObjectRecords: true,
-  canDestroyAllObjectRecords: false,
-  canUpdateAllSettings: true,
-});

packages/twenty-apps/community/apollo-enrich/tsconfig.json

@@ -1,31 +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"]
-}

packages/twenty-apps/hello-world/.gitignore

@@ -1,3 +1,2 @@
 .yarn/install-state.gz
 .env
-.twenty

packages/twenty-apps/hello-world/package.json

@@ -9,16 +9,14 @@
   },
   "packageManager": "[email protected]",
   "scripts": {
-    "twenty": "twenty",
-    "auth": "twenty auth:login",
-    "dev": "twenty app:dev",
-    "build": "twenty app:build",
-    "typecheck": "twenty app:typecheck",
-    "uninstall": "twenty app:uninstall",
-    "entity:add": "twenty entity:add"
+    "create-entity": "twenty app add",
+    "dev": "twenty app dev",
+    "sync": "twenty app sync",
+    "uninstall": "twenty app uninstall",
+    "auth": "twenty auth login"
   },
   "dependencies": {
-    "twenty-sdk": "0.6.3"
+    "twenty-sdk": "0.2.4"
   },
   "devDependencies": {
     "@types/node": "^24.7.2"

packages/twenty-apps/hello-world/src/actions/create-new-post-card.ts

@@ -1,55 +1,67 @@
-import {
-  defineLogicFunction,
-  type CronPayload,
-  type DatabaseEventPayload,
-  type ObjectRecordCreateEvent,
+import type {
+  FunctionConfig,
+  DatabaseEventPayload,
+  ObjectRecordCreateEvent,
+  CronPayload,
 } from 'twenty-sdk';
-import { CoreApiClient as Twenty, type CoreSchema } from 'twenty-sdk/generated';
+import Twenty, { type Person } from '../../generated';
 
 type CreateNewPostCardParams =
   | { name?: string }
-  | DatabaseEventPayload<ObjectRecordCreateEvent<CoreSchema.Person>>
+  | DatabaseEventPayload<ObjectRecordCreateEvent<Person>>
   | CronPayload;
 
-const handler = async (params: CreateNewPostCardParams) => {
-  const client = new Twenty();
+export const main = async (params: CreateNewPostCardParams) => {
+  try {
+    const client = new Twenty();
 
-  const name =
-    'name' in params
-      ? params.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
-      : 'Hello world';
+    const name =
+      'name' in params
+        ? params.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
+        : 'Hello world';
 
-  const createPostCard = await client.mutation({
-    createPostCard: {
-      __args: {
-        data: {
-          name,
+    const createPostCard = await client.mutation({
+      createPostCard: {
+        __args: {
+          data: {
+            name,
+          },
         },
+        name: true,
+        id: true,
       },
-      name: true,
-      id: true,
-    },
-  });
+    });
 
-  console.log('createPostCard result', createPostCard);
+    console.log('createPostCard result', createPostCard);
 
-  return createPostCard;
+    return createPostCard;
+  } catch (error) {
+    console.error(error);
+    throw error;
+  }
 };
 
-export default defineLogicFunction({
+export const config: FunctionConfig = {
   universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
   name: 'create-new-post-card',
   timeoutSeconds: 2,
-  handler,
-  httpRouteTriggerSettings: {
-    path: '/post-card/create',
-    httpMethod: 'GET',
-    isAuthRequired: false,
-  },
-  cronTriggerSettings: {
-    pattern: '0 0 1 1 *',
-  },
-  databaseEventTriggerSettings: {
-    eventName: 'person.created',
-  },
-});
+  triggers: [
+    {
+      universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6',
+      type: 'route',
+      path: '/post-card/create',
+      httpMethod: 'GET',
+      isAuthRequired: false,
+    },
+    {
+      universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2',
+      type: 'cron',
+      pattern: '0 0 1 1 *', // Every year 1st of January
+    },
+    {
+      universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156',
+      type: 'databaseEvent',
+      eventName: 'person.created',
+    },
+  ],
+};

packages/twenty-apps/hello-world/src/application.config.ts

@@ -1,6 +1,6 @@
-import { defineApplication } from 'twenty-sdk';
+import { type ApplicationConfig } from 'twenty-sdk';
 
-export default defineApplication({
+const config: ApplicationConfig = {
   universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
   displayName: 'Hello World',
   description: 'A simple hello world app',
@@ -14,4 +14,6 @@ export default defineApplication({
     },
   },
   defaultRoleUniversalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
-});
+};
+
+export default config;

packages/twenty-apps/hello-world/src/objects/postCard.ts

@@ -1,89 +1,112 @@
-import { defineObject, FieldType } from 'twenty-sdk';
+import { type Note } from '../../generated';
 
-const POST_CARD_STATUS = {
-  DRAFT: 'DRAFT',
-  SENT: 'SENT',
-  DELIVERED: 'DELIVERED',
-  RETURNED: 'RETURNED',
-} as const;
+import {
+  type AddressField,
+  Field,
+  FieldType,
+  type FullNameField,
+  Object,
+  OnDeleteAction,
+  Relation,
+  RelationType,
+  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
 
-export default defineObject({
+enum PostCardStatus {
+  DRAFT = 'DRAFT',
+  SENT = 'SENT',
+  DELIVERED = 'DELIVERED',
+  RETURNED = 'RETURNED',
+}
+
+@Object({
   universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
   nameSingular: 'postCard',
   namePlural: 'postCards',
   labelSingular: 'Post card',
   labelPlural: 'Post cards',
-  description: 'A post card object',
+  description: ' A post card object',
   icon: 'IconMail',
-  fields: [
-    {
-      universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
-      type: FieldType.TEXT,
-      name: 'content',
-      label: 'Content',
-      description: "Postcard's content",
-      icon: 'IconAbc',
-    },
-    {
-      universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
-      type: FieldType.FULL_NAME,
-      name: 'recipientName',
-      label: 'Recipient name',
-      icon: 'IconUser',
-    },
-    {
-      universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
-      type: FieldType.ADDRESS,
-      name: 'recipientAddress',
-      label: 'Recipient address',
-      icon: 'IconHome',
-    },
-    {
-      universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
-      type: FieldType.SELECT,
-      name: 'status',
-      label: 'Status',
-      icon: 'IconSend',
-      defaultValue: `'${POST_CARD_STATUS.DRAFT}'`,
-      options: [
-        {
-          id: 'a1b2c3d4-0001-4000-8000-000000000001',
-          value: POST_CARD_STATUS.DRAFT,
-          label: 'Draft',
-          position: 0,
-          color: 'gray',
-        },
-        {
-          id: 'a1b2c3d4-0002-4000-8000-000000000002',
-          value: POST_CARD_STATUS.SENT,
-          label: 'Sent',
-          position: 1,
-          color: 'orange',
-        },
-        {
-          id: 'a1b2c3d4-0003-4000-8000-000000000003',
-          value: POST_CARD_STATUS.DELIVERED,
-          label: 'Delivered',
-          position: 2,
-          color: 'green',
-        },
-        {
-          id: 'a1b2c3d4-0004-4000-8000-000000000004',
-          value: POST_CARD_STATUS.RETURNED,
-          label: 'Returned',
-          position: 3,
-          color: 'orange',
-        },
-      ],
-    },
-    {
-      universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
-      type: FieldType.DATE_TIME,
-      name: 'deliveredAt',
-      label: 'Delivered at',
-      icon: 'IconCheck',
-      isNullable: true,
-      defaultValue: null,
-    },
-  ],
-});
+})
+export class PostCard {
+  @Field({
+    universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+    type: FieldType.TEXT,
+    label: 'Content',
+    description: "Postcard's content",
+    icon: 'IconAbc',
+  })
+  content: string;
+
+  @Field({
+    universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
+    type: FieldType.FULL_NAME,
+    label: 'Recipient name',
+    icon: 'IconUser',
+  })
+  recipientName: FullNameField;
+
+  @Field({
+    universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
+    type: FieldType.ADDRESS,
+    label: 'Recipient address',
+    icon: 'IconHome',
+  })
+  recipientAddress: AddressField;
+
+  @Field({
+    universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
+    type: FieldType.SELECT,
+    label: 'Status',
+    icon: 'IconSend',
+    defaultValue: `'${PostCardStatus.DRAFT}'`,
+    options: [
+      {
+        value: PostCardStatus.DRAFT,
+        label: 'Draft',
+        position: 0,
+        color: 'gray',
+      },
+      {
+        value: PostCardStatus.SENT,
+        label: 'Sent',
+        position: 1,
+        color: 'orange',
+      },
+      {
+        value: PostCardStatus.DELIVERED,
+        label: 'Delivered',
+        position: 2,
+        color: 'green',
+      },
+      {
+        value: PostCardStatus.RETURNED,
+        label: 'Returned',
+        position: 3,
+        color: 'orange',
+      },
+    ],
+  })
+  status: PostCardStatus;
+
+  @Relation({
+    universalIdentifier: 'c9e2b4f4-b9ad-4427-9b42-9971b785edfe',
+    type: RelationType.ONE_TO_MANY,
+    label: 'Notes',
+    icon: 'IconComment',
+    inverseSideTargetUniversalIdentifier:
+      STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note.universalIdentifier,
+    onDelete: OnDeleteAction.CASCADE,
+  })
+  notes: Note[];
+
+  @Field({
+    universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
+    type: FieldType.DATE_TIME,
+    label: 'Delivered at',
+    icon: 'IconCheck',
+    isNullable: true,
+    defaultValue: null,
+  })
+  deliveredAt?: Date;
+}

packages/twenty-apps/hello-world/src/roles/function-role.ts

@@ -1,6 +1,6 @@
-import { defineRole, PermissionFlag } from 'twenty-sdk';
+import { PermissionFlag, type RoleConfig } from 'twenty-sdk';
 
-export default defineRole({
+export const functionRole: RoleConfig = {
   universalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
   label: 'Default function role',
   description: 'Default role for function Twenty client',
@@ -14,7 +14,7 @@ export default defineRole({
   canBeAssignedToApiKeys: false,
   objectPermissions: [
     {
-      objectUniversalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
+      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
       canReadObjectRecords: true,
       canUpdateObjectRecords: true,
       canSoftDeleteObjectRecords: false,
@@ -23,11 +23,11 @@ export default defineRole({
   ],
   fieldPermissions: [
     {
-      objectUniversalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
-      fieldUniversalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
+      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
+      fieldUniversalIdentifier: 'b2c37dc0-8ae7-470e-96cd-1476b47dfaff',
       canReadFieldValue: false,
       canUpdateFieldValue: false,
     },
   ],
   permissionFlags: [PermissionFlag.APPLICATIONS],
-});
+};

packages/twenty-apps/internal/self-hosting/.gitignore

@@ -1,37 +1,2 @@
-# 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
+.yarn/install-state.gz
+.env

packages/twenty-apps/internal/self-hosting/README.md

@@ -2,6 +2,25 @@
 
 Used to manage billing and telemetry of self-hosted instances
 
+## Requirements
+- twenty-cli `npm install -g twenty-cli`
+- an `apiKey`. Go to `https://twenty.com/settings/api-webhooks` to generate one
+
+
+## Install to your Twenty workspace
+
+```bash
+twenty auth login
+twenty app sync
+```
+
+## Environment Variables
+
+This application requires the following environment variables to be set:
+
+- `TWENTY_API_URL`: The Twenty instance API URL where selfHostingUser records will be created
+- `TWENTY_API_KEY`: API key for authentication (generate at `/settings/api-webhooks`)
+
 ## Features
 
 ### Telemetry Webhook

packages/twenty-apps/internal/self-hosting/package.json

@@ -9,13 +9,26 @@
   },
   "packageManager": "[email protected]",
   "scripts": {
-    "twenty": "twenty",
+    "auth:login": "twenty auth login",
+    "auth:logout": "twenty auth logout",
+    "auth:status": "twenty auth status",
+    "auth:switch": "twenty auth switch",
+    "auth:list": "twenty auth list",
+    "app:dev": "twenty app dev",
+    "app:sync": "twenty app sync",
+    "entity:add": "twenty entity add",
+    "function:logs": "twenty function logs",
+    "function:execute": "twenty function execute",
+    "app:uninstall": "twenty app uninstall",
+    "help": "twenty help",
     "lint": "eslint",
     "lint:fix": "eslint --fix"
   },
+  "dependencies": {
+    "twenty-sdk": "0.3.1"
+  },
   "devDependencies": {
-    "@types/node": "^24.7.2",
-    "twenty-sdk": "0.6.2"
+    "@types/node": "^24.7.2"
   },
   "$schema": "https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-cli/src/constants/schemas/appManifest.schema.json",
   "universalIdentifier": "a7070f46-3158-4b40-828f-8e6b1febc233"

packages/twenty-apps/internal/self-hosting/src/app/application.config.ts

@@ -0,0 +1,19 @@
+import { defineApp } from 'twenty-sdk';
+
+export default defineApp({
+  universalIdentifier: '94f7db30-59e5-4b09-a5fe-64cd3d4a65b0',
+  displayName: 'Self Hosting',
+  description: 'Used to manage billing and telemetry of self-hosted instances',
+  applicationVariables: {
+    TWENTY_API_KEY: {
+      universalIdentifier: 'a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d',
+      description: 'Twenty API key for creating selfHostingUser records',
+      isSecret: true,
+    },
+    TWENTY_API_URL: {
+      universalIdentifier: 'b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e',
+      description: 'Twenty API URL (e.g., https://api.twenty.com)',
+      isSecret: false,
+    },
+  },
+});

packages/twenty-apps/internal/self-hosting/src/app/selfHostingUser.object.ts

@@ -0,0 +1,18 @@
+import { FieldType, defineObject } from 'twenty-sdk';
+
+export default defineObject({
+  universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
+  nameSingular: 'selfHostingUser',
+  namePlural: 'selfHostingUsers',
+  labelSingular: 'Self Hosting User',
+  labelPlural: 'Self Hosting Users',
+  fields: [
+    {
+      type: FieldType.EMAILS,
+      name: 'email',
+      label: 'Email',
+      description: 'The email of the self hosting user',
+      universalIdentifier: 'a4b7892c-431a-4d44-973e-a5481652704f',
+    },
+  ],
+});

packages/twenty-apps/internal/self-hosting/src/app/telemetryWebhook.function.ts

@@ -0,0 +1,132 @@
+import { defineFunction } from 'twenty-sdk';
+import { createClient } from '../../generated';
+
+// TODO: import from twenty-sdk when 0.4.0 is deployed
+type ServerlessFunctionEvent<TBody = object> = {
+  headers: Record<string, string | undefined>;
+  queryStringParameters: Record<string, string | undefined>;
+  pathParameters: Record<string, string | undefined>;
+  body: TBody | null;
+  isBase64Encoded: boolean;
+  requestContext: {
+    http: {
+      method: string;
+      path: string;
+    };
+  };
+};
+
+type TelemetryEventPayload = {
+  action: string;
+  timestamp: string;
+  version: string;
+  payload: {
+    userId: string | null;
+    workspaceId: string | null;
+    payload?: {
+      events?: Array<{
+        userId?: string;
+        userEmail?: string;
+        userFirstName?: string;
+        userLastName?: string;
+        locale?: string;
+        serverUrl?: string;
+      }>;
+    };
+  };
+};
+
+export const main = async (
+  params: ServerlessFunctionEvent<TelemetryEventPayload>,
+): Promise<{ success: boolean; message: string; error?: string }> => {
+  try {
+    const { action, payload } = params.body || {};
+
+    if (action !== 'user_signup') {
+      return {
+        success: true,
+        message: `Event type '${action}' ignored`,
+      };
+    }
+
+    const userEmail =
+      payload?.payload?.events?.[0]?.userEmail ||
+      payload?.payload?.events?.[0]?.userId;
+
+    if (!userEmail) {
+      return {
+        success: false,
+        message: 'No email found in telemetry event',
+        error: 'Missing userEmail in payload',
+      };
+    }
+
+    if (
+      userEmail.toLowerCase().includes('example') ||
+      userEmail.toLowerCase().includes('test')
+    ) {
+      return {
+        success: true,
+        message: `Email '${userEmail}' ignored (contains test/example data)`,
+      };
+    }
+
+    const client = createClient({
+      url: `${process.env.TWENTY_API_URL}/graphql`,
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${process.env.TWENTY_API_KEY}`,
+      },
+    });
+
+    // Create or update selfHostingUser record
+    const result = await client.mutation({
+      createSelfHostingUser: {
+        __args: {
+          data: {
+            name:
+              payload?.payload?.events?.[0]?.userFirstName +
+              ' ' +
+              payload?.payload?.events?.[0]?.userLastName,
+            email: {
+              primaryEmail: userEmail,
+              additionalEmails: null,
+            },
+          },
+          upsert: true,
+        },
+        id: true,
+        email: {
+          primaryEmail: true,
+        },
+      },
+    });
+
+    return {
+      success: true,
+      message: `Self hosting user created/updated: ${result.createSelfHostingUser?.id}`,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: 'Failed to process telemetry event',
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+};
+
+export default defineFunction({
+  universalIdentifier: '10104201-622b-4a5e-9f27-8f2af19b2a3c',
+  name: 'telemetry-webhook',
+  timeoutSeconds: 5,
+  handler: main,
+  triggers: [
+    {
+      universalIdentifier: '7c8e3f5a-9b4c-4d1e-8f2a-1b3c4d5e6f7a',
+      type: 'route',
+      path: '/webhook/telemetry',
+      httpMethod: 'POST',
+      isAuthRequired: false,
+    },
+  ],
+});

packages/twenty-apps/internal/self-hosting/src/application.config.ts

@@ -1,10 +0,0 @@
-import { defineApplication } from 'twenty-sdk';
-import { UNIVERSAL_IDENTIFIERS } from 'src/constants/universal-identifiers.constant';
-
-export default defineApplication({
-  universalIdentifier: '94f7db30-59e5-4b09-a5fe-64cd3d4a65b0',
-  displayName: 'Self Hosting',
-  description: 'Used to manage billing and telemetry of self-hosted instances',
-  defaultRoleUniversalIdentifier:
-    UNIVERSAL_IDENTIFIERS.roles.defaultRole.universalIdentifier,
-});

packages/twenty-apps/internal/self-hosting/src/constants/universal-identifiers.constant.ts

@@ -1,120 +0,0 @@
-export const UNIVERSAL_IDENTIFIERS = {
-  objects: {
-    selfHostingUser: {
-      universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
-      fields: {
-        name: { universalIdentifier: '682cccbf-9f37-4290-a94c-902c771f61e4' },
-        email: { universalIdentifier: 'a4b7892c-431a-4d44-973e-a5481652704f' },
-        personId: {
-          universalIdentifier: 'b453a43c-1512-48ca-8604-db750ad3ffb8',
-        },
-        domain: {
-          universalIdentifier: '1dfa7d4e-c8f5-4639-b58e-3392a8789f76',
-        },
-        userWorkspaceId: {
-          universalIdentifier: '297a7d6b-e407-4b2d-8c03-8964bc1b7805',
-        },
-        userId: {
-          universalIdentifier: '5c7ba3ce-1473-4e3d-8e7c-31816fcb87d8',
-        },
-        locale: {
-          universalIdentifier: '7b39df37-a22e-4f38-ae77-91cf3ee7c076',
-        },
-        serverUrl: {
-          universalIdentifier: 'f2516b77-2912-4cbb-8838-46ac5a5465d9',
-        },
-        serverId: {
-          universalIdentifier: 'e68a2b15-786d-4e9d-a74d-6d6d577ae721',
-        },
-        numberOfEmailsWithSameDomain: {
-          universalIdentifier: '0bf05db0-6771-4400-91ca-1579ec11e76e',
-        },
-        isEnriched: {
-          universalIdentifier: 'fefe9fd6-23ae-4046-b60b-64d17e9ff7ed',
-        },
-        triedToBeEnriched: {
-          universalIdentifier: 'd32c8cc3-8855-453d-bb7d-9c9c0b3f2128',
-        },
-        isPersonalEmail: {
-          universalIdentifier: 'f4568391-9474-4ed8-8cbb-e36d86e0f5f9',
-        },
-        isTwenty: {
-          universalIdentifier: 'b1acef1f-7c10-47a9-899e-aaca45b36e04',
-        },
-        personCity: {
-          universalIdentifier: 'ca733484-e595-4257-9ca9-9a7802fb8bcb',
-        },
-        personCountry: {
-          universalIdentifier: '18c06357-1b50-4d5b-82cf-1f71f286fbe4',
-        },
-        personJobFunction: {
-          universalIdentifier: '26e7e2c7-ea83-41e0-8c07-1fc2549a3fb4',
-        },
-        personJobTitle: {
-          universalIdentifier: '177908e9-1ca6-4762-9518-0df966d3e9fc',
-        },
-        personLinkedIn: {
-          universalIdentifier: '3515683f-7f9f-4b6d-9b16-614824d277b7',
-        },
-        personSeniority: {
-          universalIdentifier: '8b63855a-5915-4d6a-a6ed-ef7d8f8e5dd1',
-        },
-        companyAlexaRank: {
-          universalIdentifier: '7c61335b-cd4b-4eae-8b02-0db746913e36',
-        },
-        companyAnnualRevenue: {
-          universalIdentifier: 'a2367973-aa12-42c2-9577-fe868f61b83b',
-        },
-        companyAnnualRevenuePrinted: {
-          universalIdentifier: 'bc02b6af-8f48-4fde-920d-1fd3e2a8557b',
-        },
-        companyDescription: {
-          universalIdentifier: 'a9bb622e-56b6-42ba-8b03-17a47d707409',
-        },
-        companyEmployees: {
-          universalIdentifier: '8e1dbc58-d444-470f-b8fe-9eed8da4b59e',
-        },
-        companyFoundedYear: {
-          universalIdentifier: '3cf95527-5064-43ab-bf5e-421eb45fac5f',
-        },
-        companyFundingLatestStage: {
-          universalIdentifier: 'a7dcd92a-6811-490b-a8dd-fad1c19091a1',
-        },
-        companyFundingTotalAmount: {
-          universalIdentifier: '6fca8a11-b49a-4081-a7c9-9646f43ad7aa',
-        },
-        companyFundingTotalAmountPrinted: {
-          universalIdentifier: '0078f0f0-2262-4c74-aaf8-4061c6c8a1f3',
-        },
-        companyIndustries: {
-          universalIdentifier: '6b971b9c-6ef5-4497-989e-f9a7c72720cf',
-        },
-        companyIndustry: {
-          universalIdentifier: 'ab84e651-d35b-4e02-8d69-1740af3e22f7',
-        },
-        companyLinkedIn: {
-          universalIdentifier: '4c44b956-f880-434f-b4cd-854b82076e56',
-        },
-        companyName: {
-          universalIdentifier: '1a25412b-f9ce-4406-ac53-f20d1ab8c5ea',
-        },
-        companyTags: {
-          universalIdentifier: 'ceb64d0b-1203-4c6d-af00-39b668f5f891',
-        },
-        companyTech: {
-          universalIdentifier: '11dd57c3-06bb-4722-bb65-96d0a899ca91',
-        },
-      },
-    },
-  },
-  roles: {
-    defaultRole: {
-      universalIdentifier: '66972e19-9fdb-4336-87ce-442a17fd179c',
-    },
-  },
-  views: {
-    selfHostingUserView: {
-      universalIdentifier: 'e903f0ee-52cb-4537-aca8-8940e30b023d',
-    },
-  },
-};

packages/twenty-apps/internal/self-hosting/src/fields/self-hosting-user-id.ts

@@ -1,29 +0,0 @@
-import {
-  defineField,
-  FieldType,
-  RelationType,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-import { UNIVERSAL_IDENTIFIERS } from 'src/constants/universal-identifiers.constant';
-
-export const SELF_HOSTING_USER_ID_UNIVERSAL_IDENTIFIER =
-  '9507f244-fdea-47d5-a734-725d4dae43da';
-
-export default defineField({
-  universalIdentifier: SELF_HOSTING_USER_ID_UNIVERSAL_IDENTIFIER,
-  name: 'selfHostingUsers',
-  label: 'Self hosting users',
-  description: 'Self hosting user related to the person',
-  type: FieldType.RELATION,
-  relationTargetFieldMetadataUniversalIdentifier:
-    UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personId
-      .universalIdentifier,
-  relationTargetObjectMetadataUniversalIdentifier:
-    UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.universalIdentifier,
-  objectUniversalIdentifier:
-    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
-  isNullable: true,
-  universalSettings: {
-    relationType: RelationType.ONE_TO_MANY,
-  },
-});

packages/twenty-apps/internal/self-hosting/src/logic-functions/match-telemetry-event-with-people.ts

@@ -1,94 +0,0 @@
-import {
-  defineLogicFunction,
-  type DatabaseEventPayload,
-  type ObjectRecordCreateEvent,
-  type ObjectRecordUpdateEvent,
-} from 'twenty-sdk';
-import { SELF_HOSTING_USER_NAME_SINGULAR } from 'src/objects/selfHostingUser.object';
-import { type SelfHostingUser } from 'twenty-sdk/generated/core';
-import { CoreApiClient } from 'twenty-sdk/generated';
-
-const handler = async (
-  params: DatabaseEventPayload<
-    | ObjectRecordCreateEvent<SelfHostingUser>
-    | ObjectRecordUpdateEvent<SelfHostingUser>
-  >,
-) => {
-  const [object, action] = params.name.split('.');
-
-  if (object !== SELF_HOSTING_USER_NAME_SINGULAR) {
-    return;
-  }
-
-  if (!['created', 'updated'].includes(action)) {
-    return;
-  }
-
-  const email = params.properties.after.email?.primaryEmail;
-
-  if (!email) {
-    return;
-  }
-
-  const client = new CoreApiClient();
-
-  const { people } = await client.query({
-    people: {
-      edges: { node: { id: true } },
-      __args: {
-        filter: {
-          emails: {
-            primaryEmail: { eq: email },
-          },
-        },
-      },
-    },
-  });
-
-  let personId = people?.edges[0]?.node?.id;
-
-  if (!personId) {
-    const { createPerson } = await client.mutation({
-      createPerson: {
-        __args: {
-          data: {
-            name: {
-              firstName: params.properties.after.name?.firstName,
-              lastName: params.properties.after.name?.lastName,
-            },
-            emails: {
-              primaryEmail: email,
-            },
-          },
-        },
-        id: true,
-      },
-    });
-
-    personId = createPerson?.id;
-  }
-
-  await client.mutation({
-    updateSelfHostingUser: {
-      __args: {
-        id: params.properties.after.id,
-        data: {
-          personId,
-        },
-      },
-      id: true,
-    },
-  });
-};
-
-export default defineLogicFunction({
-  universalIdentifier: '87f0293a-997a-4c7b-85e2-e77462ccf0c5',
-  name: 'match-telemetry-event-with-people',
-  description:
-    'Matches self hosting users with existing people based on email address',
-  timeoutSeconds: 10,
-  handler,
-  databaseEventTriggerSettings: {
-    eventName: `${SELF_HOSTING_USER_NAME_SINGULAR}.*`,
-  },
-});

packages/twenty-apps/internal/self-hosting/src/logic-functions/telemetryWebhook.function.ts

@@ -1,136 +0,0 @@
-import { defineLogicFunction, type RoutePayload } from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-sdk/generated';
-import { type TelemetryEvent } from 'src/logic-functions/types/telemetry-event.type';
-
-export const main = async (
-  params: RoutePayload<TelemetryEvent>,
-): Promise<{
-  success: boolean;
-  message: string;
-  error?: string;
-}> => {
-  try {
-    const {
-      action,
-      workspaceId,
-      userWorkspaceId,
-      userId,
-      userEmail,
-      userFirstName,
-      userLastName,
-      locale,
-      serverUrl,
-      serverId,
-    } = params.body || {};
-
-    if (action !== 'user_signup') {
-      return {
-        success: true,
-        message: `Event type '${action}' ignored`,
-      };
-    }
-
-    if (!userEmail) {
-      return {
-        success: true,
-        message: 'No email found in telemetry event',
-      };
-    }
-
-    if (
-      userEmail.toLowerCase().includes('example') ||
-      userEmail.toLowerCase().includes('test')
-    ) {
-      return {
-        success: true,
-        message: `Email '${userEmail}' ignored (contains test/example data)`,
-      };
-    }
-
-    const client = new CoreApiClient();
-
-    let existingSelfHostingUserId: string | undefined = undefined;
-    try {
-      const { selfHostingUser: existingSelfHostingUser } = await client.query({
-        selfHostingUser: {
-          __args: {
-            filter: {
-              email: { primaryEmail: { eq: userEmail } },
-            },
-          },
-          id: true,
-        },
-      });
-
-      existingSelfHostingUserId = existingSelfHostingUser?.id;
-    } catch {
-      //
-    }
-
-    if (existingSelfHostingUserId) {
-      await client.mutation({
-        updateSelfHostingUser: {
-          __args: {
-            id: existingSelfHostingUserId,
-            data: {
-              name: { firstName: userFirstName, lastName: userLastName },
-              email: { primaryEmail: userEmail, additionalEmails: null },
-              userWorkspaceId,
-              userId,
-              locale,
-              serverUrl,
-              serverId,
-            },
-          },
-          id: true,
-        },
-      });
-
-      return {
-        success: true,
-        message: `Self hosting user ${existingSelfHostingUserId} updated`,
-      };
-    }
-
-    const { createSelfHostingUser } = await client.mutation({
-      createSelfHostingUser: {
-        __args: {
-          data: {
-            name: { firstName: userFirstName, lastName: userLastName },
-            email: { primaryEmail: userEmail, additionalEmails: null },
-            workspaceId,
-            userWorkspaceId,
-            userId,
-            locale,
-            serverUrl,
-            serverId,
-          },
-        },
-        id: true,
-      },
-    });
-
-    return {
-      success: true,
-      message: `Self hosting user ${createSelfHostingUser?.id} created`,
-    };
-  } catch (error) {
-    return {
-      success: false,
-      message: 'Failed to process telemetry event',
-      error: error instanceof Error ? error.message : String(error),
-    };
-  }
-};
-
-export default defineLogicFunction({
-  universalIdentifier: '10104201-622b-4a5e-9f27-8f2af19b2a3c',
-  name: 'telemetry-webhook',
-  timeoutSeconds: 10,
-  handler: main,
-  httpRouteTriggerSettings: {
-    path: '/webhook/telemetry',
-    httpMethod: 'POST',
-    isAuthRequired: false,
-  },
-});

packages/twenty-apps/internal/self-hosting/src/logic-functions/types/telemetry-event.type.ts

@@ -1,12 +0,0 @@
-export type TelemetryEvent = {
-  action: string;
-  workspaceId?: string;
-  userWorkspaceId?: string;
-  userId: string;
-  userEmail?: string;
-  userFirstName?: string;
-  userLastName?: string;
-  locale?: string;
-  serverUrl: string;
-  serverId: string;
-};

packages/twenty-apps/internal/self-hosting/src/navigation-menu-items/self-host-user-navigation-menu-item.ts

@@ -1,11 +0,0 @@
-import { defineNavigationMenuItem } from 'twenty-sdk';
-import { UNIVERSAL_IDENTIFIERS } from 'src/constants/universal-identifiers.constant';
-
-export default defineNavigationMenuItem({
-  universalIdentifier: 'fe3aaca4-9eda-4565-b215-5d268fbf8164',
-  name: 'Self host user',
-  icon: 'IconList',
-  position: 1,
-  viewUniversalIdentifier:
-    UNIVERSAL_IDENTIFIERS.views.selfHostingUserView.universalIdentifier,
-});

packages/twenty-apps/internal/self-hosting/src/objects/selfHostingUser.object.ts

@@ -1,354 +0,0 @@
-import {
-  defineObject,
-  FieldType,
-  RelationType,
-  OnDeleteAction,
-  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
-} from 'twenty-sdk';
-import { UNIVERSAL_IDENTIFIERS } from 'src/constants/universal-identifiers.constant';
-
-import { SELF_HOSTING_USER_ID_UNIVERSAL_IDENTIFIER } from 'src/fields/self-hosting-user-id';
-
-export const SELF_HOSTING_USER_NAME_SINGULAR = 'selfHostingUser';
-
-export default defineObject({
-  universalIdentifier:
-    UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.universalIdentifier,
-  nameSingular: SELF_HOSTING_USER_NAME_SINGULAR,
-  namePlural: 'selfHostingUsers',
-  labelSingular: 'Self Hosting User',
-  labelPlural: 'Self Hosting Users',
-  fields: [
-    {
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personId
-          .universalIdentifier,
-      name: 'person',
-      label: 'Person',
-      description: 'Person matching with the self hosting user',
-      type: FieldType.RELATION,
-      relationTargetFieldMetadataUniversalIdentifier:
-        SELF_HOSTING_USER_ID_UNIVERSAL_IDENTIFIER,
-      relationTargetObjectMetadataUniversalIdentifier:
-        STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
-      isNullable: true,
-      universalSettings: {
-        relationType: RelationType.MANY_TO_ONE,
-        onDelete: OnDeleteAction.SET_NULL,
-        joinColumnName: 'personId',
-      },
-    },
-    {
-      type: FieldType.FULL_NAME,
-      name: 'name',
-      label: 'Name',
-      description: 'Name of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.name
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.EMAILS,
-      name: 'email',
-      label: 'Email',
-      description: 'The email of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.email
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.LINKS,
-      name: 'domain',
-      label: 'Domain',
-      description:
-        'Domain extracted from the email address (e.g. domain.com / https://domain.com/)',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.domain
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.UUID,
-      name: 'userWorkspaceId',
-      label: 'User workspace Id',
-      description: 'User workspace id of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.userWorkspaceId
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.UUID,
-      name: 'userId',
-      label: 'User Id',
-      description: 'User id of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.userId
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'locale',
-      label: 'Locale',
-      description: 'Locale of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.locale
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'serverUrl',
-      label: 'Server url',
-      description: 'Server url of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.serverUrl
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'serverId',
-      label: 'Server id',
-      description: 'Server id of the self hosting user',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.serverId
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.NUMBER,
-      name: 'numberOfEmailsWithSameDomain',
-      label: 'Number of Emails with Same Domain',
-      description:
-        'Aggregated count of self hosting users sharing the same business domain',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .numberOfEmailsWithSameDomain.universalIdentifier,
-    },
-    {
-      type: FieldType.BOOLEAN,
-      name: 'isEnriched',
-      label: 'Is Enriched',
-      description: 'Whether the record has been enriched',
-      defaultValue: false,
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.isEnriched
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.BOOLEAN,
-      name: 'triedToBeEnriched',
-      label: 'Tried to Be Enriched',
-      description: 'Whether an enrichment attempt has been made',
-      defaultValue: false,
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.triedToBeEnriched
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.BOOLEAN,
-      name: 'isPersonalEmail',
-      label: 'Is Personal Email',
-      description: 'Whether the email is a personal email address',
-      defaultValue: true,
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.isPersonalEmail
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.BOOLEAN,
-      name: 'isTwenty',
-      label: 'Is Twenty',
-      description: 'Whether the user is from Twenty',
-      defaultValue: false,
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.isTwenty
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'personCity',
-      label: 'Person City',
-      description: 'City of the person',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personCity
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'personCountry',
-      label: 'Person Country',
-      description: 'Country of the person',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personCountry
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'personJobFunction',
-      label: 'Person Job Function',
-      description: 'Job function of the person',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personJobFunction
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'personJobTitle',
-      label: 'Person Job Title',
-      description: 'Job title of the person',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personJobTitle
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.LINKS,
-      name: 'personLinkedIn',
-      label: 'Person LinkedIn',
-      description: 'LinkedIn profile of the person',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personLinkedIn
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'personSeniority',
-      label: 'Person Seniority',
-      description: 'Seniority level of the person',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personSeniority
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.NUMBER,
-      name: 'companyAlexaRank',
-      label: 'Company Alexa Rank',
-      description: 'Alexa rank of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyAlexaRank
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.CURRENCY,
-      name: 'companyAnnualRevenue',
-      label: 'Company Annual Revenue',
-      description: 'Annual revenue of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyAnnualRevenue.universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyAnnualRevenuePrinted',
-      label: 'Company Annual Revenue Printed',
-      description: 'Formatted annual revenue of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyAnnualRevenuePrinted.universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyDescription',
-      label: 'Company Description',
-      description: 'Description of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyDescription
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.NUMBER,
-      name: 'companyEmployees',
-      label: 'Company Employees',
-      description: 'Number of employees at the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyEmployees
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyFoundedYear',
-      label: 'Company Founded Year',
-      description: 'Year the company was founded',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyFoundedYear
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyFundingLatestStage',
-      label: 'Company Funding Latest Stage',
-      description: 'Latest funding stage of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyFundingLatestStage.universalIdentifier,
-    },
-    {
-      type: FieldType.NUMBER,
-      name: 'companyFundingTotalAmount',
-      label: 'Company Funding Total Amount',
-      description: 'Total funding amount of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyFundingTotalAmount.universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyFundingTotalAmountPrinted',
-      label: 'Company Funding Total Amount Printed',
-      description: 'Formatted total funding amount of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyFundingTotalAmountPrinted.universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyIndustries',
-      label: 'Company Industries',
-      description: 'Industries the company operates in',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyIndustries
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyIndustry',
-      label: 'Company Industry',
-      description: 'Primary industry of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyIndustry
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.LINKS,
-      name: 'companyLinkedIn',
-      label: 'Company LinkedIn',
-      description: 'LinkedIn page of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyLinkedIn
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.TEXT,
-      name: 'companyName',
-      label: 'Company Name',
-      description: 'Name of the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyName
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.ARRAY,
-      name: 'companyTags',
-      label: 'Company Tags',
-      description: 'Tags associated with the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyTags
-          .universalIdentifier,
-    },
-    {
-      type: FieldType.ARRAY,
-      name: 'companyTech',
-      label: 'Company Tech',
-      description: 'Technologies used by the company',
-      universalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyTech
-          .universalIdentifier,
-    },
-  ],
-});

packages/twenty-apps/internal/self-hosting/src/roles/default-role.ts

@@ -1,13 +0,0 @@
-import { defineRole } from 'twenty-sdk';
-import { UNIVERSAL_IDENTIFIERS } from 'src/constants/universal-identifiers.constant';
-
-export default defineRole({
-  universalIdentifier:
-    UNIVERSAL_IDENTIFIERS.roles.defaultRole.universalIdentifier,
-  label: 'default role',
-  description: 'Add a description for your role',
-  canReadAllObjectRecords: true,
-  canUpdateAllObjectRecords: true,
-  canSoftDeleteAllObjectRecords: true,
-  canDestroyAllObjectRecords: false,
-});

packages/twenty-apps/internal/self-hosting/src/views/self-hosting-user-view.ts

@@ -1,308 +0,0 @@
-import { defineView } from 'twenty-sdk';
-import { UNIVERSAL_IDENTIFIERS } from 'src/constants/universal-identifiers.constant';
-
-export default defineView({
-  universalIdentifier:
-    UNIVERSAL_IDENTIFIERS.views.selfHostingUserView.universalIdentifier,
-  name: 'Self hosting users',
-  objectUniversalIdentifier:
-    UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.universalIdentifier,
-  icon: 'IconList',
-  position: 0,
-  fields: [
-    {
-      universalIdentifier: '243a2401-cd13-440c-8dcd-649e26df36bc',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.name
-          .universalIdentifier,
-      position: 0,
-      isVisible: true,
-      size: 150,
-    },
-    {
-      universalIdentifier: 'dfa75ef8-d40d-416f-9f1c-3e86edfa9fce',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.email
-          .universalIdentifier,
-      position: 1,
-      isVisible: true,
-      size: 150,
-    },
-    {
-      universalIdentifier: '15cc9215-eb48-4487-a92e-a25d8e99702f',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.domain
-          .universalIdentifier,
-      position: 2,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: '0f9e4f63-3664-443a-9f06-8a6cc04c1d90',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personId
-          .universalIdentifier,
-      position: 2.1,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: 'dcf88ae8-e71d-452f-b51e-d88cbc6dd273',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.userWorkspaceId
-          .universalIdentifier,
-      position: 3,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: 'aad70516-936b-41d1-b6c6-961a22299761',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.userId
-          .universalIdentifier,
-      position: 4,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '8c210eb0-bdda-476e-9f98-42f909872f2a',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.locale
-          .universalIdentifier,
-      position: 5,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '367abe85-11c4-440f-80a2-663edd6b4231',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.serverUrl
-          .universalIdentifier,
-      position: 6,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '32c199d6-ebf3-434b-81b4-e2b59a0518b7',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.serverId
-          .universalIdentifier,
-      position: 6.1,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '924ee786-ab93-44be-9d21-941ff9ffe1ac',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .numberOfEmailsWithSameDomain.universalIdentifier,
-      position: 7,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '2feadf3d-e251-4356-add8-7fa70dea5401',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.isEnriched
-          .universalIdentifier,
-      position: 8,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: 'de252ae6-c723-4bf7-96cf-d93f5a539f36',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.triedToBeEnriched
-          .universalIdentifier,
-      position: 9,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: 'b121e8e6-b3eb-4f6c-b67e-c7c6d19e1bc5',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.isPersonalEmail
-          .universalIdentifier,
-      position: 10,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '0ada0bcc-8d6b-4df6-bcc1-78ba14cb04e6',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.isTwenty
-          .universalIdentifier,
-      position: 11,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: 'ec7c8d51-ea63-41bd-9eb1-995835b94218',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personCity
-          .universalIdentifier,
-      position: 12,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '7522dd84-0d23-48e7-85dd-f0a8d9e275f8',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personCountry
-          .universalIdentifier,
-      position: 13,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '54191cb9-4d5c-466e-affb-d9ba4adeff87',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personJobFunction
-          .universalIdentifier,
-      position: 14,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: 'ace75fc7-fb20-4e53-a9a2-6a7529befaf0',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personJobTitle
-          .universalIdentifier,
-      position: 15,
-      isVisible: true,
-      size: 180,
-    },
-    {
-      universalIdentifier: 'a0b42d61-4553-42eb-aca4-327b9bf9f30e',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personLinkedIn
-          .universalIdentifier,
-      position: 16,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '74bc7dd2-fe53-4ff4-8778-2768f3439571',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.personSeniority
-          .universalIdentifier,
-      position: 17,
-      isVisible: true,
-      size: 180,
-    },
-    {
-      universalIdentifier: '61b34f41-8d56-472d-ab1e-414703c6ca12',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyAlexaRank
-          .universalIdentifier,
-      position: 18,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '5bb7d36b-6a73-4832-b41e-f67130a4708f',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyAnnualRevenue.universalIdentifier,
-      position: 19,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: 'ae6f23ce-006c-41dd-82a1-e9fe7b65bce3',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyAnnualRevenuePrinted.universalIdentifier,
-      position: 20,
-      isVisible: true,
-      size: 250,
-    },
-    {
-      universalIdentifier: 'dd2a4728-a743-43bb-b096-9e7bd5125e56',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyDescription
-          .universalIdentifier,
-      position: 21,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: 'ecca02c9-db2e-41e2-b571-b5db75054b56',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyEmployees
-          .universalIdentifier,
-      position: 22,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '2e76775b-f8b8-4184-8cd3-72d2b93edaa2',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyFoundedYear
-          .universalIdentifier,
-      position: 23,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: 'a7eb002c-6f0c-48ba-a9eb-247c498ad9bd',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyFundingLatestStage.universalIdentifier,
-      position: 24,
-      isVisible: true,
-      size: 240,
-    },
-    {
-      universalIdentifier: '61be97f6-20da-4b2b-861d-32345e0f9953',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyFundingTotalAmount.universalIdentifier,
-      position: 25,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '55720810-3120-4e76-bcf2-2da9517edbbc',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields
-          .companyFundingTotalAmountPrinted.universalIdentifier,
-      position: 26,
-      isVisible: true,
-      size: 280,
-    },
-    {
-      universalIdentifier: '01e31752-cbc1-499a-8ecf-504dd402d7e2',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyIndustries
-          .universalIdentifier,
-      position: 27,
-      isVisible: true,
-      size: 200,
-    },
-    {
-      universalIdentifier: '2e1c8b8b-469b-483e-8348-1fe3d1764e17',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyIndustry
-          .universalIdentifier,
-      position: 28,
-      isVisible: true,
-      size: 180,
-    },
-    {
-      universalIdentifier: '976cc8ae-6cf8-4c30-8da4-5bf61e799893',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyLinkedIn
-          .universalIdentifier,
-      position: 29,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '5f0776b3-2849-4b9b-82f0-baa38c6d889d',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyName
-          .universalIdentifier,
-      position: 30,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '86f0397a-2924-4e5c-a610-3c9ad7bb4923',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyTags
-          .universalIdentifier,
-      position: 31,
-      isVisible: true,
-    },
-    {
-      universalIdentifier: '562084f4-1242-4e60-868b-1d9b268a35b0',
-      fieldMetadataUniversalIdentifier:
-        UNIVERSAL_IDENTIFIERS.objects.selfHostingUser.fields.companyTech
-          .universalIdentifier,
-      position: 32,
-      isVisible: true,
-    },
-  ],
-});

packages/twenty-apps/internal/self-hosting/tsconfig.json

@@ -5,14 +5,13 @@
     "declaration": true,
     "outDir": "./dist",
     "rootDir": ".",
-    "jsx": "react-jsx",
     "moduleResolution": "node",
     "allowSyntheticDefaultImports": true,
     "emitDecoratorMetadata": true,
     "experimentalDecorators": true,
     "importHelpers": true,
     "allowUnreachableCode": false,
-    "strict": true,
+    "strictNullChecks": true,
     "alwaysStrict": true,
     "noImplicitAny": true,
     "strictBindCallApply": false,
@@ -27,5 +26,10 @@
       "~/*": ["./*"]
     }
   },
-  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts",
+    "**/*.spec.ts"
+  ]
 }

packages/twenty-docs/developers/contribute/capabilities/frontend-development/style-guide.mdx

@@ -194,7 +194,7 @@ setHotkeyScopeAndMemorizePreviousScope(
 
 ### Use StyledComponents
 
-Style the components with [Linaria styled](https://github.com/callstack/linaria).
+Style the components with [styled-components](https://emotion.sh/docs/styled).
 
 ```tsx
 // ❌ Bad

packages/twenty-docs/developers/extend/capabilities/apps.mdx

@@ -60,9 +60,6 @@ yarn twenty function:logs
 # Execute a function by name
 yarn twenty function:execute -n my-function -p '{"name": "test"}'
 
-# Execute the pre-install function
-yarn twenty function:execute --preInstall
-
 # Execute the post-install function
 yarn twenty function:execute --postInstall
 
@@ -82,7 +79,7 @@ When you run `npx create-twenty-app@latest my-twenty-app`, the scaffolder:
 - Copies a minimal base application into `my-twenty-app/`
 - Adds a local `twenty-sdk` dependency and Yarn 4 configuration
 - Creates config files and scripts wired to the `twenty` CLI
-- Generates core files (application config, default function role, pre-install and post-install functions) plus example files based on the scaffolding mode
+- Generates core files (application config, default function role, post-install function) plus example files based on the scaffolding mode
 
 A freshly scaffolded app with the default `--exhaustive` mode looks like this:
 
@@ -109,7 +106,6 @@ my-twenty-app/
   │   └── example-field.ts              # Example standalone field definition
   ├── logic-functions/
   │   ├── hello-world.ts                # Example logic function
-  │   ├── pre-install.ts                # Pre-install logic function
   │   └── post-install.ts               # Post-install logic function
   ├── front-components/
   │   └── hello-world.tsx               # Example front component
@@ -121,7 +117,7 @@ my-twenty-app/
       └── example-skill.ts                # Example AI agent skill definition
 ```
 
-With `--minimal`, only the core files are created (`application-config.ts`, `roles/default-role.ts`, `logic-functions/pre-install.ts`, and `logic-functions/post-install.ts`). With `--interactive`, you choose which example files to include.
+With `--minimal`, only the core files are created (`application-config.ts`, `roles/default-role.ts`, and `logic-functions/post-install.ts`). With `--interactive`, you choose which example files to include.
 
 At a high level:
 
@@ -142,8 +138,6 @@ The SDK detects entities by parsing your TypeScript files for **`export default
 |-----------------|-------------|
 | `defineObject()` | Custom object definitions |
 | `defineLogicFunction()` | Logic function definitions |
-| `definePreInstallLogicFunction()` | Pre-install logic function (runs before installation) |
-| `definePostInstallLogicFunction()` | Post-install logic function (runs after installation) |
 | `defineFrontComponent()` | Front component definitions |
 | `defineRole()` | Role definitions |
 | `defineField()` | Field extensions for existing objects |
@@ -218,8 +212,6 @@ The SDK provides helper functions for defining your app entities. As described i
 | `defineApplication()` | Configure application metadata (required, one per app) |
 | `defineObject()` | Define custom objects with fields |
 | `defineLogicFunction()` | Define logic functions with handlers |
-| `definePreInstallLogicFunction()` | Define a pre-install logic function (one per app) |
-| `definePostInstallLogicFunction()` | Define a post-install logic function (one per app) |
 | `defineFrontComponent()` | Define front components for custom UI |
 | `defineRole()` | Configure role permissions and object access |
 | `defineField()` | Extend existing objects with additional fields |
@@ -326,7 +318,6 @@ Every app has a single `application-config.ts` file that describes:
 - **Who the app is**: identifiers, display name, and description.
 - **How its functions run**: which role they use for permissions.
 - **(Optional) variables**: key–value pairs exposed to your functions as environment variables.
-- **(Optional) pre-install function**: a logic function that runs before the app is installed.
 - **(Optional) post-install function**: a logic function that runs after the app is installed.
 
 Use `defineApplication()` to define your application configuration:
@@ -335,6 +326,7 @@ Use `defineApplication()` to define your application configuration:
 // src/application-config.ts
 import { defineApplication } from 'twenty-sdk';
 import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';
 
 export default defineApplication({
   universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
@@ -350,6 +342,7 @@ export default defineApplication({
     },
   },
   defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
 });
 ```
 
@@ -357,7 +350,7 @@ Notes:
 - `universalIdentifier` fields are deterministic IDs you own; generate them once and keep them stable across syncs.
 - `applicationVariables` become environment variables for your functions (for example, `DEFAULT_RECIPIENT_NAME` is available as `process.env.DEFAULT_RECIPIENT_NAME`).
 - `defaultRoleUniversalIdentifier` must match the role file (see below).
-- Pre-install and post-install functions are automatically detected during the manifest build. See [Pre-install functions](#pre-install-functions) and [Post-install functions](#post-install-functions).
+- `postInstallLogicFunctionUniversalIdentifier` (optional) points to a logic function that runs automatically after the app is installed. See [Post-install functions](#post-install-functions).
 
 #### Roles and permissions
 
@@ -490,43 +483,6 @@ Notes:
 - The `triggers` array is optional. Functions without triggers can be used as utility functions called by other functions.
 - You can mix multiple trigger types in a single function.
 
-### Pre-install functions
-
-A pre-install function is a logic function that runs automatically before your app is installed on a workspace. This is useful for validation tasks, prerequisite checks, or preparing workspace state before the main installation proceeds.
-
-When you scaffold a new app with `create-twenty-app`, a pre-install function is generated for you at `src/logic-functions/pre-install.ts`:
-
-```typescript
-// src/logic-functions/pre-install.ts
-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: '<generated-uuid>',
-  name: 'pre-install',
-  description: 'Runs before installation to prepare the application.',
-  timeoutSeconds: 300,
-  handler,
-});
-```
-
-You can also manually execute the pre-install function at any time using the CLI:
-
-```bash filename="Terminal"
-yarn twenty function:execute --preInstall
-```
-
-Key points:
-- Pre-install functions use `definePreInstallLogicFunction()` — a specialized variant that omits trigger settings (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `isTool`).
-- The handler receives an `InstallLogicFunctionPayload` with `{ previousVersion: string }` — the version of the app that was previously installed (or an empty string for fresh installs).
-- Only one pre-install function is allowed per application. The manifest build will error if more than one is detected.
-- The function's `universalIdentifier` is automatically set as `preInstallLogicFunctionUniversalIdentifier` on the application manifest during the build — you do not need to reference it in `defineApplication()`.
-- The default timeout is set to 300 seconds (5 minutes) to allow for longer preparation tasks.
-- Pre-install functions do not need triggers — they are invoked by the platform before installation or manually via `function:execute --preInstall`.
-
 ### Post-install functions
 
 A post-install function is a logic function that runs automatically after your app is installed on a workspace. This is useful for one-time setup tasks such as seeding default data, creating initial records, or configuring workspace settings.
@@ -535,14 +491,16 @@ When you scaffold a new app with `create-twenty-app`, a post-install function is
 
 ```typescript
 // src/logic-functions/post-install.ts
-import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+import { defineLogicFunction } from 'twenty-sdk';
 
-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Post install logic function executed successfully!', payload.previousVersion);
+export const POST_INSTALL_UNIVERSAL_IDENTIFIER = '<generated-uuid>';
+
+const handler = async (): Promise<void> => {
+  console.log('Post install logic function executed successfully!');
 };
 
-export default definePostInstallLogicFunction({
-  universalIdentifier: '<generated-uuid>',
+export default defineLogicFunction({
+  universalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
   name: 'post-install',
   description: 'Runs after installation to set up the application.',
   timeoutSeconds: 300,
@@ -550,6 +508,17 @@ export default definePostInstallLogicFunction({
 });
 ```
 
+The function is wired into your app by referencing its universal identifier in `application-config.ts`:
+
+```typescript
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';
+
+export default defineApplication({
+  // ...
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
+});
+```
+
 You can also manually execute the post-install function at any time using the CLI:
 
 ```bash filename="Terminal"
@@ -557,10 +526,8 @@ yarn twenty function:execute --postInstall
 ```
 
 Key points:
-- Post-install functions use `definePostInstallLogicFunction()` — a specialized variant that omits trigger settings (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `isTool`).
-- The handler receives an `InstallLogicFunctionPayload` with `{ previousVersion: string }` — the version of the app that was previously installed (or an empty string for fresh installs).
-- Only one post-install function is allowed per application. The manifest build will error if more than one is detected.
-- The function's `universalIdentifier` is automatically set as `postInstallLogicFunctionUniversalIdentifier` on the application manifest during the build — you do not need to reference it in `defineApplication()`.
+- Post-install functions are standard logic functions — they use `defineLogicFunction()` like any other function.
+- The `postInstallLogicFunctionUniversalIdentifier` field in `defineApplication()` is optional. If omitted, no function runs after installation.
 - The default timeout is set to 300 seconds (5 minutes) to allow for longer setup tasks like data seeding.
 - Post-install functions do not need triggers — they are invoked by the platform during installation or manually via `function:execute --postInstall`.
 

packages/twenty-docs/developers/self-host/capabilities/troubleshooting.mdx

@@ -136,7 +136,7 @@ That's expected as user is unauthorized when logged out since its identity is no
 Comment out checker plugin in `packages/twenty-ui/vite-config.ts` like in example below
 ```
 plugins: [
-      react({ jsxImportSource: 'react' }),
+      react({ jsxImportSource: '@emotion/react' }),
       tsconfigPaths(),
       svgr(),
       dts(dtsConfig),

packages/twenty-docs/l/ar/developers/contribute/capabilities/frontend-development/best-practices-front.mdx

@@ -8,7 +8,7 @@ title: أفضل الممارسات
 
 تقوم React و Jotai بإدارة الحالة في قاعدة الشيفرة.
 
-### استخدم ذرات Jotai لتخزين الحالة
+### استخدم `useAtomState` لتخزين الحالة
 
 من الجيد إنشاء أكبر عدد ممكن من الذرات لتخزين الحالة الخاصة بك.
 
@@ -45,7 +45,7 @@ export const MyComponent = () => {
 
 تجنب استخدام `useRef` لتخزين الحالة.
 
-إذا كنت ترغب في تخزين الحالة، يجب أن تستخدم `useState` أو ذرات Jotai مع `useAtomState`.
+If you want to store state, you should use `useState` or `useAtomState`.
 
 انظر [كيفية إدارة إعادة العرض](#managing-re-renders) إذا شعرت أنك بحاجة إلى `useRef` لمنع بعض إعادة العرض من الحدوث.
 
@@ -82,7 +82,7 @@ If you feel like you need to add a `useEffect` in your root component, you shoul
 يمكنك تطبيق نفس الشيء على منطق جلب البيانات، مع الخُطافات Apollo.
 
 ```tsx
-// ❌ سيئ، سيتسبب في إعادة التصيير حتى إذا لم تتغير البيانات،
+// ❌ سيّئ، سيتسبب في إعادة التصيير حتى إذا لم تتغير البيانات،
 //    لأن useEffect يحتاج إلى إعادة التقييم
 export const PageComponent = () => {
   const [data, setData] = useAtomState(dataState);
@@ -132,9 +132,9 @@ export const App = () => (
 );
 ```
 
-### استخدم حالات عائلة الذرات والمحددات
+### استخدم حالات عائلة Jotai ومحددات عائلة Jotai
 
-تُعد حالات عائلة الذرات والمحددات طريقة رائعة لتجنّب عمليات إعادة التصيير.
+حالات عائلة Jotai والمحددات تعتبر طريقة رائعة لتجنب إعادة العرض.
 
 إنها مفيدة عندما تحتاج إلى تخزين قائمة من العناصر.
 

packages/twenty-docs/l/ar/developers/contribute/capabilities/frontend-development/folder-architecture-front.mdx

@@ -84,7 +84,7 @@ module1
 
 تشمل منطق إدارة الحالة. [Jotai](https://jotai.org) يتولّى ذلك.
 
-* المحددات: الذرات المشتقة (باستخدام `createAtomSelector`) تحسب قيماً من ذرات أخرى وتخزن نتائجها في الذاكرة مؤقتاً تلقائياً.
+* المحددات: الذرات المشتقة (باستخدام `createAtomSelector`) تحسب القيم من ذرات أخرى ويتم تخزينها تلقائيًا.
 
 لا تزال إدارة الحالة المدمجة في React تتولّى الحالة داخل المكوّن.
 

packages/twenty-docs/l/ar/developers/contribute/capabilities/frontend-development/frontend-commands.mdx

@@ -49,7 +49,7 @@ title: أوامر الواجهة الأمامية
 * "[React](https://react.dev/)"
 * "[Apollo](https://www.apollographql.com/docs/)"
 * "[GraphQL Codegen](https://the-guild.dev/graphql/codegen)"
-* [Jotai](https://jotai.org/)
+* "[Jotai](https://jotai.org/)"
 * "[TypeScript](https://www.typescriptlang.org/)"
 
 **الاختبار**
@@ -73,7 +73,7 @@ To avoid unnecessary [re-renders](/l/ar/developers/contribute/capabilities/front
 
 ### "إدارة الحالة"
 
-[Jotai](https://jotai.org/) يتعامل مع إدارة الحالة.
+"[Jotai](https://jotai.org/) يتعامل مع إدارة الحالة."
 
 "راجع [أفضل الممارسات](/l/ar/developers/contribute/capabilities/frontend-development/best-practices-front#state-management) لمزيد من المعلومات حول إدارة الحالة."
 

packages/twenty-docs/l/ar/developers/contribute/capabilities/frontend-development/hotkeys.mdx

@@ -160,7 +160,7 @@ export enum PageHotkeyScope {
 }
 ```
 
-داخليًا، يتم تخزين النطاق المحدد حاليًا في ذرة Jotai مشتركة عبر التطبيق:
+داخليًا، يتم تخزين النطاق المحدد حاليًا في حالة Jotai مشتركة عبر التطبيق:
 
 ```tsx
 export const currentHotkeyScopeState = createState<HotkeyScope>({
@@ -169,10 +169,10 @@ export const currentHotkeyScopeState = createState<HotkeyScope>({
 });
 ```
 
-لكن لا يجب التعامل مع هذه الذرة يدويًا! سنرى كيف يمكن استخدامها في القسم التالي.
+لكن لا يجب التعامل مع هذه الحالة Jotai يدويًا! سنرى كيف يمكن استخدامها في القسم التالي.
 
 ## كيف يعمل داخليًا؟
 
 قمنا بإنشاء غلاف رقيق فوق [react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) والذي يجعله أكثر كفاءة ويتجنب عمليات إعادة التقديم غير الضرورية.
 
-ونقوم أيضًا بإنشاء ذرة Jotai للتعامل مع حالة نطاق مفاتيح الاختصار وجعلها متاحة في جميع أنحاء التطبيق.
+ونقوم أيضًا بإنشاء حالة Jotai للتعامل مع حالة نطاق المفتاح وجعلها متاحة في جميع أنحاء التطبيق.

packages/twenty-docs/l/ar/developers/contribute/capabilities/frontend-development/style-guide.mdx

@@ -194,7 +194,7 @@ setHotkeyScopeAndMemorizePreviousScope(
 
 ### استخدام مكونات منسقة
 
-قم بتنسيق المكونات باستخدام [Linaria styled](https://github.com/callstack/linaria).
+قم بتنسيق المكونات باستخدام [styled-components](https://emotion.sh/docs/styled).
 
 ```tsx
 // ❌ سيء

packages/twenty-docs/l/ar/developers/extend/capabilities/apps.mdx

@@ -52,25 +52,22 @@ npx create-twenty-app@latest my-app --interactive
 من هنا يمكنك:
 
 ```bash filename="Terminal"
-# أضف كيانًا جديدًا إلى تطبيقك (موجّه)
+# Add a new entity to your application (guided)
 yarn twenty entity:add
 
-# راقب سجلات وظائف تطبيقك
+# Watch your application's function logs
 yarn twenty function:logs
 
-# نفّذ وظيفة بالاسم
+# Execute a function by name
 yarn twenty function:execute -n my-function -p '{"name": "test"}'
 
-# نفّذ دالة ما قبل التثبيت
-yarn twenty function:execute --preInstall
-
-# نفّذ دالة ما بعد التثبيت
+# Execute the post-install function
 yarn twenty function:execute --postInstall
 
-# أزل تثبيت التطبيق من مساحة العمل الحالية
+# Uninstall the application from the current workspace
 yarn twenty app:uninstall
 
-# اعرض مساعدة الأوامر
+# Display commands' help
 yarn twenty help
 ```
 
@@ -83,7 +80,7 @@ yarn twenty help
 * ينسخ تطبيقًا أساسيًا مصغّرًا إلى `my-twenty-app/`
 * يضيف اعتمادًا محليًا `twenty-sdk` وتهيئة Yarn 4
 * ينشئ ملفات ضبط ونصوصًا مرتبطة بـ `twenty` CLI
-* يُنشئ الملفات الأساسية (تهيئة التطبيق، دور الدالة الافتراضي، دالتا ما قبل التثبيت وما بعد التثبيت) بالإضافة إلى ملفات أمثلة استنادًا إلى وضع الإنشاء.
+* يُنشئ الملفات الأساسية (تهيئة التطبيق، دور الدالة الافتراضي، دالة ما بعد التثبيت) بالإضافة إلى ملفات الأمثلة بحسب وضع الإنشاء
 
 يبدو التطبيق المُنشأ حديثًا باستخدام الوضع الافتراضي `--exhaustive` كما يلي:
 
@@ -110,7 +107,6 @@ my-twenty-app/
   │   └── example-field.ts              # تعريف حقل مستقل — مثال
   ├── logic-functions/
   │   ├── hello-world.ts                # دالة منطقية — مثال
-  │   ├── pre-install.ts                # دالة منطقية لما قبل التثبيت
   │   └── post-install.ts               # دالة منطقية لما بعد التثبيت
   ├── front-components/
   │   └── hello-world.tsx               # مكوّن واجهة أمامية — مثال
@@ -122,7 +118,7 @@ my-twenty-app/
       └── example-skill.ts                # تعريف مهارة لوكيل الذكاء الاصطناعي — مثال
 ```
 
-مع `--minimal`، سيتم إنشاء الملفات الأساسية فقط (`application-config.ts`، `roles/default-role.ts`، `logic-functions/pre-install.ts`، و`logic-functions/post-install.ts`). مع `--interactive`، تختار ملفات الأمثلة التي تريد تضمينها.
+مع `--minimal`، سيتم إنشاء الملفات الأساسية فقط (`application-config.ts` و`roles/default-role.ts` و`logic-functions/post-install.ts`). مع `--interactive`، تختار ملفات الأمثلة التي تريد تضمينها.
 
 بشكل عام:
 
@@ -139,18 +135,16 @@ my-twenty-app/
 
 يكتشف SDK الكيانات عبر تحليل ملفات TypeScript الخاصة بك بحثًا عن استدعاءات **`export default define<Entity>({...})`**. يحتوي كل نوع كيان على دالة مساعدة مقابلة يتم تصديرها من `twenty-sdk`:
 
-| دالة مساعدة                        | نوع الكيان                                     |
-| ---------------------------------- | ---------------------------------------------- |
-| `defineObject()`                   | تعريفات كائنات مخصصة                           |
-| `defineLogicFunction()`            | تعريفات الوظائف المنطقية                       |
-| `definePreInstallLogicFunction()`  | دالة منطقية لما قبل التثبيت (تعمل قبل التثبيت) |
-| `definePostInstallLogicFunction()` | دالة منطقية لما بعد التثبيت (تعمل بعد التثبيت) |
-| `defineFrontComponent()`           | Front component definitions                    |
-| `defineRole()`                     | تعريفات الأدوار                                |
-| `defineField()`                    | امتدادات الحقول للكائنات الموجودة              |
-| `defineView()`                     | تعريفات العروض المحفوظة                        |
-| `defineNavigationMenuItem()`       | تعريفات عناصر قائمة التنقل                     |
-| `defineSkill()`                    | تعريفات مهارات وكيل الذكاء الاصطناعي           |
+| دالة مساعدة                  | نوع الكيان                           |
+| ---------------------------- | ------------------------------------ |
+| `defineObject()`             | تعريفات كائنات مخصصة                 |
+| `defineLogicFunction()`      | تعريفات الوظائف المنطقية             |
+| `defineFrontComponent()`     | Front component definitions          |
+| `defineRole()`               | تعريفات الأدوار                      |
+| `defineField()`              | امتدادات الحقول للكائنات الموجودة    |
+| `defineView()`               | تعريفات العروض المحفوظة              |
+| `defineNavigationMenuItem()` | تعريفات عناصر قائمة التنقل           |
+| `defineSkill()`              | تعريفات مهارات وكيل الذكاء الاصطناعي |
 
 <Note>
 **تسمية الملفات مرنة.** يعتمد اكتشاف الكيانات على بنية الشجرة المجردة (AST) — إذ يقوم SDK بفحص ملفات المصدر لديك بحثًا عن النمط `export default define<Entity>({...})`. يمكنك تنظيم ملفاتك ومجلداتك كيفما تشاء. التجميع حسب نوع الكيان (مثلًا، `logic-functions/` و`roles/`) هو مجرد عرف لتنظيم الشيفرة، وليس مطلبًا إلزاميًا.
@@ -215,19 +209,17 @@ yarn twenty auth:status
 
 يوفّر SDK دوالًا مساعدة لتعريف كيانات تطبيقك. كما هو موضح في [اكتشاف الكيانات](#entity-detection)، يجب استخدام `export default define<Entity>({...})` كي يتم اكتشاف كياناتك:
 
-| دالة                               | الغرض                                                |
-| ---------------------------------- | ---------------------------------------------------- |
-| `defineApplication()`              | تهيئة بيانات التعريف للتطبيق (مطلوب، واحد لكل تطبيق) |
-| `defineObject()`                   | تعريف كائنات مخصصة مع حقول                           |
-| `defineLogicFunction()`            | تعريف وظائف منطقية مع معالجات                        |
-| `definePreInstallLogicFunction()`  | تعريف دالة منطقية لما قبل التثبيت (واحدة لكل تطبيق)  |
-| `definePostInstallLogicFunction()` | تعريف دالة منطقية لما بعد التثبيت (واحدة لكل تطبيق)  |
-| `defineFrontComponent()`           | عرِّف مكوّنات أمامية لواجهة مستخدم مخصّصة            |
-| `defineRole()`                     | تهيئة صلاحيات الدور والوصول إلى الكائنات             |
-| `defineField()`                    | وسّع الكائنات الموجودة بحقول إضافية                  |
-| `defineView()`                     | تعريف العروض المحفوظة للكائنات                       |
-| `defineNavigationMenuItem()`       | تعريف روابط التنقل في الشريط الجانبي                 |
-| `defineSkill()`                    | عرّف مهارات وكيل الذكاء الاصطناعي                    |
+| دالة                         | الغرض                                                |
+| ---------------------------- | ---------------------------------------------------- |
+| `defineApplication()`        | تهيئة بيانات التعريف للتطبيق (مطلوب، واحد لكل تطبيق) |
+| `defineObject()`             | تعريف كائنات مخصصة مع حقول                           |
+| `defineLogicFunction()`      | تعريف وظائف منطقية مع معالجات                        |
+| `defineFrontComponent()`     | عرِّف مكوّنات أمامية لواجهة مستخدم مخصّصة            |
+| `defineRole()`               | تهيئة صلاحيات الدور والوصول إلى الكائنات             |
+| `defineField()`              | وسّع الكائنات الموجودة بحقول إضافية                  |
+| `defineView()`               | تعريف العروض المحفوظة للكائنات                       |
+| `defineNavigationMenuItem()` | تعريف روابط التنقل في الشريط الجانبي                 |
+| `defineSkill()`              | عرّف مهارات وكيل الذكاء الاصطناعي                    |
 
 تتحقق هذه الدوال من تكوينك وقت البناء وتوفّر إكمالًا تلقائيًا في بيئة التطوير وأمان الأنواع.
 
@@ -327,7 +319,6 @@ export default defineObject({
 * **هوية التطبيق**: المعرفات، اسم العرض، والوصف.
 * **كيفية تشغيل وظائفه**: الدور الذي تستخدمه للأذونات.
 * **متغيرات (اختياري)**: أزواج مفتاح-قيمة تُعرض لوظائفك كمتغيرات بيئة.
-* **(اختياري) دالة ما قبل التثبيت**: دالة منطقية تعمل قبل تثبيت التطبيق.
 * **(Optional) post-install function**: a logic function that runs after the app is installed.
 
 Use `defineApplication()` to define your application configuration:
@@ -336,21 +327,23 @@ Use `defineApplication()` to define your application configuration:
 // src/application-config.ts
 import { defineApplication } from 'twenty-sdk';
 import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';
 
 export default defineApplication({
   universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
-  displayName: 'تطبيق Twenty الخاص بي',
-  description: 'أول تطبيق لي لـ Twenty',
+  displayName: 'My Twenty App',
+  description: 'My first Twenty app',
   icon: 'IconWorld',
   applicationVariables: {
     DEFAULT_RECIPIENT_NAME: {
       universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
-      description: 'الاسم الافتراضي للمستلم للبطاقات البريدية',
+      description: 'Default recipient name for postcards',
       value: 'Jane Doe',
       isSecret: false,
     },
   },
   defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
 });
 ```
 
@@ -359,7 +352,7 @@ export default defineApplication({
 * حقول `universalIdentifier` هي معرّفات حتمية تخصك؛ أنشئها مرة واحدة واحتفظ بها ثابتة عبر عمليات المزامنة.
 * `applicationVariables` تصبح متغيرات بيئة لوظائفك (على سبيل المثال، `DEFAULT_RECIPIENT_NAME` متاح كـ `process.env.DEFAULT_RECIPIENT_NAME`).
 * `defaultRoleUniversalIdentifier` يجب أن يطابق ملف الدور (انظر أدناه).
-* يتم اكتشاف دوال ما قبل التثبيت وما بعد التثبيت تلقائيًا أثناء إنشاء ملف البيان. راجع [دوال ما قبل التثبيت](#pre-install-functions) و[دوال ما بعد التثبيت](#post-install-functions).
+* `postInstallLogicFunctionUniversalIdentifier` (optional) points to a logic function that runs automatically after the app is installed. See [Post-install functions](#post-install-functions).
 
 #### الأدوار والصلاحيات
 
@@ -498,44 +491,6 @@ export default defineLogicFunction({
 * المصفوفة `triggers` اختيارية. يمكن استخدام الوظائف بدون مشغلات كوظائف مساعدة تُستدعى بواسطة وظائف أخرى.
 * يمكنك مزج أنواع متعددة من المشغلات في وظيفة واحدة.
 
-### دوال ما قبل التثبيت
-
-دالة ما قبل التثبيت هي دالة منطقية تعمل تلقائيًا قبل تثبيت تطبيقك على مساحة عمل. يفيد ذلك في مهام التحقق، وفحص المتطلبات المسبقة، أو تجهيز حالة مساحة العمل قبل متابعة التثبيت الرئيسي.
-
-عند إنشاء هيكل تطبيق جديد باستخدام `create-twenty-app`، يتم إنشاء دالة ما قبل التثبيت لك في `src/logic-functions/pre-install.ts`:
-
-```typescript
-// src/logic-functions/pre-install.ts
-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: '<generated-uuid>',
-  name: 'pre-install',
-  description: 'Runs before installation to prepare the application.',
-  timeoutSeconds: 300,
-  handler,
-});
-```
-
-يمكنك أيضًا تنفيذ دالة ما قبل التثبيت يدويًا في أي وقت باستخدام CLI:
-
-```bash filename="Terminal"
-yarn twenty function:execute --preInstall
-```
-
-النقاط الرئيسية:
-
-* تستخدم دوال ما قبل التثبيت `definePreInstallLogicFunction()` — وهو إصدار متخصص يستبعد إعدادات المُشغِّل (`cronTriggerSettings` و`databaseEventTriggerSettings` و`httpRouteTriggerSettings` و`isTool`).
-* يتلقى المُعالج `InstallLogicFunctionPayload` يحوي `{ previousVersion: string }` — إصدار التطبيق الذي كان مُثبّتًا سابقًا (أو سلسلة فارغة للتثبيتات الجديدة).
-* يُسمح بدالة ما قبل التثبيت واحدة فقط لكل تطبيق. سيُنتج إنشاء ملف البيان خطأً إذا تم اكتشاف أكثر من واحدة.
-* يتم تعيين `universalIdentifier` للدالة تلقائيًا كـ `preInstallLogicFunctionUniversalIdentifier` في بيان التطبيق أثناء الإنشاء — لست بحاجة إلى الإشارة إليه في `defineApplication()`.
-* تم ضبط المهلة الافتراضية على 300 ثانية (5 دقائق) للسماح بمهام التحضير الأطول.
-* لا تحتاج دوال ما قبل التثبيت إلى مُشغِّلات — إذ يستدعيها النظام الأساسي قبل التثبيت أو يدويًا عبر `function:execute --preInstall`.
-
 ### Post-install functions
 
 A post-install function is a logic function that runs automatically after your app is installed on a workspace. This is useful for one-time setup tasks such as seeding default data, creating initial records, or configuring workspace settings.
@@ -544,14 +499,16 @@ A post-install function is a logic function that runs automatically after your a
 
 ```typescript
 // src/logic-functions/post-install.ts
-import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+import { defineLogicFunction } from 'twenty-sdk';
 
-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Post install logic function executed successfully!', payload.previousVersion);
+export const POST_INSTALL_UNIVERSAL_IDENTIFIER = '<generated-uuid>';
+
+const handler = async (): Promise<void> => {
+  console.log('Post install logic function executed successfully!');
 };
 
-export default definePostInstallLogicFunction({
-  universalIdentifier: '<generated-uuid>',
+export default defineLogicFunction({
+  universalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
   name: 'post-install',
   description: 'Runs after installation to set up the application.',
   timeoutSeconds: 300,
@@ -559,6 +516,17 @@ export default definePostInstallLogicFunction({
 });
 ```
 
+يتم ربط الدالة بتطبيقك من خلال الإشارة إلى المعرِّف العالمي الخاص بها في `application-config.ts`:
+
+```typescript
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';
+
+export default defineApplication({
+  // ...
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
+});
+```
+
 يمكنك أيضًا تنفيذ دالة ما بعد التثبيت يدويًا في أي وقت باستخدام CLI:
 
 ```bash filename="Terminal"
@@ -567,10 +535,8 @@ yarn twenty function:execute --postInstall
 
 النقاط الرئيسية:
 
-* تستخدم دوال ما بعد التثبيت `definePostInstallLogicFunction()` — وهو إصدار متخصص يستبعد إعدادات المُشغِّل (`cronTriggerSettings` و`databaseEventTriggerSettings` و`httpRouteTriggerSettings` و`isTool`).
-* يتلقى المُعالج `InstallLogicFunctionPayload` يحوي `{ previousVersion: string }` — إصدار التطبيق الذي كان مُثبّتًا سابقًا (أو سلسلة فارغة للتثبيتات الجديدة).
-* يُسمح بدالة ما بعد التثبيت واحدة فقط لكل تطبيق. سيُنتج إنشاء ملف البيان خطأً إذا تم اكتشاف أكثر من واحدة.
-* يتم تعيين `universalIdentifier` للدالة تلقائيًا كـ `postInstallLogicFunctionUniversalIdentifier` في بيان التطبيق أثناء الإنشاء — لست بحاجة إلى الإشارة إليه في `defineApplication()`.
+* دوال ما بعد التثبيت هي دوال منطقية قياسية — فهي تستخدم `defineLogicFunction()` مثل أي دالة أخرى.
+* حقل `postInstallLogicFunctionUniversalIdentifier` في `defineApplication()` اختياري. إذا تم تجاهله، لن يتم تشغيل أي دالة بعد التثبيت.
 * تم تعيين مهلة افتراضية إلى 300 ثانية (5 دقائق) للسماح بمهام الإعداد الأطول مثل تهيئة البيانات.
 * لا تحتاج دوال ما بعد التثبيت إلى مُشغِّلات — حيث يستدعيها النظام الأساسي أثناء التثبيت أو يدويًا عبر `function:execute --postInstall`.
 
@@ -768,7 +734,7 @@ export default defineFrontComponent({
 يمكنك إنشاء مكوّنات أمامية جديدة بطريقتين:
 
 * **مُنشأ بالقالب**: شغّل `yarn twenty entity:add` واختر خيار إضافة مكوّن أمامي جديد.
-* **يدوي**: أنشئ ملفًا جديدًا `.tsx` واستخدم `defineFrontComponent()` مع اتباع النمط نفسه.
+* **Manual**: Create a new `.tsx` file and use `defineFrontComponent()`, following the same pattern.
 
 ### المهارات
 
@@ -810,7 +776,7 @@ export default defineSkill({
 يتم توليد عميلين مضبوطي الأنواع تلقائيًا بواسطة `yarn twenty app:dev` وتخزينهما في `node_modules/twenty-sdk/generated` استنادًا إلى مخطط مساحة العمل لديك:
 
 * **`CoreApiClient`** — يُجري استعلامات إلى نقطة النهاية `/graphql` للحصول على بيانات مساحة العمل
-* **`MetadataApiClient`** — يستعلم عن نقطة النهاية `/metadata` لتكوين مساحة العمل وتحميل الملفات.
+* **`MetadataApiClient`** — queries the `/metadata` endpoint for workspace configuration and file uploads
 
 ```typescript
 import { CoreApiClient, MetadataApiClient } from 'twenty-sdk/generated';
@@ -822,7 +788,7 @@ const metadataClient = new MetadataApiClient();
 const { currentWorkspace } = await metadataClient.query({ currentWorkspace: { id: true } });
 ```
 
-يُعاد توليد كلا العميلين تلقائيًا بواسطة `yarn twenty app:dev` كلما تغيّرت كائناتك أو حقولك.
+Both clients are re-generated automatically by `yarn twenty app:dev` whenever your objects or fields change.
 
 #### بيانات الاعتماد وقت التشغيل في الوظائف المنطقية
 
@@ -839,7 +805,7 @@ const { currentWorkspace } = await metadataClient.query({ currentWorkspace: { id
 
 #### رفع الملفات
 
-يتضمن `MetadataApiClient` المُولَّد طريقة `uploadFile` لإرفاق الملفات بالحقول من نوع ملف ضمن كائنات مساحة العمل الخاصة بك. نظرًا لأن عملاء GraphQL القياسيون لا يدعمون تحميل الملفات متعددة الأجزاء افتراضيًا، يوفر العميل هذه الطريقة المخصصة التي تطبق [مواصفة طلب GraphQL متعدد الأجزاء](https://github.com/jaydenseric/graphql-multipart-request-spec) في الخلفية.
+The generated `MetadataApiClient` includes an `uploadFile` method for attaching files to file-type fields on your workspace objects. نظرًا لأن عملاء GraphQL القياسيون لا يدعمون تحميل الملفات متعددة الأجزاء افتراضيًا، يوفر العميل هذه الطريقة المخصصة التي تطبق [مواصفة طلب GraphQL متعدد الأجزاء](https://github.com/jaydenseric/graphql-multipart-request-spec) في الخلفية.
 
 ```typescript
 import { MetadataApiClient } from 'twenty-sdk/generated';
@@ -880,7 +846,7 @@ uploadFile(
 
 النقاط الرئيسية:
 
-* تتوفر طريقة `uploadFile` على `MetadataApiClient` لأن عملية الـ mutation الخاصة بالرفع تُعالَج عبر نقطة النهاية `/metadata`.
+* The `uploadFile` method is available on `MetadataApiClient` because the upload mutation is resolved by the `/metadata` endpoint.
 * تستخدم `universalIdentifier` الخاص بالحقل (وليس المعرّف الخاص بمساحة العمل)، ليعمل كود الرفع لديك عبر أي مساحة عمل مُثبَّت فيها تطبيقك — بما يتماشى مع كيفية إشارة التطبيقات إلى الحقول في كل مكان آخر.
 * العنوان `url` المُعاد هو عنوان URL موقّع يمكنك استخدامه للوصول إلى الملف المرفوع.
 

packages/twenty-docs/l/ar/developers/self-host/capabilities/troubleshooting.mdx

@@ -145,7 +145,7 @@ npx nx worker twenty-server
 
 ```
 plugins: [
-      react({ jsxImportSource: 'react' }),
+      react({ jsxImportSource: '@emotion/react' }),
       tsconfigPaths(),
       svgr(),
       dts(dtsConfig),

packages/twenty-docs/l/ar/twenty-ui/input/icon-picker.mdx

@@ -26,12 +26,12 @@ export const MyComponent = () => {
    };
 
   return (
-    <IconPicker
-      disabled={false}
-      onChange={handleIconChange}
-      selectedIconKey={selectedIcon}
-      variant="primary"
-    />
+      <IconPicker
+        disabled={false}
+        onChange={handleIconChange}
+        selectedIconKey={selectedIcon}
+        variant="primary"
+      />
   );
 };
 ```

packages/twenty-docs/l/ar/twenty-ui/input/select.mdx

@@ -20,16 +20,16 @@ import { Select } from '@/ui/input/components/Select';
 export const MyComponent = () => {
 
   return (
-    <Select
-      className
-      disabled={false}
-      label="Select an option"
-      options={[
-        { value: 'option1', label: 'Option A', Icon: IconTwentyStar },
-        { value: 'option2', label: 'Option B', Icon: IconTwentyStar },
-      ]}
-      value="option1"
-    />
+      <Select
+        className
+        disabled={false}
+        label="Select an option"
+        options={[
+          { value: 'option1', label: 'Option A', Icon: IconTwentyStar },
+          { value: 'option2', label: 'Option B', Icon: IconTwentyStar },
+        ]}
+        value="option1"
+      />
   );
 };