[REQUIRES_FIELDS_CACHE_FLUSH]Fix field entity to flat field transpiler (#17096 )

Following https://github.com/twentyhq/twenty/pull/16981 UniversalIdentifier is now required in the entity so no need to fallback it
Identify standard field do deploy until IS_WORKSPACE_CREATION_V2_ENABLED is enabled in prod (#16981 )
2026-01-12 14:07:15 +01:00 · 2026-01-12 11:54:00 +01:00 · 2026-01-12 11:34:38 +01:00
7315 changed files with 298027 additions and 346762 deletions
@@ -13,7 +13,6 @@ This directory contains Twenty's development guidelines and best practices in th
 - **architecture.mdc** - Project overview, technology stack, and infrastructure setup (Always Applied)
 - **nx-rules.mdc** - Nx workspace guidelines and best practices (Auto-attached to Nx files)
 - **server-migrations.mdc** - Backend migration and TypeORM guidelines for `twenty-server` (Auto-attached to server entities and migration files)
- **creating-syncable-entity.mdc** - Comprehensive guide for creating new syncable entities (with universalIdentifier and applicationId) in the workspace migration system (Agent-requested for metadata-modules and workspace-migration files)

 ### Code Quality
 - **typescript-guidelines.mdc** - TypeScript best practices and conventions (Auto-attached to .ts/.tsx files)
@@ -40,7 +39,6 @@ You can manually reference any rule using the `@ruleName` syntax:
 - `@nx-rules` - Include Nx-specific guidance
 - `@react-general-guidelines` - Load React best practices
 - `@testing-guidelines` - Get testing recommendations
- `@creating-syncable-entity` - Guide for creating new syncable entities

 ### Rule Types Used
 - **Always Applied** - Loaded in every context (architecture.mdc, README.mdc)
@@ -55,7 +53,7 @@ You can manually reference any rule using the `@ruleName` syntax:
 # Testing
 npx nx test twenty-front                    # Run unit tests
 npx nx storybook:build twenty-front         # Build Storybook
-npx nx storybook:test                       # Run Storybook tests
+npx nx storybook:serve-and-test:static     # Run Storybook tests

 # Development
 npx nx lint:diff-with-main twenty-front            # Lint files changed vs main (fastest)
@@ -2,8 +2,6 @@ version: 2
 updates:
  - package-ecosystem: "npm"
    directory: "/"
-    exclude-paths:
-      - "packages/twenty-apps/community/**"
    schedule:
      interval: "weekly"
    open-pull-requests-limit: 3
@@ -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
@@ -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:
@@ -27,7 +27,6 @@ jobs:
        packages/twenty-front/**
        packages/twenty-ui/**
        packages/twenty-shared/**
-        packages/twenty-sdk/**
  changed-files-check-e2e:
    uses: ./.github/workflows/changed-files.yaml
    with:
@@ -39,7 +38,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:
@@ -57,6 +56,8 @@ jobs:
        run: df -h
      - name: Front / Write .env
        run: npx nx reset:env twenty-front
+      - name: Front / Clean storybook-static
+        run: rm -rf packages/twenty-front/storybook-static
      - name: Front / Build storybook
        run: npx nx storybook:build twenty-front
      - name: Save storybook build cache
@@ -65,7 +66,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
@@ -82,28 +83,18 @@ jobs:
          fetch-depth: 0
      - name: Install dependencies
        uses: ./.github/actions/yarn-install
-      - name: Build dependencies
-        run: |
-          npx nx build twenty-shared
-          npx nx build twenty-ui
-          npx nx build twenty-sdk
      - name: Install Playwright
-        run: |
-          cd packages/twenty-front
-          npx playwright install
+        run: cd packages/twenty-front && npx playwright install
+      - name: Restore storybook build cache
+        uses: ./.github/actions/restore-cache
+        with:
+          key: ${{ env.STORYBOOK_BUILD_CACHE_KEY_FOR_RESTORE_ACTION }}
      - name: Front / Write .env
        run: npx nx reset:env twenty-front
      - name: Run storybook tests
-        run: npx nx storybook:test twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }}
+        run: npx nx storybook:serve-and-test:static twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }} --checkCoverage=false
      - name: Rename coverage file
-        run: |
-          if [ -f "packages/twenty-front/coverage/storybook/coverage-final.json" ]; then
-            mv packages/twenty-front/coverage/storybook/coverage-final.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
-          else
-            echo "Error: coverage-final.json not found"
-            ls -la packages/twenty-front/coverage/storybook/ || echo "Coverage directory does not exist"
-            exit 1
-          fi
+        run: mv packages/twenty-front/coverage/storybook/coverage-storybook.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
      - name: Upload coverage artifact
        uses: actions/upload-artifact@v4
        with:
@@ -140,7 +131,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 }}
@@ -206,7 +197,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:
@@ -25,7 +25,7 @@ jobs:
    runs-on: ubuntu-latest
    strategy:
      matrix:
-        task: [lint, typecheck, test:unit, storybook:build, storybook:test, test:integration]
+        task: [lint, typecheck, test]
    steps:
      - name: Cancel Previous Runs
        uses: styfle/cancel-workflow-action@0.11.0
@@ -39,9 +39,6 @@ jobs:
        uses: ./.github/actions/yarn-install
      - name: Build
        run: npx nx build twenty-sdk
-      - name: Install Playwright
-        if: contains(matrix.task, 'storybook')
-        run: npx playwright install chromium
      - name: Run ${{ matrix.task }} task
        uses: ./.github/actions/nx-affected
        with:
@@ -49,7 +46,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:
@@ -80,16 +77,20 @@ jobs:
          fetch-depth: 0
      - name: Install dependencies
        uses: ./.github/actions/yarn-install
-      - name: Build
-        run: npx nx build twenty-sdk
+      - name: Server / Append billing config to .env.test
+        working-directory: packages/twenty-server
+        run: |
+          echo "" >> .env.test
+          echo "IS_BILLING_ENABLED=true" >> .env.test
+          echo "BILLING_STRIPE_API_KEY=test-api-key" >> .env.test
+          echo "BILLING_STRIPE_BASE_PLAN_PRODUCT_ID=test-base-plan-product-id" >> .env.test
+          echo "BILLING_STRIPE_WEBHOOK_SECRET=test-webhook-secret" >> .env.test
+          echo "BILLING_PLAN_REQUIRED_LINK=http://localhost:3001/stripe-redirection" >> .env.test
      - name: Server / Create Test DB
        run: |
          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
-      - name: SDK / Run e2e Tests
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:sdk
-          tasks: test:e2e
+      - name: SDK / Run E2E Tests
+        run: npx nx test:e2e twenty-sdk
  ci-sdk-status-check:
    if: always() && !cancelled()
    timeout-minutes: 5
@@ -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
@@ -1,174 +0,0 @@
-name: Claude Code
-
-on:
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
-  issues:
-    types: [opened, assigned]
-  repository_dispatch:
-    types: [claude-core-team-issues]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.issue.number || github.event.pull_request.number || github.event.client_payload.issue_number }}
-  cancel-in-progress: false
-
-jobs:
-  claude:
-    if: |
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude') && github.event.comment.user.type != 'Bot') ||
-      (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
-    timeout-minutes: 60
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        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: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Run Claude Code
-        id: claude-code
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          additional_permissions: |
-            actions: read
-          claude_args: '--max-turns 200 --model opus --allowedTools "Edit,Write,WebFetch,Bash(bash packages/twenty-utils/setup-dev-env.sh),Bash(npx nx *),Bash(npx jest *),Bash(yarn *),Bash(git *),Bash(gh *),Bash(sed *),Bash(python3 *),Bash(rm *),Bash(find *),Bash(grep *),Bash(cat *),Bash(ls *),Bash(head *),Bash(tail *),Bash(wc *),Bash(sort *),Bash(uniq *),Bash(mkdir *),Bash(cp *),Bash(mv *),Bash(touch *),Bash(chmod *),Bash(echo *),Bash(curl *),Bash(cd *),Bash(pwd *),Bash(diff *),Bash(xargs *),Bash(awk *),Bash(cut *),Bash(tee *),Bash(tr *)"'
-          settings: |
-            {
-              "env": {
-                "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
-              }
-            }
-      - name: Post Create-PR link if Claude ran out of turns
-        if: failure()
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          BRANCH=$(git branch --show-current)
-          if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "" ]; then
-            exit 0
-          fi
-          AHEAD=$(git rev-list --count main.."$BRANCH" 2>/dev/null || echo "0")
-          if [ "$AHEAD" = "0" ]; then
-            exit 0
-          fi
-          EXISTING_PR=$(gh pr list --head "$BRANCH" --json number --jq '.[0].number' 2>/dev/null || echo "")
-          if [ -n "$EXISTING_PR" ]; then
-            exit 0
-          fi
-          ISSUE_NUMBER="${{ github.event.issue.number || github.event.pull_request.number }}"
-          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
-            gh issue comment "$ISSUE_NUMBER" --body "$(echo -e "$BODY")"
-          fi
-
-  claude-cross-repo:
-    if: github.event_name == 'repository_dispatch'
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      id-token: write
-    services:
-      postgres:
-        image: postgres:16
-        env:
-          POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: postgres
-        ports:
-          - 5432:5432
-        options: >-
-          --health-cmd pg_isready
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-      redis:
-        image: redis
-        ports:
-          - 6379:6379
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build prompt from dispatch payload
-        id: prompt
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const p = context.payload.client_payload;
-            let prompt;
-            if (p.comment_body) {
-              prompt = `You are responding to a comment on issue #${p.issue_number} ("${p.issue_title}") in the ${p.repo_full_name} repository.\n\nThe comment by @${p.sender} says:\n\n${p.comment_body}\n\nIssue body:\n\n${p.issue_body}\n\nPlease help with this request. The code you are working with is the twenty codebase (this repository).`;
-            } else {
-              prompt = `You are responding to issue #${p.issue_number} ("${p.issue_title}") in the ${p.repo_full_name} repository, opened by @${p.sender}.\n\nIssue body:\n\n${p.issue_body}\n\nPlease help with this request. The code you are working with is the twenty codebase (this repository).`;
-            }
-            core.setOutput('prompt', prompt);
-            core.setOutput('repo', p.repo_full_name);
-            core.setOutput('issue_number', p.issue_number);
-      - name: Run Claude Code
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          prompt: ${{ steps.prompt.outputs.prompt }}
-          additional_permissions: |
-            actions: read
-          claude_args: '--max-turns 200 --model opus --allowedTools "Edit,Write,WebFetch,Bash(bash packages/twenty-utils/setup-dev-env.sh),Bash(npx nx *),Bash(npx jest *),Bash(yarn *),Bash(git *),Bash(gh *),Bash(sed *),Bash(python3 *),Bash(rm *),Bash(find *),Bash(grep *),Bash(cat *),Bash(ls *),Bash(head *),Bash(tail *),Bash(wc *),Bash(sort *),Bash(uniq *),Bash(mkdir *),Bash(cp *),Bash(mv *),Bash(touch *),Bash(chmod *),Bash(echo *),Bash(curl *),Bash(cd *),Bash(pwd *),Bash(diff *),Bash(xargs *),Bash(awk *),Bash(cut *),Bash(tee *),Bash(tr *)"'
-          settings: |
-            {
-              "env": {
-                "PG_DATABASE_URL": "postgres://postgres:postgres@localhost:5432/default"
-              }
-            }
-      - name: Post response to source issue
-        if: always()
-        uses: actions/github-script@v7
-        with:
-          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})`
-            });
@@ -24,7 +24,7 @@ on:
  pull_request:
    paths:
      - 'packages/twenty-docs/**'
-      - '.github/crowdin-docs.yml'
+      - 'crowdin-docs.yml'
      - '.github/workflows/docs-i18n-pull.yaml'

 concurrency:
@@ -78,7 +78,7 @@ jobs:
          for lang in $LANGUAGES; do
            echo "=== Pulling translations for $lang ==="
            crowdin download \
-              --config .github/crowdin-docs.yml \
+              --config crowdin-docs.yml \
              --token "$CROWDIN_PERSONAL_TOKEN" \
              --base-url "https://twenty.api.crowdin.com" \
              --language "$lang" \
@@ -107,13 +107,10 @@ jobs:
      - name: Regenerate docs.json
        run: yarn docs:generate

-      - name: Regenerate documentation paths constants
-        run: yarn docs:generate-paths
-
      - name: Commit artifacts to pull request branch
        if: github.event_name == 'pull_request'
        run: |
-          git add packages/twenty-docs/docs.json packages/twenty-docs/navigation/navigation.template.json packages/twenty-shared/src/constants/DocumentationPaths.ts
+          git add packages/twenty-docs/docs.json packages/twenty-docs/navigation/navigation.template.json
          if git diff --staged --quiet --exit-code; then
            echo "No navigation/doc changes to commit."
            exit 0
@@ -12,7 +12,7 @@ on:
      - 'packages/twenty-docs/**/*.mdx'
      - '!packages/twenty-docs/l/**'
      - 'packages/twenty-docs/navigation/navigation.template.json'
-      - '.github/crowdin-docs.yml'
+      - 'crowdin-docs.yml'

 concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
@@ -43,7 +43,7 @@ jobs:
          download_translations: false
          localization_branch_name: i18n-docs
          base_url: 'https://twenty.api.crowdin.com'
-          config: '.github/crowdin-docs.yml'
+          config: 'crowdin-docs.yml'
        env:
          # Docs translations project
          CROWDIN_PROJECT_ID: '2'
@@ -89,7 +89,7 @@ jobs:
          create_pull_request: false
          skip_ref_checkout: true
          dryrun_action: false
-          config: '.github/crowdin-app.yml'
+          config: 'crowdin-app.yml'
        env:
          GITHUB_TOKEN: ${{ github.token }}
          # App translations project
@@ -87,7 +87,7 @@ jobs:
          download_translations: false
          localization_branch_name: i18n
          base_url: 'https://twenty.api.crowdin.com'
-          config: '.github/crowdin-app.yml'
+          config: 'crowdin-app.yml'
        env:
          # App translations project
          CROWDIN_PROJECT_ID: '1'
@@ -2,9 +2,11 @@
  "mcpServers": {
    "postgres": {
      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-postgres", "${PG_DATABASE_URL}"],
-      "env": {}
+      "command": "uv",
+      "args": ["run", "postgres-mcp", "--access-mode=unrestricted"],
+      "env": {
+        "DATABASE_URI": "${PG_DATABASE_URL}"
+      }
    },
    "playwright": {
      "type": "stdio",
@@ -0,0 +1,4 @@
+# Add files here to ignore them from prettier formatting
+/dist
+/coverage
+/.nx/cache
@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "endOfLine": "lf"
+}
@@ -68,14 +68,12 @@
        "./jest-integration.config.ts",
        "${relativeFile}",
        "--silent=false",
-        "${input:updateSnapshot}"
      ],
      "cwd": "${workspaceFolder}/packages/twenty-server",
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen",
      "env": {
-        "NODE_ENV": "test",
-        "NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
+        "NODE_ENV": "test"
      }
    },
    {
@@ -99,14 +97,5 @@
        "NODE_ENV": "test"
      }
    }
-  ],
-  "inputs": [
-    {
-      "id": "updateSnapshot",
-      "type": "pickString",
-      "description": "Update snapshots?",
-      "options": ["", "--updateSnapshot"],
-      "default": ""
-    }
  ]
 }
@@ -53,6 +53,5 @@
    ".cursorrules": "markdown"
  },
  "jestrunner.codeLensSelector": "**/*.{test,spec,integration-spec}.{js,jsx,ts,tsx}",
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "typescript.experimental.useTsgo": false
+  "typescript.tsdk": "node_modules/typescript/lib"
 }
@@ -2,64 +2,12 @@
 	"version": "2.0.0",
 	"tasks": [
 		{
-			"label": "twenty-server - run integration test file",
-			"type": "shell",
-			"command": "npx nx run twenty-server:jest -- --config ./jest-integration.config.ts ${relativeFile} --silent=false ${input:watchMode} ${input:updateSnapshot}",
-			"options": {
-				"cwd": "${workspaceFolder}/packages/twenty-server",
-				"env": {
-					"NODE_ENV": "test",
-					"NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-				},
-				"shell": {
-					"executable": "/bin/zsh",
-					"args": ["-l", "-c"]
-				}
-			},
-			"presentation": {
-				"reveal": "always",
-				"panel": "new",
-				"close": false
-			},
-			"problemMatcher": []
-		},
-		{
-			"label": "twenty-server - run unit test file",
-			"type": "shell",
-			"command": "npx nx run twenty-server:jest -- --config ./jest.config.mjs ${relativeFile} --silent=false ${input:watchMode} ${input:updateSnapshot}",
-			"options": {
-				"cwd": "${workspaceFolder}/packages/twenty-server",
-				"env": {
-					"NODE_ENV": "test",
-					"NODE_OPTIONS": "--max-old-space-size=12288 --import tsx/esm"
-				},
-				"shell": {
-					"executable": "/bin/zsh",
-					"args": ["-l", "-c"]
-				}
-			},
-			"presentation": {
-				"reveal": "always",
-				"panel": "new",
-				"close": false
-			},
-			"problemMatcher": []
-		}
-	],
-	"inputs": [
-		{
-			"id": "watchMode",
-			"type": "pickString",
-			"description": "Enable watch mode?",
-			"options": ["", "--watch"],
-			"default": ""
-		},
-		{
-			"id": "updateSnapshot",
-			"type": "pickString",
-			"description": "Update snapshots?",
-			"options": ["", "--updateSnapshot"],
-			"default": ""
+			"type": "npm",
+			"script": "start",
+			"path": "server",
+			"problemMatcher": [],
+			"label": "yarn: start - server",
+			"detail": "yarn start"
 		}
 	]
-}
+}
@@ -21,31 +21,30 @@ npx nx run twenty-server:worker  # Start background worker

 ### Testing
 ```bash
-# Preferred: run a single test file (fast)
-npx jest path/to/test.test.ts --config=packages/PROJECT/jest.config.mjs
-
-# Run all tests for a package
+# Run tests
 npx nx test twenty-front      # Frontend unit tests
 npx nx test twenty-server     # Backend unit tests
 npx nx run twenty-server:test:integration:with-db-reset  # Integration tests with DB reset

 # Storybook
-npx nx storybook:build twenty-front
-npx nx storybook:test twenty-front
+npx nx storybook:build twenty-front         # Build Storybook
+npx nx storybook:serve-and-test:static twenty-front     # Run Storybook tests

-# When testing the UI end to end, click on "Continue with Email" and use the prefilled credentials.
+
+When testing the UI end to end, click on "Continue with Email" and use the prefilled credentials.
 ```

 ### Code Quality
 ```bash
-# Linting (diff with main - fastest, always prefer this)
-npx nx lint:diff-with-main twenty-front
-npx nx lint:diff-with-main twenty-server
-npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix
+# Linting (diff with main - fastest)
+npx nx lint:diff-with-main twenty-front           # Lint only files changed vs main
+npx nx lint:diff-with-main twenty-server          # Lint only files changed vs main
+npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix files changed vs main

-# Linting (full project - slower, use only when needed)
-npx nx lint twenty-front
-npx nx lint twenty-server
+# Linting (full project)
+npx nx lint twenty-front      # Lint all files in frontend
+npx nx lint twenty-server     # Lint all files in backend
+npx nx lint twenty-front --fix  # Auto-fix all linting issues

 # Type checking
 npx nx typecheck twenty-front
@@ -58,8 +57,7 @@ npx nx fmt twenty-server

 ### Build
 ```bash
-# Build packages (twenty-shared must be built first)
-npx nx build twenty-shared
+# Build packages
 npx nx build twenty-front
 npx nx build twenty-server
 ```
@@ -71,7 +69,7 @@ npx nx database:reset twenty-server         # Reset database
 npx nx run twenty-server:database:init:prod # Initialize database
 npx nx run twenty-server:database:migrate:prod # Run migrations

-# Generate migration (replace [name] with kebab-case descriptive name)
+# Generate migration
 npx nx run twenty-server:typeorm migration:generate src/database/typeorm/core/migrations/common/[name] -d src/database/typeorm/core/core.datasource.ts

 # Sync metadata
@@ -80,9 +78,8 @@ npx nx run twenty-server:command workspace:sync-metadata

 ### GraphQL
 ```bash
-# Generate GraphQL types (run after schema changes)
+# Generate GraphQL types
 npx nx run twenty-front:graphql:generate
-npx nx run twenty-front:graphql:generate --configuration=metadata
 ```

 ## Architecture Overview
@@ -110,36 +107,13 @@ packages/
 - **Named exports only** (no default exports)
 - **Types over interfaces** (except when extending third-party interfaces)
 - **String literals over enums** (except for GraphQL enums)
- **No 'any' type allowed** — strict TypeScript enforced
+- **No 'any' type allowed**
 - **Event handlers preferred over useEffect** for state updates
- **Props down, events up** — unidirectional data flow
- **Composition over inheritance**
- **No abbreviations** in variable names (`user` not `u`, `fieldMetadata` not `fm`)
-
-### Naming Conventions
- **Variables/functions**: camelCase
- **Constants**: SCREAMING_SNAKE_CASE
- **Types/Classes**: PascalCase (suffix component props with `Props`, e.g. `ButtonProps`)
- **Files/directories**: kebab-case with descriptive suffixes (`.component.tsx`, `.service.ts`, `.entity.ts`, `.dto.ts`, `.module.ts`)
- **TypeScript generics**: descriptive names (`TData` not `T`)
-
-### File Structure
- Components under 300 lines, services under 500 lines
- Components in their own directories with tests and stories
- Use `index.ts` barrel exports for clean imports
- Import order: external libraries first, then internal (`@/`), then relative
-
-### Comments
- Use short-form comments (`//`), not JSDoc blocks
- Explain WHY (business logic), not WHAT
- Do not comment obvious code
- Multi-line comments use multiple `//` lines, not `/** */`

 ### State Management
- **Recoil** for global state: atoms for primitive state, selectors for derived state, atom families for dynamic collections
- Component-specific state with React hooks (`useState`, `useReducer` for complex logic)
+- **Recoil** for global state management
+- Component-specific state with React hooks
 - GraphQL cache managed by Apollo Client
- Use functional state updates: `setState(prev => prev + 1)`

 ### Backend Architecture
 - **NestJS modules** for feature organization
@@ -148,54 +122,36 @@ packages/
 - **Redis** for caching and session management
 - **BullMQ** for background job processing

-### Database & Migrations
+### Database
 - **PostgreSQL** as primary database
 - **Redis** for caching and sessions
+- **TypeORM migrations** for schema management
 - **ClickHouse** for analytics (when enabled)
- Always generate migrations when changing entity files
- Migration names must be kebab-case (e.g. `add-agent-turn-evaluation`)
- Include both `up` and `down` logic in migrations
- Never delete or rewrite committed migrations
-
-### Utility Helpers
-Use existing helpers from `twenty-shared` instead of manual type guards:
- `isDefined()`, `isNonEmptyString()`, `isNonEmptyArray()`

 ## Development Workflow

 IMPORTANT: Use Context7 for code generation, setup or configuration steps, or library/API documentation. Automatically use the Context7 MCP tools to resolve library IDs and get library docs without waiting for explicit requests.

 ### Before Making Changes
-1. Always run linting (`lint:diff-with-main`) and type checking after code changes
-2. Test changes with relevant test suites (prefer single-file test runs)
-3. Ensure database migrations are generated for entity changes
+1. Always run linting and type checking after code changes
+2. Test changes with relevant test suites
+3. Ensure database migrations are properly structured
 4. Check that GraphQL schema changes are backward compatible
-5. Run `graphql:generate` after any GraphQL schema changes

 ### Code Style Notes
 - 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)
+- Components should be in their own directories with tests and stories

 ### Testing Strategy
- **Test behavior, not implementation** — focus on user perspective
- **Test pyramid**: 70% unit, 20% integration, 10% E2E
- Query by user-visible elements (text, roles, labels) over test IDs
- Use `@testing-library/user-event` for realistic interactions
- Descriptive test names: "should [behavior] when [condition]"
- Clear mocks between tests with `jest.clearAllMocks()`
-
-## CI Environment (GitHub Actions)
-
-When running in CI, the dev environment is **not** pre-configured. Dependencies are installed but builds, env files, and databases are not set up.
-
- **Before running tests, builds, lint, type checks, or DB operations**, run: `bash packages/twenty-utils/setup-dev-env.sh`
- **Skip the setup script** for tasks that only read code — architecture questions, code review, documentation, etc.
- The script is idempotent and safe to run multiple times.
+- **Unit tests** with Jest for both frontend and backend
+- **Integration tests** for critical backend workflows
+- **Storybook** for component development and testing
+- **E2E tests** with Playwright for critical user flows

 ## Important Files
 - `nx.json` - Nx workspace configuration with task definitions
 - `tsconfig.base.json` - Base TypeScript configuration
 - `package.json` - Root package with workspace definitions
- `.cursor/rules/` - Detailed development guidelines and best practices
+- `.cursor/rules/` - Development guidelines and best practices
@@ -0,0 +1,48 @@
+DOCKER_NETWORK=twenty_network
+
+ensure-docker-network:
+	docker network inspect $(DOCKER_NETWORK) >/dev/null 2>&1 || docker network create $(DOCKER_NETWORK)
+
+postgres-on-docker: ensure-docker-network
+	docker run -d --network $(DOCKER_NETWORK) \
+	--name twenty_pg \
+	-e POSTGRES_USER=postgres \
+	-e POSTGRES_PASSWORD=postgres \
+	-e ALLOW_NOSSL=true \
+	-v twenty_db_data:/var/lib/postgresql/data \
+	-p 5432:5432 \
+	postgres:16
+	@echo "Waiting for PostgreSQL to be ready..."
+	@until docker exec twenty_pg psql -U postgres -d postgres \
+		-c 'SELECT pg_is_in_recovery();' 2>/dev/null | grep -q 'f'; do \
+		sleep 1; \
+	done
+	docker exec twenty_pg psql -U postgres -d postgres \
+		-c "CREATE DATABASE \"default\" WITH OWNER postgres;" \
+		-c "CREATE DATABASE \"test\" WITH OWNER postgres;"
+
+redis-on-docker: ensure-docker-network
+	docker run -d --network $(DOCKER_NETWORK) --name twenty_redis -p 6379:6379 redis/redis-stack-server:latest
+
+clickhouse-on-docker: ensure-docker-network
+	docker run -d --network $(DOCKER_NETWORK) --name twenty_clickhouse -p 8123:8123 -p 9000:9000 -e CLICKHOUSE_PASSWORD=devPassword clickhouse/clickhouse-server:latest \
+
+grafana-on-docker: ensure-docker-network
+	docker run -d --network $(DOCKER_NETWORK) \
+	--name twenty_grafana \
+	-p 4000:3000 \
+	-e GF_SECURITY_ADMIN_USER=admin \
+	-e GF_SECURITY_ADMIN_PASSWORD=admin \
+	-e GF_INSTALL_PLUGINS=grafana-clickhouse-datasource \
+	-v $(PWD)/packages/twenty-docker/grafana/provisioning/datasources:/etc/grafana/provisioning/datasources \
+	grafana/grafana-oss:latest
+
+opentelemetry-collector-on-docker: ensure-docker-network
+	docker run -d --network $(DOCKER_NETWORK) \
+	--name twenty_otlp_collector \
+	-p 4317:4317 \
+	-p 4318:4318 \
+	-p 13133:13133 \
+	-v $(PWD)/packages/twenty-docker/otel-collector/otel-collector-config.yaml:/etc/otel-collector-config.yaml \
+	otel/opentelemetry-collector-contrib:latest \
+	--config /etc/otel-collector-config.yaml
@@ -5,7 +5,6 @@
 #

 "preserve_hierarchy": true
-"base_path": ".."

 files: [
  {
@@ -6,7 +6,6 @@
 "project_id": 2
 "preserve_hierarchy": true
 "base_url": "https://twenty.api.crowdin.com"
-"base_path": ".."

 files: [
  {
@@ -11,10 +11,6 @@ import unicornPlugin from 'eslint-plugin-unicorn';
 import unusedImportsPlugin from 'eslint-plugin-unused-imports';
 import jsoncParser from 'jsonc-eslint-parser';

-const twentyRules = await nxPlugin.loadWorkspaceRules(
-  'packages/twenty-eslint-rules',
-);
-
 export default [
  // Base JavaScript configuration
  js.configs.recommended,
@@ -67,10 +63,6 @@ export default [
              sourceTag: 'scope:sdk',
              onlyDependOnLibsWithTags: ['scope:sdk', 'scope:shared'],
            },
-            {
-              sourceTag: 'scope:create-app',
-              onlyDependOnLibsWithTags: ['scope:create-app', 'scope:shared'],
-            },
            {
              sourceTag: 'scope:shared',
              onlyDependOnLibsWithTags: ['scope:shared'],
@@ -203,7 +195,6 @@ export default [
    plugins: {
      ...mdxPlugin.flat.plugins,
      '@nx': nxPlugin,
-      twenty: { rules: twentyRules },
    },
  },
  mdxPlugin.flatCodeBlocks,
@@ -214,9 +205,9 @@ export default [
      'unused-imports/no-unused-imports': 'off',
      'unused-imports/no-unused-vars': 'off',
      // Enforce JSX tags on separate lines to prevent Crowdin translation issues
-      'twenty/mdx-component-newlines': 'error',
+      '@nx/workspace-mdx-component-newlines': 'error',
      // Disallow angle bracket placeholders to prevent Crowdin translation errors
-      'twenty/no-angle-bracket-placeholders': 'error',
+      '@nx/workspace-no-angle-bracket-placeholders': 'error',
    },
  },
 ];
@@ -13,8 +13,6 @@ import unicornPlugin from 'eslint-plugin-unicorn';
 import unusedImportsPlugin from 'eslint-plugin-unused-imports';
 import jsoncParser from 'jsonc-eslint-parser';

-const twentyRules = await nxPlugin.loadWorkspaceRules('packages/twenty-eslint-rules');
-
 export default [
  // Base JavaScript configuration
  js.configs.recommended,
@@ -36,7 +34,6 @@ export default [
      'import': importPlugin,
      'unused-imports': unusedImportsPlugin,
      'unicorn': unicornPlugin,
-      'twenty': { rules: twentyRules },
    },
    settings: {
      react: {
@@ -570,17 +567,17 @@ export default [
      '@typescript-eslint/no-unused-vars': 'off',

      // Custom workspace rules
-      'twenty/effect-components': 'error',
-      'twenty/no-hardcoded-colors': 'error',
-      'twenty/matching-state-variable': 'error',
-      'twenty/sort-css-properties-alphabetically': 'error',
-      'twenty/styled-components-prefixed-with-styled': 'error',
-      'twenty/no-state-useref': 'error',
-      'twenty/component-props-naming': 'error',
-      'twenty/explicit-boolean-predicates-in-if': 'error',
-      'twenty/use-getLoadable-and-getValue-to-get-atoms': 'error',
-      'twenty/useRecoilCallback-has-dependency-array': 'error',
-      'twenty/no-navigate-prefer-link': 'error',
+      '@nx/workspace-effect-components': 'error',
+      '@nx/workspace-no-hardcoded-colors': 'error',
+      '@nx/workspace-matching-state-variable': 'error',
+      '@nx/workspace-sort-css-properties-alphabetically': 'error',
+      '@nx/workspace-styled-components-prefixed-with-styled': 'error',
+      '@nx/workspace-no-state-useref': 'error',
+      '@nx/workspace-component-props-naming': 'error',
+      '@nx/workspace-explicit-boolean-predicates-in-if': 'error',
+      '@nx/workspace-use-getLoadable-and-getValue-to-get-atoms': 'error',
+      '@nx/workspace-useRecoilCallback-has-dependency-array': 'error',
+      '@nx/workspace-no-navigate-prefer-link': 'error',
    },
  },

@@ -724,7 +721,7 @@ export default [
          },
        },
      ],
-      'twenty/max-consts-per-file': ['error', { max: 1 }],
+      '@nx/workspace-max-consts-per-file': ['error', { max: 1 }],
    },
  },

@@ -781,7 +778,7 @@ export default [
          },
        },
      ],
-      'twenty/max-consts-per-file': ['error', { max: 1 }],
+      '@nx/workspace-max-consts-per-file': ['error', { max: 1 }],
    },
  },

@@ -0,0 +1,5 @@
+import { getJestProjects } from '@nx/jest';
+
+export default {
+  projects: getJestProjects(),
+};
@@ -1,9 +1,3 @@
 const nxPreset = require('@nx/jest/preset').default;

-module.exports = {
-  ...nxPreset,
-  // Override the new testEnvironmentOptions added in @nx/jest 22.3.3
-  // which breaks Lingui's module resolution
-  testEnvironmentOptions: {},
-};
-
+module.exports = { ...nxPreset };
@@ -0,0 +1,5 @@
+#!/bin/bash
+command -v node >/dev/null 2>&1 || { echo >&2 "Nx requires NodeJS to be available. To install NodeJS and NPM, see: https://nodejs.org/en/download/ ."; exit 1; }
+command -v npm >/dev/null 2>&1 || { echo >&2 "Nx requires npm to be available. To install NodeJS and NPM, see: https://nodejs.org/en/download/ ."; exit 1; }
+path_to_root=$(dirname $BASH_SOURCE)
+node $path_to_root/.nx/nxw.js $@
@@ -4,7 +4,9 @@
    "libsDir": "packages"
  },
  "namedInputs": {
-    "default": ["{projectRoot}/**/*"],
+    "default": [
+      "{projectRoot}/**/*"
+    ],
    "excludeStories": [
      "default",
      "!{projectRoot}/.storybook/*",
@@ -32,17 +34,26 @@
  "targetDefaults": {
    "build": {
      "cache": true,
-      "inputs": ["^production", "production"],
-      "dependsOn": ["^build"]
+      "inputs": [
+        "^production",
+        "production"
+      ],
+      "dependsOn": [
+        "^build"
+      ]
    },
    "start": {
      "cache": false,
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
    },
    "lint": {
      "executor": "@nx/eslint:lint",
      "cache": true,
-      "outputs": ["{options.outputFile}"],
+      "outputs": [
+        "{options.outputFile}"
+      ],
      "options": {
        "eslintConfig": "{projectRoot}/eslint.config.mjs",
        "cache": true,
@@ -56,7 +67,9 @@
          "fix": true
        }
      },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
    },
    "lint:diff-with-main": {
      "executor": "nx:run-commands",
@@ -90,36 +103,46 @@
          "write": true
        }
      },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
    },
    "typecheck": {
      "executor": "nx:run-commands",
      "cache": true,
      "options": {
        "cwd": "{projectRoot}",
-        "command": "tsgo -p tsconfig.json"
+        "command": "tsc -b tsconfig.json --incremental"
      },
      "configurations": {
        "watch": {
-          "command": "tsgo -p tsconfig.json --watch"
+          "watch": true
        }
      },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
    },
    "test": {
      "executor": "@nx/jest:jest",
      "cache": true,
-      "dependsOn": ["^build"],
+      "dependsOn": [
+        "^build"
+      ],
      "inputs": [
        "^default",
        "excludeStories",
        "{workspaceRoot}/jest.preset.js"
      ],
-      "outputs": ["{projectRoot}/coverage"],
+      "outputs": [
+        "{projectRoot}/coverage"
+      ],
      "options": {
        "jestConfig": "{projectRoot}/jest.config.mjs",
        "coverage": true,
-        "coverageReporters": ["text-summary"],
+        "coverageReporters": [
+          "text-summary"
+        ],
        "cacheDirectory": "../../.cache/jest/{projectRoot}"
      },
      "configurations": {
@@ -128,7 +151,10 @@
          "maxWorkers": 3
        },
        "coverage": {
-          "coverageReporters": ["lcov", "text"]
+          "coverageReporters": [
+            "lcov",
+            "text"
+          ]
        },
        "watch": {
          "watch": true
@@ -137,25 +163,36 @@
    },
    "test:e2e": {
      "cache": true,
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
    },
    "storybook:build": {
      "executor": "nx:run-commands",
      "cache": true,
-      "inputs": ["^default", "excludeTests"],
-      "outputs": ["{projectRoot}/{options.output-dir}"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
+      "outputs": [
+        "{projectRoot}/{options.output-dir}"
+      ],
      "options": {
        "cwd": "{projectRoot}",
        "command": "NODE_OPTIONS='--max-old-space-size=10240' VITE_DISABLE_TYPESCRIPT_CHECKER=true storybook build --test",
        "output-dir": "storybook-static",
        "config-dir": ".storybook"
      },
-      "dependsOn": ["^build"]
+      "dependsOn": [
+        "^build"
+      ]
    },
    "storybook:serve:dev": {
      "executor": "nx:run-commands",
      "cache": true,
-      "dependsOn": ["^build"],
+      "dependsOn": [
+        "^build"
+      ],
      "options": {
        "cwd": "{projectRoot}",
        "command": "storybook dev",
@@ -164,7 +201,9 @@
    },
    "storybook:serve:static": {
      "executor": "nx:run-commands",
-      "dependsOn": ["storybook:build"],
+      "dependsOn": [
+        "storybook:build"
+      ],
      "options": {
        "cwd": "{projectRoot}",
        "command": "npx http-server {args.staticDir} -a={args.host} --port={args.port} --silent={args.silent}",
@@ -177,21 +216,38 @@
    "storybook:test": {
      "executor": "nx:run-commands",
      "cache": true,
-      "inputs": ["^default", "excludeTests"],
-      "outputs": ["{projectRoot}/coverage/storybook"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
+      "outputs": [
+        "{projectRoot}/coverage/storybook"
+      ],
      "options": {
        "cwd": "{projectRoot}",
-        "command": "vitest run --coverage --shard={args.shard}",
-        "shard": "1/1"
+        "commands": [
+          "test-storybook --url http://localhost:{args.port} --maxWorkers=3 --coverage --coverageDirectory={args.coverageDir} --shard={args.shard}",
+          "nx storybook:coverage {projectName} --coverageDir={args.coverageDir} --checkCoverage={args.checkCoverage}"
+        ],
+        "shard": "1/1",
+        "parallel": false,
+        "coverageDir": "coverage/storybook",
+        "port": 6006,
+        "checkCoverage": true
      }
    },
    "storybook:test:no-coverage": {
      "executor": "nx:run-commands",
-      "inputs": ["^default", "excludeTests"],
+      "inputs": [
+        "^default",
+        "excludeTests"
+      ],
      "options": {
        "cwd": "{projectRoot}",
-        "command": "vitest run --shard={args.shard}",
-        "shard": "1/1"
+        "commands": [
+          "test-storybook --url http://localhost:{args.port} --maxWorkers=2"
+        ],
+        "port": 6006
      }
    },
    "storybook:coverage": {
@@ -218,6 +274,17 @@
        }
      }
    },
+    "storybook:serve-and-test:static": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "npx concurrently --kill-others --success=first -n SB,TEST 'nx storybook:serve:static {projectName} --port={args.port}' 'npx wait-on tcp:{args.port} && nx storybook:test {projectName} --shard={args.shard} --checkCoverage={args.checkCoverage} --port={args.port} --configuration={args.scope}'"
+        ],
+        "shard": "1/1",
+        "checkCoverage": true,
+        "port": 6006
+      }
+    },
    "chromatic": {
      "executor": "nx:run-commands",
      "options": {
@@ -259,21 +326,29 @@
      "inputs": [
        "default",
        "{workspaceRoot}/eslint.config.mjs",
-        "{workspaceRoot}/packages/twenty-eslint-rules/**/*"
+        "{workspaceRoot}/tools/eslint-rules/**/*"
+      ]
+    },
+    "@nx/vite:test": {
+      "cache": true,
+      "inputs": [
+        "default",
+        "^default"
      ]
    },
    "@nx/vite:build": {
      "cache": true,
-      "dependsOn": ["^build"],
-      "inputs": ["default", "^default"]
-    },
-    "@nx/vitest:test": {
-      "cache": true,
-      "inputs": ["default", "^default"]
+      "dependsOn": [
+        "^build"
+      ],
+      "inputs": [
+        "default",
+        "^default"
+      ]
    }
  },
  "installation": {
-    "version": "22.3.3"
+    "version": "22.0.3"
  },
  "generators": {
    "@nx/react": {
@@ -301,7 +376,9 @@
  "tasksRunnerOptions": {
    "default": {
      "options": {
-        "cacheableOperations": ["storybook:build"]
+        "cacheableOperations": [
+          "storybook:build"
+        ]
      }
    }
  },
@@ -52,6 +52,7 @@
    "rxjs": "^7.2.0",
    "semver": "^7.5.4",
    "slash": "^5.1.0",
+    "storybook-addon-mock-date": "^0.6.0",
    "temporal-polyfill": "^0.3.0",
    "ts-key-enum": "^2.0.12",
    "tslib": "^2.8.1",
@@ -66,36 +67,41 @@
    "@babel/core": "^7.14.5",
    "@babel/preset-react": "^7.14.5",
    "@babel/preset-typescript": "^7.24.6",
-    "@chromatic-com/storybook": "^4.1.3",
+    "@chromatic-com/storybook": "^3",
    "@graphql-codegen/cli": "^3.3.1",
    "@graphql-codegen/client-preset": "^4.1.0",
    "@graphql-codegen/typescript": "^3.0.4",
    "@graphql-codegen/typescript-operations": "^3.0.4",
    "@graphql-codegen/typescript-react-apollo": "^3.3.7",
-    "@nx/eslint": "22.3.3",
-    "@nx/eslint-plugin": "22.3.3",
-    "@nx/jest": "22.3.3",
-    "@nx/js": "22.3.3",
-    "@nx/react": "22.3.3",
-    "@nx/storybook": "22.3.3",
-    "@nx/vite": "22.3.3",
-    "@nx/web": "22.3.3",
+    "@nx/eslint": "22.0.3",
+    "@nx/eslint-plugin": "22.0.3",
+    "@nx/jest": "22.0.3",
+    "@nx/js": "22.0.3",
+    "@nx/react": "22.0.3",
+    "@nx/storybook": "22.0.3",
+    "@nx/vite": "22.0.3",
+    "@nx/web": "22.0.3",
    "@sentry/types": "^8",
-    "@storybook-community/storybook-addon-cookie": "^5.0.0",
-    "@storybook/addon-coverage": "^3.0.0",
-    "@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.1.11",
-    "@storybook/test-runner": "^0.24.2",
+    "@storybook/addon-actions": "8.6.15",
+    "@storybook/addon-coverage": "^1.0.0",
+    "@storybook/addon-essentials": "8.6.15",
+    "@storybook/addon-interactions": "8.6.15",
+    "@storybook/addon-links": "8.6.15",
+    "@storybook/blocks": "8.6.15",
+    "@storybook/core-server": "8.6.15",
+    "@storybook/icons": "^1.2.9",
+    "@storybook/preview-api": "8.6.15",
+    "@storybook/react": "8.6.15",
+    "@storybook/react-vite": "8.6.15",
+    "@storybook/test": "8.6.15",
+    "@storybook/test-runner": "^0.23.0",
+    "@storybook/types": "8.6.15",
    "@stylistic/eslint-plugin": "^1.5.0",
    "@swc-node/register": "1.8.0",
    "@swc/cli": "^0.3.12",
    "@swc/core": "1.13.3",
    "@swc/helpers": "~0.5.2",
    "@swc/jest": "^0.2.39",
-    "@testing-library/dom": "^10.4.0",
    "@testing-library/jest-dom": "^6.6.3",
    "@testing-library/react": "^16.3.0",
    "@types/addressparser": "^1.0.3",
@@ -135,11 +141,7 @@
    "@typescript-eslint/eslint-plugin": "^8.39.0",
    "@typescript-eslint/parser": "^8.39.0",
    "@typescript-eslint/utils": "^8.39.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
    "@vitejs/plugin-react-swc": "3.11.0",
-    "@vitest/browser-playwright": "^4.0.17",
-    "@vitest/coverage-istanbul": "^4.0.17",
-    "@vitest/coverage-v8": "^4.0.17",
    "@yarnpkg/types": "^4.0.0",
    "chromatic": "^6.18.0",
    "concurrently": "^8.2.2",
@@ -159,7 +161,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.1.11",
+    "eslint-plugin-storybook": "^0.9.0",
    "eslint-plugin-unicorn": "^56.0.1",
    "eslint-plugin-unused-imports": "^3.0.0",
    "http-server": "^14.1.1",
@@ -168,24 +170,23 @@
    "jest-environment-node": "^29.4.1",
    "jest-fetch-mock": "^3.0.3",
    "jsdom": "~22.1.0",
-    "msw": "^2.12.7",
-    "msw-storybook-addon": "^2.0.6",
-    "nx": "22.3.3",
+    "msw": "^2.0.11",
+    "msw-storybook-addon": "^2.0.5",
+    "nx": "22.0.3",
    "prettier": "^3.1.1",
    "raw-loader": "^4.0.2",
    "rimraf": "^5.0.5",
    "source-map-support": "^0.5.20",
-    "storybook": "^10.1.11",
-    "storybook-addon-mock-date": "2.0.0",
-    "storybook-addon-pseudo-states": "^10.1.11",
+    "storybook": "8.6.15",
+    "storybook-addon-cookie": "^3.2.0",
+    "storybook-addon-pseudo-states": "^2.1.2",
    "supertest": "^6.1.3",
    "ts-jest": "^29.1.1",
    "ts-loader": "^9.2.3",
    "ts-node": "10.9.1",
    "tsconfig-paths": "^4.2.0",
    "tsx": "^4.17.0",
-    "vite": "^7.0.0",
-    "vitest": "^4.0.17"
+    "vite": "^7.0.0"
  },
  "engines": {
    "node": "^24.5.0",
@@ -201,16 +202,13 @@
    "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"
+    "prosemirror-transform": "1.10.4"
  },
  "version": "0.2.1",
  "nx": {},
  "scripts": {
    "docs:generate": "tsx packages/twenty-docs/scripts/generate-docs-json.ts",
    "docs:generate-navigation-template": "tsx packages/twenty-docs/scripts/generate-navigation-template.ts",
-    "docs:generate-paths": "tsx packages/twenty-docs/scripts/generate-documentation-paths.ts",
    "start": "npx concurrently --kill-others 'npx nx run-many -t start -p twenty-server twenty-front' 'npx wait-on tcp:3000 && npx nx run twenty-server:worker'"
  },
  "workspaces": {
@@ -229,12 +227,7 @@
      "packages/twenty-apps",
      "packages/twenty-cli",
      "packages/create-twenty-app",
-      "packages/twenty-eslint-rules"
+      "tools/eslint-rules"
    ]
-  },
-  "prettier": {
-    "singleQuote": true,
-    "trailingComma": "all",
-    "endOfLine": "lf"
  }
 }
@@ -15,12 +15,9 @@
 Create Twenty App is the official scaffolding CLI for building apps on top of [Twenty CRM](https://twenty.com). It sets up a ready‑to‑run project that works seamlessly with the [twenty-sdk](https://www.npmjs.com/package/twenty-sdk).

 - Zero‑config project bootstrap
- Preconfigured scripts for auth, dev mode (watch & sync), generate, uninstall, and function management
+- Preconfigured scripts for auth, generate, dev sync, one‑off sync, uninstall
 - Strong TypeScript support and typed client generation

-## Documentation
-See Twenty application documentation https://docs.twenty.com/developers/extend/capabilities/apps
-
 ## Prerequisites
 - Node.js 24+ (recommended) and Yarn 4
 - A Twenty workspace and an API key (create one at https://app.twenty.com/settings/api-webhooks)
@@ -31,49 +28,41 @@ See Twenty application documentation https://docs.twenty.com/developers/extend/c
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app

-# If you don't use yarn@4
-corepack enable
-yarn install
-
-# Get help
-yarn run help
-
 # Authenticate using your API key (you'll be prompted)
-yarn auth:login
+yarn auth

 # Add a new entity to your application (guided)
-yarn entity:add
+yarn create-entity

 # Generate a typed Twenty client and workspace entity types
-yarn app:generate
+yarn generate

-# Start dev mode: watches, builds, and syncs local changes to your workspace
-yarn app:dev
+# Start dev mode: automatically syncs local changes to your workspace
+yarn dev

-# Watch your application's function logs
-yarn function:logs
+# Or run a one‑time sync
+yarn sync

-# Execute a function with a JSON payload
-yarn function:execute -n my-function -p '{"key": "value"}'
+# Watch your application's functions logs
+yarn logs

 # Uninstall the application from the current workspace
-yarn app:uninstall
+yarn uninstall
+
+# Display commands' help
+yarn help
 ```

 ## What gets scaffolded
- A minimal app structure ready for Twenty with example files:
-  - `application-config.ts` - Application metadata configuration
-  - `roles/default-role.ts` - Default role for logic functions
-  - `logic-functions/hello-world.ts` - Example logic function with HTTP trigger
-  - `front-components/hello-world.tsx` - Example front component
+- A minimal app structure ready for Twenty
 - TypeScript configuration
 - Prewired scripts that wrap the `twenty` CLI from twenty-sdk
+- Example placeholders to help you add entities, actions, and sync logic

 ## Next steps
- Use `yarn auth:login` to authenticate with your Twenty workspace.
- Explore the generated project and add your first entity with `yarn entity:add` (logic functions, front components, objects, roles).
- Use `yarn app:dev` while you iterate — it watches, builds, and syncs changes to your workspace in real time.
- Keep your types up‑to‑date using `yarn app:generate`.
+- Explore the generated project and add your first entity with `yarn create-entity`.
+- Keep your types up‑to‑date using `yarn generate`.
+- Use `yarn dev` while you iterate to see changes instantly in your workspace.


 ## Publish your application
@@ -101,8 +90,8 @@ git push
 Our team reviews contributions for quality, security, and reusability before merging.

 ## Troubleshooting
- Auth prompts not appearing: run `yarn auth:login` again and verify the API key permissions.
- Types not generated: ensure `yarn app:generate` runs without errors, then re‑start `yarn app:dev`.
+- Auth prompts not appearing: run `yarn auth` again and verify the API key permissions.
+- Types not generated: ensure `yarn generate` runs without errors, then re‑start `yarn dev`.

 ## Contributing
 - See our [GitHub](https://github.com/twentyhq/twenty)
@@ -1,20 +1,111 @@
-import baseConfig from '../../eslint.config.mjs';
+import js from '@eslint/js';
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import typescriptParser from '@typescript-eslint/parser';
+import prettierPlugin from 'eslint-plugin-prettier';

 export default [
-  ...baseConfig,
+  js.configs.recommended,
  {
-    ignores: ['**/dist/**'],
-  },
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+      globals: {
+        // Node.js globals
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+        setTimeout: 'readonly',
+        clearTimeout: 'readonly',
+        setInterval: 'readonly',
+        clearInterval: 'readonly',
+        // Browser globals that Node.js also has
+        URL: 'readonly',
+        URLSearchParams: 'readonly',
+        // Node.js types
+        NodeJS: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+      prettier: prettierPlugin,
+    },
    rules: {
+      ...typescriptEslint.configs.recommended.rules,
      'prettier/prettier': 'error',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      'no-useless-escape': 'off',
    },
  },
  {
-    rules: {
-      'no-console': 'off',
+    files: ['**/*.js'],
+    languageOptions: {
+      ecmaVersion: 2022,
+      sourceType: 'module',
+      globals: {
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+      },
    },
-    ignores: ['src/**/*.ts', '!src/cli/**/*.ts'],
+  },
+  {
+    files: ['**/*.test.ts', '**/*.spec.ts', '**/__tests__/**/*.ts'],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+      },
+      globals: {
+        // Node.js globals
+        process: 'readonly',
+        console: 'readonly',
+        Buffer: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+        global: 'readonly',
+        // Jest globals
+        describe: 'readonly',
+        it: 'readonly',
+        test: 'readonly',
+        expect: 'readonly',
+        jest: 'readonly',
+        beforeEach: 'readonly',
+        afterEach: 'readonly',
+        beforeAll: 'readonly',
+        afterAll: 'readonly',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+      prettier: prettierPlugin,
+    },
+    rules: {
+      ...typescriptEslint.configs.recommended.rules,
+      'prettier/prettier': 'error',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-empty-function': 'off',
+      'no-useless-escape': 'off',
+    },
+  },
+  {
+    ignores: ['dist/**', 'node_modules/**'],
  },
 ];
@@ -1,18 +1,14 @@
 {
  "name": "create-twenty-app",
-  "version": "0.5.0",
+  "version": "0.2.4",
  "description": "Command-line interface to create Twenty application",
  "main": "dist/cli.cjs",
  "bin": "dist/cli.cjs",
  "files": [
-    "dist",
-    "README.md",
-    "package.json"
+    "dist/**/*"
  ],
  "scripts": {
-    "build": "npx rimraf dist && npx vite build",
-    "prepublishOnly": "tsx ../twenty-utils/pack-scripts/pre-publish-only.ts",
-    "postpublish": "tsx ../twenty-utils/pack-scripts/post-publish.ts"
+    "build": "npx rimraf dist && npx vite build"
  },
  "keywords": [
    "twenty",
@@ -38,7 +34,6 @@
    "lodash.camelcase": "^4.3.0",
    "lodash.kebabcase": "^4.1.1",
    "lodash.startcase": "^4.4.0",
-    "twenty-shared": "workspace:*",
    "uuid": "^13.0.0"
  },
  "devDependencies": {
@@ -48,7 +43,6 @@
    "@types/lodash.kebabcase": "^4.1.7",
    "@types/lodash.startcase": "^4",
    "@types/node": "^20.0.0",
-    "typescript": "^5.9.2",
    "vite": "^7.0.0",
    "vite-plugin-dts": "^4.5.4",
    "vite-tsconfig-paths": "^4.2.1"
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -5,36 +5,17 @@ This is a [Twenty](https://twenty.com) application project bootstrapped with [`c
 First, authenticate to your workspace:

 ```bash
-yarn auth:login
+yarn auth
 ```

-Then, start development mode to sync your app and watch for changes:
+Then, install this app to your workspace:

 ```bash
-yarn app:dev
+yarn sync
 ```

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

-## Available Commands
-
-```bash
-# Authentication
-yarn auth:login     # Authenticate with Twenty
-yarn auth:logout    # Remove credentials
-yarn auth:status    # Check auth status
-yarn auth:switch    # Switch default workspace
-yarn auth:list      # List all configured workspaces
-
-# Application
-yarn app:dev        # Start dev mode (watch, build, and sync)
-yarn entity:add     # Add a new entity (function, front-component, object, role)
-yarn app:generate   # Generate typed Twenty client
-yarn function:logs  # Stream function logs
-yarn function:execute  # Execute a function with JSON payload
-yarn app:uninstall  # Uninstall app from workspace
-```
-
 ## Learn More

 To learn more about Twenty applications, take a look at the following resources:
@@ -5,7 +5,6 @@
    "declaration": true,
    "outDir": "./dist",
    "rootDir": ".",
-    "jsx": "react-jsx",
    "moduleResolution": "node",
    "allowSyntheticDefaultImports": true,
    "emitDecoratorMetadata": true,
@@ -22,10 +21,6 @@
    "skipLibCheck": true,
    "skipDefaultLibCheck": true,
    "resolveJsonModule": true,
-    "paths": {
-      "src/*": ["./src/*"],
-      "~/*": ["./*"]
-    }
  },
  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
 }
@@ -1,12 +1,12 @@
-import { copyBaseApplicationProject } from '@/utils/app-template';
-import { convertToLabel } from '@/utils/convert-to-label';
-import { install } from '@/utils/install';
-import { tryGitInit } from '@/utils/try-git-init';
 import chalk from 'chalk';
 import * as fs from 'fs-extra';
 import inquirer from 'inquirer';
-import kebabCase from 'lodash.kebabcase';
 import * as path from 'path';
+import { copyBaseApplicationProject } from '@/utils/app-template';
+import kebabCase from 'lodash.kebabcase';
+import { convertToLabel } from '@/utils/convert-to-label';
+import { tryGitInit } from '@/utils/try-git-init';
+import { install } from '@/utils/install';

 const CURRENT_EXECUTION_DIRECTORY = process.env.INIT_CWD || process.cwd();

@@ -119,15 +119,10 @@ export class CreateAppCommand {
  }

  private logSuccess(appDirectory: string): void {
-    const dirName = appDirectory.split('/').reverse()[0] ?? '';
-
    console.log(chalk.green('✅ Application created!'));
    console.log('');
    console.log(chalk.blue('Next steps:'));
-    console.log(chalk.gray(`  cd ${dirName}`));
-    console.log(chalk.gray(`  corepack enable  # if you don't use yarn@4`));
-    console.log(chalk.gray(`  yarn install     # if you don't use yarn@4`));
-    console.log(chalk.gray('  yarn auth:login  # Authenticate with Twenty'));
-    console.log(chalk.gray('  yarn app:dev     # Start dev mode'));
+    console.log(`cd ${appDirectory.split('/').reverse()[0] ?? ''}`);
+    console.log('yarn auth');
  }
 }
@@ -1,302 +0,0 @@
-import * as fs from 'fs-extra';
-import { join } from 'path';
-import { tmpdir } from 'os';
-import { copyBaseApplicationProject } from '@/utils/app-template';
-
-// 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 {
-    ...actual,
-    copy: jest.fn().mockResolvedValue(undefined),
-  };
-});
-
-const APPLICATION_FILE_NAME = 'application-config.ts';
-const DEFAULT_ROLE_FILE_NAME = 'default-role.ts';
-
-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)}`,
-    );
-    await fs.ensureDir(testAppDirectory);
-    jest.clearAllMocks();
-  });
-
-  afterEach(async () => {
-    // Clean up temp directory after each test
-    if (testAppDirectory && (await fs.pathExists(testAppDirectory))) {
-      await fs.remove(testAppDirectory);
-    }
-  });
-
-  it('should create the correct folder structure with src/', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    // 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);
-  });
-
-  it('should create package.json with correct content', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    const packageJsonPath = join(testAppDirectory, 'package.json');
-    expect(await fs.pathExists(packageJsonPath)).toBe(true);
-
-    const packageJson = await fs.readJson(packageJsonPath);
-    expect(packageJson.name).toBe('my-test-app');
-    expect(packageJson.version).toBe('0.1.0');
-    expect(packageJson.dependencies['twenty-sdk']).toBe('0.5.0');
-    expect(packageJson.scripts['app:dev']).toBe('twenty app:dev');
-  });
-
-  it('should create .gitignore file', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    const gitignorePath = join(testAppDirectory, '.gitignore');
-    expect(await fs.pathExists(gitignorePath)).toBe(true);
-
-    const gitignoreContent = await fs.readFile(gitignorePath, 'utf8');
-    expect(gitignoreContent).toContain('/node_modules');
-    expect(gitignoreContent).toContain('generated');
-  });
-
-  it('should create yarn.lock file', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    const yarnLockPath = join(testAppDirectory, 'yarn.lock');
-    expect(await fs.pathExists(yarnLockPath)).toBe(true);
-
-    const yarnLockContent = await fs.readFile(yarnLockPath, 'utf8');
-    expect(yarnLockContent).toContain('yarn lockfile v1');
-  });
-
-  it('should create application-config.ts with defineApplication and correct values', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    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',
-    );
-  });
-
-  it('should create default-role.ts with defineRole and correct values', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    const roleConfigPath = join(
-      testAppDirectory,
-      'src',
-      'roles',
-      DEFAULT_ROLE_FILE_NAME,
-    );
-    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/,
-    );
-  });
-
-  it('should call fs.copy to copy base application template', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: 'A test application',
-      appDirectory: testAppDirectory,
-    });
-
-    // Verify fs.copy was called with correct destination
-    expect(fs.copy).toHaveBeenCalledTimes(1);
-    expect(fs.copy).toHaveBeenCalledWith(
-      expect.stringContaining('base-application'),
-      testAppDirectory,
-    );
-  });
-
-  it('should handle empty description', async () => {
-    await copyBaseApplicationProject({
-      appName: 'my-test-app',
-      appDisplayName: 'My Test App',
-      appDescription: '',
-      appDirectory: testAppDirectory,
-    });
-
-    const appConfigPath = join(testAppDirectory, 'src', APPLICATION_FILE_NAME);
-    const appConfigContent = await fs.readFile(appConfigPath, 'utf8');
-
-    expect(appConfigContent).toContain("description: ''");
-  });
-
-  it('should generate unique UUIDs for each application', async () => {
-    // Create first app
-    const firstAppDir = join(testAppDirectory, 'app1');
-    await fs.ensureDir(firstAppDir);
-    await copyBaseApplicationProject({
-      appName: 'app-one',
-      appDisplayName: 'App One',
-      appDescription: 'First app',
-      appDirectory: firstAppDir,
-    });
-
-    // Create second app
-    const secondAppDir = join(testAppDirectory, 'app2');
-    await fs.ensureDir(secondAppDir);
-    await copyBaseApplicationProject({
-      appName: 'app-two',
-      appDisplayName: 'App Two',
-      appDescription: 'Second app',
-      appDirectory: secondAppDir,
-    });
-
-    // Read both app configs
-    const firstAppConfig = await fs.readFile(
-      join(firstAppDir, 'src', APPLICATION_FILE_NAME),
-      'utf8',
-    );
-    const secondAppConfig = await fs.readFile(
-      join(secondAppDir, 'src', APPLICATION_FILE_NAME),
-      '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];
-    const secondUuid = secondAppConfig.match(uuidRegex)?.[1];
-
-    expect(firstUuid).toBeDefined();
-    expect(secondUuid).toBeDefined();
-    expect(firstUuid).not.toBe(secondUuid);
-  });
-
-  it('should generate unique role UUIDs for each application', async () => {
-    // Create first app
-    const firstAppDir = join(testAppDirectory, 'app1');
-    await fs.ensureDir(firstAppDir);
-    await copyBaseApplicationProject({
-      appName: 'app-one',
-      appDisplayName: 'App One',
-      appDescription: 'First app',
-      appDirectory: firstAppDir,
-    });
-
-    // Create second app
-    const secondAppDir = join(testAppDirectory, 'app2');
-    await fs.ensureDir(secondAppDir);
-    await copyBaseApplicationProject({
-      appName: 'app-two',
-      appDisplayName: 'App Two',
-      appDescription: 'Second app',
-      appDirectory: secondAppDir,
-    });
-
-    const firstRoleConfig = await fs.readFile(
-      join(firstAppDir, 'src', 'roles', DEFAULT_ROLE_FILE_NAME),
-      'utf8',
-    );
-
-    const secondRoleConfig = await fs.readFile(
-      join(secondAppDir, 'src', 'roles', DEFAULT_ROLE_FILE_NAME),
-      '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];
-    const secondUuid = secondRoleConfig.match(uuidRegex)?.[1];
-
-    expect(firstUuid).toBeDefined();
-    expect(secondUuid).toBeDefined();
-    expect(firstUuid).not.toBe(secondUuid);
-  });
-});
@@ -1,9 +1,8 @@
 import * as fs from 'fs-extra';
 import { join } from 'path';
 import { v4 } from 'uuid';
-import { ASSETS_DIR } from 'twenty-shared/application';

-const SRC_FOLDER = 'src';
+const SOURCE_FOLDER = 'src';

 export const copyBaseApplicationProject = async ({
  appName,
@@ -22,45 +21,28 @@ export const copyBaseApplicationProject = async ({

  await createGitignore(appDirectory);

-  await createPublicAssetDirectory(appDirectory);
-
  await createYarnLock(appDirectory);

-  const sourceFolderPath = join(appDirectory, SRC_FOLDER);
+  const sourceFolderPath = join(appDirectory, SOURCE_FOLDER);

  await fs.ensureDir(sourceFolderPath);

-  await createDefaultRoleConfig({
+  const defaultServerlessFunctionRoleUniversalIdentifier = v4();
+
+  await createDefaultServerlessFunctionRoleConfig({
    displayName: appDisplayName,
    appDirectory: sourceFolderPath,
-    fileFolder: 'roles',
-    fileName: 'default-role.ts',
-  });
-
-  await createDefaultFrontComponent({
-    appDirectory: sourceFolderPath,
-    fileFolder: 'front-components',
-    fileName: 'hello-world.tsx',
-  });
-
-  await createDefaultFunction({
-    appDirectory: sourceFolderPath,
-    fileFolder: 'logic-functions',
-    fileName: 'hello-world.ts',
+    defaultServerlessFunctionRoleUniversalIdentifier,
  });

  await createApplicationConfig({
    displayName: appDisplayName,
    description: appDescription,
    appDirectory: sourceFolderPath,
-    fileName: 'application-config.ts',
+    defaultServerlessFunctionRoleUniversalIdentifier,
  });
 };

-const createPublicAssetDirectory = async (appDirectory: string) => {
-  await fs.ensureDir(join(appDirectory, ASSETS_DIR));
-};
-
 const createYarnLock = async (appDirectory: string) => {
  const yarnLockContent = `# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
 # yarn lockfile v1
@@ -86,9 +68,6 @@ generated
 # dev
 /dist/

-.twenty/*
-!.twenty/output/
-
 # production
 /build

@@ -112,135 +91,55 @@ yarn-error.log*
  await fs.writeFile(join(appDirectory, '.gitignore'), gitignoreContent);
 };

-const createDefaultRoleConfig = async ({
+const createDefaultServerlessFunctionRoleConfig = async ({
  displayName,
  appDirectory,
-  fileFolder,
-  fileName,
+  defaultServerlessFunctionRoleUniversalIdentifier,
 }: {
  displayName: string;
  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
+  defaultServerlessFunctionRoleUniversalIdentifier: string;
 }) => {
-  const universalIdentifier = v4();
+  const content = `import { type RoleConfig } from 'twenty-sdk';

-  const content = `import { defineRole } from 'twenty-sdk';
-
-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
-  '${universalIdentifier}';
-
-export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+export const functionRole: RoleConfig = {
+  universalIdentifier: '${defaultServerlessFunctionRoleUniversalIdentifier}',
  label: '${displayName} default function role',
  description: '${displayName} default function role',
  canReadAllObjectRecords: true,
  canUpdateAllObjectRecords: true,
  canSoftDeleteAllObjectRecords: true,
  canDestroyAllObjectRecords: false,
-});
+};
 `;

-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
-};
-
-const createDefaultFrontComponent = async ({
-  appDirectory,
-  fileFolder,
-  fileName,
-}: {
-  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
-}) => {
-  const universalIdentifier = v4();
-
-  const content = `import { defineFrontComponent } from 'twenty-sdk';
-
-export const HelloWorld = () => {
-  return (
-    <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
-      <h1>Hello, World!</h1>
-      <p>This is your first front component.</p>
-    </div>
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: '${universalIdentifier}',
-  name: 'hello-world-front-component',
-  description: 'A sample front component',
-  component: HelloWorld,
-});
-`;
-
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
-};
-
-const createDefaultFunction = async ({
-  appDirectory,
-  fileFolder,
-  fileName,
-}: {
-  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
-}) => {
-  const universalIdentifier = v4();
-
-  const content = `import { defineLogicFunction } from 'twenty-sdk';
-
-const handler = async (): Promise<{ message: string }> => {
-  return { message: 'Hello, World!' };
-};
-
-// Logic function handler - rename and implement your logic
-export default defineLogicFunction({
-  universalIdentifier: '${universalIdentifier}',
-  name: 'hello-world-logic-function',
-  description: 'A simple logic function',
-  timeoutSeconds: 5,
-  handler,
-  httpRouteTriggerSettings: {
-    path: '/hello-world-logic-function',
-    httpMethod: 'GET',
-    isAuthRequired: false,
-  },
-});
-`;
-
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+  await fs.writeFile(join(appDirectory, 'role.config.ts'), content);
 };

 const createApplicationConfig = async ({
  displayName,
  description,
  appDirectory,
-  fileFolder,
-  fileName,
+  defaultServerlessFunctionRoleUniversalIdentifier,
 }: {
  displayName: string;
  description?: string;
  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
+  defaultServerlessFunctionRoleUniversalIdentifier: string;
 }) => {
-  const content = `import { defineApplication } from 'twenty-sdk';
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+  const content = `import { type ApplicationConfig } from 'twenty-sdk';

-export default defineApplication({
+const config: ApplicationConfig = {
  universalIdentifier: '${v4()}',
  displayName: '${displayName}',
  description: '${description ?? ''}',
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-});
+  functionRoleUniversalIdentifier: '${defaultServerlessFunctionRoleUniversalIdentifier}',
+};
+
+export default config;
 `;

-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
+  await fs.writeFile(join(appDirectory, 'application.config.ts'), content);
 };

 const createPackageJson = async ({
@@ -261,29 +160,23 @@ const createPackageJson = async ({
    },
    packageManager: 'yarn@4.9.2',
    scripts: {
-      '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',
-      'entity:add': 'twenty entity:add',
-      'app:generate': 'twenty app:generate',
-      'function:logs': 'twenty function:logs',
-      'function:execute': 'twenty function:execute',
-      'app:uninstall': 'twenty app:uninstall',
+      'create-entity': 'twenty app add',
+      dev: 'twenty app dev',
+      generate: 'twenty app generate',
+      sync: 'twenty app sync',
+      logs: 'twenty app logs',
+      uninstall: 'twenty app uninstall',
      help: 'twenty help',
+      auth: 'twenty auth login',
      lint: 'eslint',
-      'lint:fix': 'eslint --fix',
+      'lint-fix': 'eslint --fix',
    },
    dependencies: {
-      'twenty-sdk': '0.5.0',
+      'twenty-sdk': '0.2.4',
    },
    devDependencies: {
      typescript: '^5.9.3',
      '@types/node': '^24.7.2',
-      '@types/react': '^18.2.0',
-      react: '^18.2.0',
      eslint: '^9.32.0',
      'typescript-eslint': '^8.50.0',
    },
@@ -1,5 +1,4 @@
 {
-  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    "allowJs": false,
    "esModuleInterop": false,
@@ -9,18 +8,19 @@
    "noImplicitAny": true,
    "strictBindCallApply": false,
    "noEmit": true,
-    "types": ["jest", "node"],
    "paths": {
      "@/*": ["./src/*"]
-    },
-    "jsx": "react"
+    }
  },
-  "include": [
-    "src/**/*.ts",
-    "src/**/*.tsx",
-    "src/**/*.d.ts",
-    "**/__mocks__/**/*",
-    "vite.config.ts",
-    "jest.config.mjs"
-  ]
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ],
+  "extends": "../../tsconfig.base.json"
 }
@@ -0,0 +1,16 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "**/__mocks__/**/*",
+    "vite.config.ts",
+    "jest.config.mjs",
+    "src/**/*.d.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.ts",
+    "src/**/*.test.tsx"
+  ]
+}
@@ -75,7 +75,6 @@ export default defineConfig(() => {
          'path',
          'fs',
          'child_process',
-          'util',
        ],
        output: [
          {
@@ -1,2 +1 @@
 generated
-
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -230,7 +230,7 @@ npm run test -- --watch
 npx twenty-cli app dev

 # Type checking
-npx tsgo --noEmit
+npx tsc --noEmit
 ```

 ## Testing
@@ -24,7 +24,10 @@
      }
    },
    "typecheck": {
-      "dependsOn": ["^build"]
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "tsc --noEmit --project {projectRoot}/tsconfig.json"
+      }
    },
    "lint": {
      "executor": "@nx/eslint:lint",
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1,7 +1,7 @@
 import typescriptParser from '@typescript-eslint/parser';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import reactConfig from '../../../../twenty-eslint-rules/eslint.config.react.mjs';
+import reactConfig from '../../eslint.config.react.mjs';

 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -3,8 +3,9 @@
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "@emotion/react",
+    "baseUrl": "src",
    "paths": {
-      "@/*": ["./src/*"]
+      "@/*": ["*"]
    }
  }
 }
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -1 +1,3 @@
+yarnPath: .yarn/releases/yarn-4.9.2.cjs
+
 nodeLinker: node-modules
@@ -13,7 +13,7 @@ const config: ApplicationConfig = {
      isSecret: false,
    },
  },
-  defaultRoleUniversalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
+  functionRoleUniversalIdentifier: 'b648f87b-1d26-4961-b974-0908fd991061',
 };

 export default config;
@@ -95,7 +95,7 @@ export class PostCard {
    label: 'Notes',
    icon: 'IconComment',
    inverseSideTargetUniversalIdentifier:
-      STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note.universalIdentifier,
+      STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.note,
    onDelete: OnDeleteAction.CASCADE,
  })
  notes: Note[];
@@ -14,7 +14,7 @@ export const functionRole: RoleConfig = {
  canBeAssignedToApiKeys: false,
  objectPermissions: [
    {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
+      objectNameSingular: 'postCard',
      canReadObjectRecords: true,
      canUpdateObjectRecords: true,
      canSoftDeleteObjectRecords: false,
@@ -23,8 +23,8 @@ export const functionRole: RoleConfig = {
  ],
  fieldPermissions: [
    {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
-      fieldUniversalIdentifier: 'b2c37dc0-8ae7-470e-96cd-1476b47dfaff',
+      objectNameSingular: 'postCard',
+      fieldName: 'content',
      canReadFieldValue: false,
      canUpdateFieldValue: false,
    },
@@ -0,0 +1,21 @@
+import { type ApplicationConfig } from 'twenty-sdk/application';
+
+const config: ApplicationConfig = {
+  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,
+    },
+  },
+};
+
+export default config;
@@ -8,25 +8,8 @@
    "yarn": ">=4.0.2"
  },
  "packageManager": "yarn@4.9.2",
-  "scripts": {
-    "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",
-    "app:generate": "twenty app generate",
-    "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"
+    "twenty-sdk": "0.0.4"
  },
  "devDependencies": {
    "@types/node": "^24.7.2"
@@ -1,19 +0,0 @@
-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,
-    },
-  },
-});
@@ -1,18 +0,0 @@
-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',
-    },
-  ],
-});
@@ -1,132 +0,0 @@
-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,
-    },
-  ],
-});
@@ -0,0 +1,18 @@
+import { FieldMetadata, FieldMetadataType, ObjectMetadata } from 'twenty-sdk/application';
+
+@ObjectMetadata({
+  universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
+  nameSingular: 'selfHostingUser',
+  namePlural: 'selfHostingUsers',
+  labelSingular: 'Self Hosting User',
+  labelPlural: 'Self Hosting Users',
+})
+export class SelfHostingUser {
+  @FieldMetadata({
+    type: FieldMetadataType.EMAILS,
+    label: 'Email',
+    description: 'The email of the self hosting user',
+    universalIdentifier: '06f3fb53-599e-4c6b-9df6-8f731973afd7',
+  })
+  email: object;
+}
@@ -0,0 +1,114 @@
+import { type ServerlessFunctionConfig } from 'twenty-sdk/application';
+import { createClient } from '../generated';
+
+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: TelemetryEventPayload,
+): Promise<{ success: boolean; message: string; error?: string }> => {
+  try {
+    const { action, payload } = params;
+
+    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 const config: ServerlessFunctionConfig = {
+  universalIdentifier: '10104201-622b-4a5e-9f27-8f2af19b2a3c',
+  name: 'telemetry-webhook',
+  timeoutSeconds: 5,
+  triggers: [
+    {
+      universalIdentifier: '7c8e3f5a-9b4c-4d1e-8f2a-1b3c4d5e6f7a',
+      type: 'route',
+      path: '/webhook/telemetry',
+      httpMethod: 'POST',
+      isAuthRequired: false,
+    },
+  ],
+};
+
@@ -20,11 +20,7 @@
    "lib": ["es2020", "dom"],
    "skipLibCheck": true,
    "skipDefaultLibCheck": true,
-    "resolveJsonModule": true,
-    "paths": {
-      "src/*": ["./src/*"],
-      "~/*": ["./*"]
-    }
+    "resolveJsonModule": true
  },
  "exclude": [
    "node_modules",
@@ -1,21 +1,15 @@
-# Makefile for building and running Twenty CRM docker containers.
+# Makefile for building Twenty CRM docker images.
 # Set the tag and/or target build platform using make command-line variables assignments.
 #
 # Optional make variables:
 # PLATFORM - defaults to 'linux/amd64'
 # TAG      - defaults to 'latest'
 #
-# Example: make prod-build
-# Example: make PLATFORM=linux/aarch64 TAG=my-tag prod-build
-# Example: make postgres-on-docker (for local development)
+# Example: make
+# Example: make PLATFORM=linux/aarch64 TAG=my-tag

 PLATFORM ?= linux/amd64
 TAG ?= latest
-DOCKER_NETWORK=twenty_network
-
-# =============================================================================
-# Production Image Building
-# =============================================================================

 prod-build:
 	@cd ../.. && docker build -f ./packages/twenty-docker/twenty/Dockerfile --platform $(PLATFORM) --tag twenty:$(TAG) . && cd -
@@ -31,55 +25,3 @@ prod-website-build:

 prod-website-run:
 	@docker run -d -p 3000:3000 --name twenty-website twenty-website:$(TAG)
-
-# =============================================================================
-# Local Development Services
-# Run these from the repository root: make -C packages/twenty-docker <target>
-# =============================================================================
-
-ensure-docker-network:
-	docker network inspect $(DOCKER_NETWORK) >/dev/null 2>&1 || docker network create $(DOCKER_NETWORK)
-
-postgres-on-docker: ensure-docker-network
-	docker run -d --network $(DOCKER_NETWORK) \
-	--name twenty_pg \
-	-e POSTGRES_USER=postgres \
-	-e POSTGRES_PASSWORD=postgres \
-	-e ALLOW_NOSSL=true \
-	-v twenty_db_data:/var/lib/postgresql/data \
-	-p 5432:5432 \
-	postgres:16
-	@echo "Waiting for PostgreSQL to be ready..."
-	@until docker exec twenty_pg psql -U postgres -d postgres \
-		-c 'SELECT pg_is_in_recovery();' 2>/dev/null | grep -q 'f'; do \
-		sleep 1; \
-	done
-	docker exec twenty_pg psql -U postgres -d postgres \
-		-c "CREATE DATABASE \"default\" WITH OWNER postgres;" \
-		-c "CREATE DATABASE \"test\" WITH OWNER postgres;"
-
-redis-on-docker: ensure-docker-network
-	docker run -d --network $(DOCKER_NETWORK) --name twenty_redis -p 6379:6379 redis/redis-stack-server:latest
-
-clickhouse-on-docker: ensure-docker-network
-	docker run -d --network $(DOCKER_NETWORK) --name twenty_clickhouse -p 8123:8123 -p 9000:9000 -e CLICKHOUSE_PASSWORD=devPassword clickhouse/clickhouse-server:latest \
-
-grafana-on-docker: ensure-docker-network
-	docker run -d --network $(DOCKER_NETWORK) \
-	--name twenty_grafana \
-	-p 4000:3000 \
-	-e GF_SECURITY_ADMIN_USER=admin \
-	-e GF_SECURITY_ADMIN_PASSWORD=admin \
-	-e GF_INSTALL_PLUGINS=grafana-clickhouse-datasource \
-	-v $(PWD)/grafana/provisioning/datasources:/etc/grafana/provisioning/datasources \
-	grafana/grafana-oss:latest
-
-opentelemetry-collector-on-docker: ensure-docker-network
-	docker run -d --network $(DOCKER_NETWORK) \
-	--name twenty_otlp_collector \
-	-p 4317:4317 \
-	-p 4318:4318 \
-	-p 13133:13133 \
-	-v $(PWD)/otel-collector/otel-collector-config.yaml:/etc/otel-collector-config.yaml \
-	otel/opentelemetry-collector-contrib:latest \
-	--config /etc/otel-collector-config.yaml
@@ -42,50 +42,25 @@
 {{- regexFind "\\|(.+)$" . | trimPrefix "|" -}}
 {{- end -}}

-{{/* Check if using external secret for database password */}}
-{{- define "twenty.db.useExternalSecret" -}}
-{{- if and (not .Values.db.enabled) .Values.db.external.secretName .Values.db.external.passwordKey -}}
-true
-{{- else -}}
-false
-{{- end -}}
-{{- end -}}
-
-{{/* Database URL secret name */}}
-{{- define "twenty.dbUrl.secretName" -}}
-{{- printf "%s-db-url" (include "twenty.fullname" .) -}}
-{{- end -}}
-
-{{/* Database password secret name */}}
-{{- define "twenty.dbPassword.secretName" -}}
-{{- if eq (include "twenty.db.useExternalSecret" .) "true" -}}
-{{- .Values.db.external.secretName -}}
-{{- else -}}
-{{- include "twenty.dbUrl.secretName" . -}}
-{{- end -}}
-{{- end -}}
-
-{{/* Database password secret key */}}
-{{- define "twenty.dbPassword.secretKey" -}}
-{{- if eq (include "twenty.db.useExternalSecret" .) "true" -}}
-{{- .Values.db.external.passwordKey -}}
+{{/* Compose DB connection URL */}}
+{{- define "twenty.dbUrl" -}}
+{{- if .Values.server.env.PG_DATABASE_URL -}}
+{{- .Values.server.env.PG_DATABASE_URL -}}
 {{- else if .Values.db.enabled -}}
-appPassword
+{{- $host := printf "%s-db" (include "twenty.fullname" .) -}}
+{{- $user := .Values.db.internal.appUser | default "twenty_app_user" -}}
+{{- $pass := .Values.db.internal.appPassword | default (randAlphaNum 32) -}}
+{{- $db := .Values.db.internal.database | default "twenty" -}}
+{{- printf "postgres://%s:%s@%s.%s.svc.cluster.local/%s" $user $pass $host (include "twenty.namespace" .) $db -}}
 {{- else -}}
-password
-{{- end -}}
-{{- end -}}
-
-{{/* Database URL template for external secret (will be evaluated at runtime) */}}
-{{- define "twenty.dbUrl.template" -}}
-{{- if eq (include "twenty.db.useExternalSecret" .) "true" -}}
 {{- $scheme := "postgres" -}}
 {{- $host := .Values.db.external.host -}}
 {{- $port := .Values.db.external.port | default 5432 -}}
 {{- $user := .Values.db.external.user | default "postgres" -}}
+{{- $pass := .Values.db.external.password | default "postgres" -}}
 {{- $db := .Values.db.external.database | default "twenty" -}}
 {{- $qs := ternary "?sslmode=require" "" (eq .Values.db.external.ssl true) -}}
-{{- printf "%s://%s:$(DB_PASSWORD)@%s:%v/%s%s" $scheme $user $host $port $db $qs -}}
+{{- printf "%s://%s:%s@%s:%v/%s%s" $scheme $user $pass $host $port $db $qs -}}
 {{- end -}}
 {{- end -}}

@@ -103,11 +78,9 @@ password
 {{- end -}}
 {{- end -}}

-{{/* Compose Server URL from override, ingress, or service */}}
+{{/* Compose Server URL from ingress, else service */}}
 {{- define "twenty.serverUrl" -}}
-{{- if .Values.server.env.SERVER_URL -}}
-{{- .Values.server.env.SERVER_URL -}}
-{{- else if and .Values.server.ingress.enabled (gt (len .Values.server.ingress.hosts) 0) -}}
+{{- if and .Values.server.ingress.enabled (gt (len .Values.server.ingress.hosts) 0) -}}
 {{- $host := (index .Values.server.ingress.hosts 0).host -}}
 {{- $tls := gt (len .Values.server.ingress.tls) 0 -}}
 {{- $scheme := ternary "https" "http" $tls -}}
@@ -116,21 +116,11 @@ spec:
            - >-
              npx -y typeorm migration:run -d dist/database/typeorm/core/core.datasource
          env:
-            {{- if eq (include "twenty.db.useExternalSecret" .) "true" }}
-            - name: DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ include "twenty.dbPassword.secretName" . }}
-                  key: {{ include "twenty.dbPassword.secretKey" . }}
-            - name: PG_DATABASE_URL
-              value: {{ include "twenty.dbUrl.template" . | quote }}
-            {{- else }}
            - name: PG_DATABASE_URL
              valueFrom:
                secretKeyRef:
-                  name: {{ include "twenty.dbUrl.secretName" . }}
+                  name: {{ include "twenty.fullname" . }}-db-url
                  key: url
-            {{- end }}
      containers:
        - name: server
          {{- $img := include "twenty.server.image" . }}
@@ -139,21 +129,11 @@ spec:
          env:
            - name: SERVER_URL
              value: {{ include "twenty.serverUrl" . | quote }}
-            {{- if eq (include "twenty.db.useExternalSecret" .) "true" }}
-            - name: DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ include "twenty.dbPassword.secretName" . }}
-                  key: {{ include "twenty.dbPassword.secretKey" . }}
-            - name: PG_DATABASE_URL
-              value: {{ include "twenty.dbUrl.template" . | quote }}
-            {{- else }}
            - name: PG_DATABASE_URL
              valueFrom:
                secretKeyRef:
-                  name: {{ include "twenty.dbUrl.secretName" . }}
+                  name: {{ include "twenty.fullname" . }}-db-url
                  key: url
-            {{- end }}
            - name: REDIS_URL
              value: {{ include "twenty.redisUrl" . | quote }}
            - name: SIGN_IN_PREFILLED
@@ -52,21 +52,11 @@ spec:
          env:
            - name: SERVER_URL
              value: {{ include "twenty.serverUrl" . | quote }}
-            {{- if eq (include "twenty.db.useExternalSecret" .) "true" }}
-            - name: DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ include "twenty.dbPassword.secretName" . }}
-                  key: {{ include "twenty.dbPassword.secretKey" . }}
-            - name: PG_DATABASE_URL
-              value: {{ include "twenty.dbUrl.template" . | quote }}
-            {{- else }}
            - name: PG_DATABASE_URL
              valueFrom:
                secretKeyRef:
-                  name: {{ include "twenty.dbUrl.secretName" . }}
+                  name: {{ include "twenty.fullname" . }}-db-url
                  key: url
-            {{- end }}
            - name: REDIS_URL
              value: {{ include "twenty.redisUrl" . | quote }}
            - name: STORAGE_TYPE
@@ -1,5 +1,4 @@
 {{- $secretName := printf "%s-db-url" (include "twenty.fullname" .) -}}
-{{- if .Values.db.enabled -}}
 {{- $existingSecret := lookup "v1" "Secret" (include "twenty.namespace" .) $secretName -}}
 {{- $appPassword := "" -}}
 {{- if $existingSecret -}}
@@ -21,25 +20,3 @@ type: Opaque
 stringData:
  url: {{ printf "postgres://%s:%s@%s-db.%s.svc.cluster.local/%s" (urlquery $appUser) (urlquery $appPassword) (include "twenty.fullname" .) (include "twenty.namespace" .) (.Values.db.internal.database | default "twenty") | quote }}
  appPassword: {{ $appPassword | quote }}
-{{- else if not .Values.db.external.secretName -}}
-{{- $scheme := "postgres" -}}
-{{- $host := .Values.db.external.host -}}
-{{- $port := .Values.db.external.port | default 5432 -}}
-{{- $user := .Values.db.external.user | default "postgres" -}}
-{{- $pass := .Values.db.external.password | default "" -}}
-{{- $db := .Values.db.external.database | default "twenty" -}}
-{{- $qs := ternary "?sslmode=require" "" (eq .Values.db.external.ssl true) -}}
-apiVersion: v1
-kind: Secret
-metadata:
-  name: {{ $secretName }}
-  namespace: {{ include "twenty.namespace" . }}
-  labels:
-    app.kubernetes.io/name: {{ include "twenty.name" . }}
-    app.kubernetes.io/instance: {{ .Release.Name }}
-    app.kubernetes.io/component: server
-type: Opaque
-stringData:
-  url: {{ printf "%s://%s:%s@%s:%v/%s%s" $scheme (urlquery $user) (urlquery $pass) $host $port $db $qs | quote }}
-  password: {{ $pass | quote }}
-{{- end -}}
@@ -45,7 +45,6 @@
        "env": {
          "type": "object",
          "properties": {
-            "SERVER_URL": { "type": "string", "description": "Override for the server URL (e.g., https://crm.example.com). If not set, derived from ingress or service." },
            "NODE_PORT": { "type": "integer", "minimum": 1 },
            "PG_DATABASE_URL": { "type": "string" },
            "REDIS_URL": { "type": "string" },
@@ -19,13 +19,8 @@ storage:
    bucket: ""
    region: ""
    endpoint: ""
-    # Option A: direct values
    accessKeyId: ""
    secretAccessKey: ""
-    # Option B: reference a Secret
-    # secretName: my-s3-creds
-    # accessKeyIdKey: accessKeyId
-    # secretAccessKeyKey: secretAccessKey

 # Auth tokens (random if not provided)
 secrets:
@@ -142,8 +137,6 @@ db:
    password: ""
    database: twenty
    ssl: false
-    secretName: ""
-    passwordKey: ""

 # Redis
 redisInternal:
@@ -8,7 +8,7 @@ COPY ./yarn.lock .
 COPY ./.yarnrc.yml .
 COPY ./.yarn/releases /app/.yarn/releases
 COPY ./.yarn/patches /app/.yarn/patches
-COPY ./packages/twenty-eslint-rules /app/packages/twenty-eslint-rules
+COPY ./tools/eslint-rules /app/tools/eslint-rules
 COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
 COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
 COPY ./packages/twenty-website/package.json /app/packages/twenty-website/package.json
@@ -40,4 +40,4 @@ RUN chown -R 1000 /app
 # Use non root user with uid 1000
 USER 1000

-CMD ["/bin/sh", "-c", "npx nx start"]
+CMD ["/bin/sh", "-c", "npx nx start"]
@@ -8,13 +8,13 @@ COPY ./package.json ./yarn.lock ./.yarnrc.yml ./tsconfig.base.json ./nx.json /ap
 COPY ./.yarn/releases /app/.yarn/releases
 COPY ./.yarn/patches /app/.yarn/patches

+COPY ./.prettierrc /app/
 COPY ./packages/twenty-emails/package.json /app/packages/twenty-emails/
 COPY ./packages/twenty-server/package.json /app/packages/twenty-server/
 COPY ./packages/twenty-server/patches /app/packages/twenty-server/patches
 COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
 COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
 COPY ./packages/twenty-front/package.json /app/packages/twenty-front/
-COPY ./packages/twenty-sdk/package.json /app/packages/twenty-sdk/

 # Install all dependencies
 RUN yarn && yarn cache clean && npx nx reset
@@ -40,7 +40,6 @@ ARG REACT_APP_SERVER_BASE_URL
 COPY ./packages/twenty-front /app/packages/twenty-front
 COPY ./packages/twenty-ui /app/packages/twenty-ui
 COPY ./packages/twenty-shared /app/packages/twenty-shared
-COPY ./packages/twenty-sdk /app/packages/twenty-sdk
 RUN npx nx build twenty-front


@@ -17,10 +17,7 @@ setup_and_migrate_db() {
        yarn database:migrate:prod
    fi

-    yarn command:prod cache:flush
    yarn command:prod upgrade
-    yarn command:prod cache:flush
-
    echo "Successfully migrated DB!"
 }

@@ -112,7 +112,7 @@ You should run all commands in the following steps from the root of the project.

    **Option 2:** If you have docker installed:
    ```bash
-      make -C packages/twenty-docker postgres-on-docker
+      make postgres-on-docker
    ```
  </Tab>
  <Tab title="Mac OS">
@@ -159,16 +159,10 @@ You should run all commands in the following steps from the root of the project.
      CREATE ROLE postgres WITH SUPERUSER LOGIN;
    ```
    This creates a superuser role named `postgres` with login access.
-      ```bash
-      Role name | Attributes  | Member of
-      -----------+-------------+-----------
-      postgres  | Superuser   | {}
-      john      | Superuser   | {}
-    ```

    **Option 2:** If you have docker installed:
    ```bash
-      make -C packages/twenty-docker postgres-on-docker
+      make postgres-on-docker
    ```
  </Tab>
  <Tab title="Windows (WSL)">
@@ -185,7 +179,7 @@ You should run all commands in the following steps from the root of the project.
    Running Docker on WSL adds an extra layer of complexity.
    Only use this option if you are comfortable with the extra steps involved, including turning on [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl).
    ```bash
-      make -C packages/twenty-docker postgres-on-docker
+      make postgres-on-docker
    ```
  </Tab>
 </Tabs>
@@ -202,7 +196,7 @@ Twenty requires a redis cache to provide the best performance

    **Option 2:** If you have docker installed:
    ```bash
-      make -C packages/twenty-docker redis-on-docker
+      make redis-on-docker
    ```
  </Tab>
  <Tab title="Mac OS">
@@ -215,7 +209,7 @@ Twenty requires a redis cache to provide the best performance

    **Option 2:** If you have docker installed:
    ```bash
-      make -C packages/twenty-docker redis-on-docker
+      make redis-on-docker
    ```
  </Tab>
  <Tab title="Windows (WSL)">
@@ -224,7 +218,7 @@ Twenty requires a redis cache to provide the best performance

    **Option 2:** If you have docker installed:
    ```bash
-      make -C packages/twenty-docker redis-on-docker
+      make redis-on-docker
    ```
  </Tab>
 </Tabs>
@@ -9,13 +9,16 @@ Apps are currently in alpha testing. The feature is functional but still evolvin

 ## What Are Apps?

-Apps let you build and manage Twenty customizations **as code**. Instead of configuring everything through the UI, you define your data model and logic functions in code — making it faster to build, maintain, and roll out to multiple workspaces.
+Apps let you build and manage Twenty customizations **as code**. Instead of configuring everything through the UI, you define your data model and serverless functions in code — making it faster to build, maintain, and roll out to multiple workspaces.

 **What you can do today:**
 - Define custom objects and fields as code (managed data model)
- Build logic functions with custom triggers
+- Build serverless functions with custom triggers
 - Deploy the same app across multiple workspaces

+**Coming soon:**
+- Custom UI layouts and components
+
 ## Prerequisites

 - Node.js 24+ and Yarn 4
@@ -30,34 +33,30 @@ Create a new app using the official scaffolder, then authenticate and start deve
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app

-# If you don't use yarn@4
-corepack enable
-yarn install
-
 # Authenticate using your API key (you'll be prompted)
-yarn auth:login
+yarn auth

 # Start dev mode: automatically syncs local changes to your workspace
-yarn app:dev
+yarn dev
 ```

 From here you can:

 ```bash filename="Terminal"
 # Add a new entity to your application (guided)
-yarn entity:add
+yarn create-entity

 # Generate a typed Twenty client and workspace entity types
-yarn app:generate
+yarn generate

-# Watch your application's function logs
-yarn function:logs
+# Run a one‑time sync (instead of watch mode)
+yarn sync

-# Execute a function by name
-yarn function:execute -n my-function -p '{"name": "test"}'
+# Watch your application's functions logs
+yarn logs

 # Uninstall the application from the current workspace
-yarn app:uninstall
+yarn uninstall

 # Display commands' help
 yarn help
@@ -84,124 +83,80 @@ my-twenty-app/
  .nvmrc
  .yarnrc.yml
  .yarn/
+    releases/
+      yarn-4.9.2.cjs
    install-state.gz
  eslint.config.mjs
  tsconfig.json
  README.md
-  public/                           # Public assets folder (images, fonts, etc.)
  src/
-  ├── application-config.ts           # Required - main application configuration
-  ├── roles/
-  │   └── default-role.ts               # Default role for logic functions
-  ├── logic-functions/
-  │   └── hello-world.ts                # Example logic function
-  └── front-components/
-      └── hello-world.tsx               # Example front component
+    application.config.ts
+    role.config.ts
+    // your entities, actions, and other app files
 ```

 At a high level:

- **package.json**: Declares the app name, version, engines (Node 24+, Yarn 4), and adds `twenty-sdk` plus scripts like `app:dev`, `app:generate`, `entity:add`, `function:logs`, `function:execute`, `app:uninstall`, and authentication commands that delegate to the local `twenty` CLI.
+- **package.json**: Declares the app name, version, engines (Node 24+, Yarn 4), and adds `twenty-sdk` plus scripts like `dev`, `sync`, `generate`, `create-entity`, `logs`, `uninstall`, and `auth` that delegate to the local `twenty` CLI.
 - **.gitignore**: Ignores common artifacts such as `node_modules`, `.yarn`, `generated/` (typed client), `dist/`, `build/`, coverage folders, log files, and `.env*` files.
 - **yarn.lock**, **.yarnrc.yml**, **.yarn/**: Lock and configure the Yarn 4 toolchain used by the project.
 - **.nvmrc**: Pins the Node.js version expected by the project.
- **eslint.config.mjs** and **tsconfig.json**: Provide linting and TypeScript configuration for your app's TypeScript sources.
+- **eslint.config.mjs** and **tsconfig.json**: Provide linting and TypeScript configuration for your app’s TypeScript sources.
 - **README.md**: A short README in the app root with basic instructions.
- **public/**: A folder for storing public assets (images, fonts, static files) that will be served with your application. Files placed here are uploaded during sync and accessible at runtime.
- **src/**: The main place where you define your application-as-code
-
-### Entity detection
-
-The SDK detects entities by parsing your TypeScript files for **`export default define<Entity>({...})`** calls. Each entity type has a corresponding helper function exported from `twenty-sdk`:
-
-| Helper function | Entity type |
-|-----------------|-------------|
-| `defineObject()` | Custom object definitions |
-| `defineLogicFunction()` | Logic function definitions |
-| `defineFrontComponent()` | Front component definitions |
-| `defineRole()` | Role definitions |
-| `defineField()` | Field extensions for existing objects |
-
-<Note>
-**File naming is flexible.** Entity detection is AST-based — the SDK scans your source files for the `export default define<Entity>({...})` pattern. You can organize your files and folders however you like. Grouping by entity type (e.g., `logic-functions/`, `roles/`) is just a convention for code organization, not a requirement.
-</Note>
-
-Example of a detected entity:
-```typescript
-// This file can be named anything and placed anywhere in src/
-import { defineObject, FieldType } from 'twenty-sdk';
-
-export default defineObject({
-  universalIdentifier: '...',
-  nameSingular: 'postCard',
-  // ... rest of config
-});
-```
+- **src/**: The main place where you define your application-as-code:
+  - `application.config.ts`: Global configuration for your app (metadata and runtime wiring). See “Application config” below.
+  - `role.config.ts`: Default function role used by your serverless functions. See “Default function role” below.
+  - Future entities, actions/functions, and any supporting code you add.

 Later commands will add more files and folders:

- `yarn app:generate` will create a `generated/` folder (typed Twenty client + workspace types).
- `yarn entity:add` will add entity definition files under `src/` for your custom objects, functions, front components, or roles.
+- `yarn generate` will create a `generated/` folder (typed Twenty client + workspace types).
+- `yarn create-entity` will add entity definition files under `src/` for your custom objects.
+

 ## Authentication

-The first time you run `yarn auth:login`, you'll be prompted for:
+The first time you run `yarn auth`, you'll be prompted for:

 - API URL (defaults to http://localhost:3000 or your current workspace profile)
 - API key

-Your credentials are stored per-user in `~/.twenty/config.json`. You can maintain multiple profiles and switch between them.
+Your credentials are stored per-user in `~/.twenty/config.json`. You can maintain multiple profiles and switch using `--workspace <name>`.

-### Managing workspaces
+Examples:

 ```bash filename="Terminal"
 # Login interactively (recommended)
-yarn auth:login
+yarn auth

-# Login to a specific workspace profile
-yarn auth:login --workspace my-custom-workspace
-
-# List all configured workspaces
-yarn auth:list
-
-# Switch the default workspace (interactive)
-yarn auth:switch
-
-# Switch to a specific workspace
-yarn auth:switch production
-
-# Check current authentication status
-yarn auth:status
+# Use a specific workspace profile
+yarn auth --workspace my-custom-workspace
 ```

-Once you've switched workspaces with `auth:switch`, all subsequent commands will use that workspace by default. You can still override it temporarily with `--workspace <name>`.
-
 ## Use the SDK resources (types & config)

-The twenty-sdk provides typed building blocks and helper functions you use inside your app. Below are the key pieces you'll touch most often.
-
-### Helper functions
-
-The SDK provides helper functions for defining your app entities. As described in [Entity detection](#entity-detection), you must use `export default define<Entity>({...})` for your entities to be detected:
-
-| Function | Purpose |
-|----------|---------|
-| `defineApplication()` | Configure application metadata (required, one per app) |
-| `defineObject()` | Define custom objects with fields |
-| `defineLogicFunction()` | Define logic functions with handlers |
-| `defineFrontComponent()` | Define front components for custom UI |
-| `defineRole()` | Configure role permissions and object access |
-| `defineField()` | Extend existing objects with additional fields |
-
-These functions validate your configuration at build time and provide IDE autocompletion and type safety.
+The twenty-sdk provides typed building blocks you use inside your app. Below are the key pieces you'll touch most often.

 ### Defining objects

-Custom objects describe both schema and behavior for records in your workspace. Use `defineObject()` to define objects with built-in validation:
+Custom objects are regular TypeScript classes annotated with decorators from `twenty-sdk`. They live under `src/objects/` in your app and describe both schema and behavior for records in your workspace.
+
+Here is an example `postCard` object from the Hello World app:

 ```typescript
-// src/app/postCard.object.ts
-import { defineObject, FieldType } from 'twenty-sdk';
+import { type Note } from '../../generated';
+
+import {
+  type AddressField,
+  Field,
+  FieldType,
+  type FullNameField,
+  Object,
+  OnDeleteAction,
+  Relation,
+  RelationType,
+  STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';

 enum PostCardStatus {
  DRAFT = 'DRAFT',
@@ -210,135 +165,176 @@ enum PostCardStatus {
  RETURNED = 'RETURNED',
 }

-export default defineObject({
+@Object({
  universalIdentifier: '54b589ca-eeed-4950-a176-358418b85c05',
  nameSingular: 'postCard',
  namePlural: 'postCards',
-  labelSingular: 'Post Card',
-  labelPlural: 'Post Cards',
-  description: 'A post card object',
+  labelSingular: 'Post card',
+  labelPlural: 'Post cards',
+  description: ' A post card object',
  icon: 'IconMail',
-  fields: [
-    {
-      universalIdentifier: '58a0a314-d7ea-4865-9850-7fb84e72f30b',
-      name: 'content',
-      type: FieldType.TEXT,
-      label: 'Content',
-      description: "Postcard's content",
-      icon: 'IconAbc',
-    },
-    {
-      universalIdentifier: 'c6aa31f3-da76-4ac6-889f-475e226009ac',
-      name: 'recipientName',
-      type: FieldType.FULL_NAME,
-      label: 'Recipient name',
-      icon: 'IconUser',
-    },
-    {
-      universalIdentifier: '95045777-a0ad-49ec-98f9-22f9fc0c8266',
-      name: 'recipientAddress',
-      type: FieldType.ADDRESS,
-      label: 'Recipient address',
-      icon: 'IconHome',
-    },
-    {
-      universalIdentifier: '87b675b8-dd8c-4448-b4ca-20e5a2234a1e',
-      name: 'status',
-      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' },
-      ],
-    },
-    {
-      universalIdentifier: 'e06abe72-5b44-4e7f-93be-afc185a3c433',
-      name: 'deliveredAt',
-      type: FieldType.DATE_TIME,
-      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,
+    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;
+}
 ```

 Key points:

- Use `defineObject()` for built-in validation and better IDE support.
- The `universalIdentifier` must be unique and stable across deployments.
- Each field requires a `name`, `type`, `label`, and its own stable `universalIdentifier`.
- The `fields` array is optional — you can define objects without custom fields.
- You can scaffold new objects using `yarn entity:add`, which guides you through naming, fields, and relationships.
-
-<Note>
-**Base fields are created automatically.** When you define a custom object, Twenty automatically adds standard fields such as `name`, `createdAt`, `updatedAt`, `createdBy`, `position`, and `deletedAt`. You don't need to define these in your `fields` array — only add your custom fields.
-</Note>
+- The `@Object` decorator defines the object identity and labels used across the workspace; its `universalIdentifier` must be unique and stable across deployments.
+- Each `@Field` decorator defines a field on the object with a type, label, and its own stable `universalIdentifier`.
+- `@Relation` wires this object to other objects (standard or custom) and controls cascade behavior with `onDelete`.
+- You can scaffold new objects using `yarn create-entity`, which guides you through naming, fields, and relationships, then generates object files similar to the `postCard` example.


-### Application config (application-config.ts)
+### Application config (application.config.ts)

-Every app has a single `application-config.ts` file that describes:
+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.

-Use `defineApplication()` to define your application configuration:
+When you scaffold a new app, you start with a minimal config:

 ```typescript
-// src/application-config.ts
-import { defineApplication } from 'twenty-sdk';
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { type ApplicationConfig } from 'twenty-sdk';

-export default defineApplication({
-  universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
+const config: ApplicationConfig = {
+  universalIdentifier: '<generated-app-uuid>',
  displayName: 'My Twenty App',
  description: 'My first Twenty app',
-  icon: 'IconWorld',
+  functionRoleUniversalIdentifier: '<generated-role-uuid>',
+};
+
+export default config;
+```
+
+You can gradually extend this file as your app grows. For example, you can add an icon and application-scoped variables:
+
+```typescript
+import { type ApplicationConfig } from 'twenty-sdk';
+
+const config: ApplicationConfig = {
+  universalIdentifier: '<your-app-uuid>',
+  displayName: 'My App',
+  description: 'What your app does',
+  icon: 'IconWorld', // Choose an icon by name
  applicationVariables: {
    DEFAULT_RECIPIENT_NAME: {
-      universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
-      description: 'Default recipient name for postcards',
+      universalIdentifier: '<uuid>',
+      description: 'Default recipient used by functions',
      value: 'Jane Doe',
      isSecret: false,
    },
  },
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-});
+  functionRoleUniversalIdentifier: '<your-role-uuid>',
+};
+
+export default config;
 ```

 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).
+- `functionRoleUniversalIdentifier` must match the role you define in `role.config.ts` (see below).

 #### Roles and permissions

-Applications can define roles that encapsulate permissions on your workspace's objects and actions. The field `defaultRoleUniversalIdentifier` in `application-config.ts` designates the default role used by your app's logic functions.
+Applications can define roles that encapsulate permissions on your workspace’s objects and actions. The field `functionRoleUniversalIdentifier` in `application.config.ts` designates the default role used by your app’s serverless functions.

 - The runtime API key injected as `TWENTY_API_KEY` is derived from this default function role.
 - The typed client will be restricted to the permissions granted to that role.
 - Follow least‑privilege: create a dedicated role with only the permissions your functions need, then reference its universal identifier.

-##### Default function role (*.role.ts)
+##### Default function role (role.config.ts)

-When you scaffold a new app, the CLI also creates a default role file. Use `defineRole()` to define roles with built-in validation:
+When you scaffold a new app, the CLI also creates `src/role.config.ts`. This file exports the default role your serverless functions will use at runtime:

 ```typescript
-// src/roles/default-role.ts
-import { defineRole, PermissionFlag } from 'twenty-sdk';
+import { PermissionFlag, type RoleConfig } from 'twenty-sdk';

-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
-  'b648f87b-1d26-4961-b974-0908fd991061';
+export const functionRole: RoleConfig = {
+  universalIdentifier: '<generated-role-uuid>',
+  label: 'My Twenty App default function role',
+  description: 'My Twenty App default function role',
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: true,
+  canDestroyAllObjectRecords: false,
+};
+```

-export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+The `universalIdentifier` of this role is automatically wired into `application.config.ts` as `functionRoleUniversalIdentifier`. In other words:
+
+- **role.config.ts** defines what the default function role can do.
+- **application.config.ts** points to that role so your functions inherit its permissions.
+
+As you move beyond the initial scaffold, you should tighten this role and make it explicit about what it can access. A more production-ready role might look closer to:
+
+```typescript
+import { PermissionFlag, type RoleConfig } from 'twenty-sdk';
+
+export const functionRole: RoleConfig = {
+  universalIdentifier: '<your-role-uuid>',
  label: 'Default function role',
  description: 'Default role for function Twenty client',
  canReadAllObjectRecords: false,
@@ -351,7 +347,7 @@ export default defineRole({
  canBeAssignedToApiKeys: false,
  objectPermissions: [
    {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
+      objectNameSingular: 'postCard',
      canReadObjectRecords: true,
      canUpdateObjectRecords: true,
      canSoftDeleteObjectRecords: false,
@@ -360,41 +356,46 @@ export default defineRole({
  ],
  fieldPermissions: [
    {
-      objectUniversalIdentifier: '9f9882af-170c-4879-b013-f9628b77c050',
-      fieldUniversalIdentifier: 'b2c37dc0-8ae7-470e-96cd-1476b47dfaff',
+      objectNameSingular: 'postCard',
+      fieldName: 'content',
      canReadFieldValue: false,
      canUpdateFieldValue: false,
    },
  ],
-  permissionFlags: [PermissionFlag.APPLICATIONS],
-});
+  permissionFlags: ['APPLICATIONS'],
+};
 ```

-The `universalIdentifier` of this role is then referenced in `application-config.ts` as `defaultRoleUniversalIdentifier`. In other words:
-
- **\*.role.ts** defines what the default function role can do.
- **application-config.ts** points to that role so your functions inherit its permissions.
-
 Notes:
 - Start from the scaffolded role, then progressively restrict it following least‑privilege.
 - Replace the `objectPermissions` and `fieldPermissions` with the objects/fields your functions need.
 - `permissionFlags` control access to platform-level capabilities. Keep them minimal; add only what you need.
 - See a working example in the Hello World app: [`packages/twenty-apps/hello-world/src/roles/function-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/hello-world/src/roles/function-role.ts).

-### Logic function config and entrypoint
+### Serverless function config and entrypoint

-Each function file uses `defineLogicFunction()` to export a configuration with a handler and optional triggers.
+Each function exports a main handler and a config describing its triggers. You can mix multiple trigger types.

 ```typescript
-// src/app/createPostCard.logic-function.ts
-import { defineLogicFunction } from 'twenty-sdk';
-import type { DatabaseEventPayload, ObjectRecordCreateEvent, CronPayload, RoutePayload } from 'twenty-sdk';
-import Twenty, { type Person } from '~/generated';
+// src/actions/create-new-post-card.ts
+import type {
+  FunctionConfig,
+  DatabaseEventPayload,
+  ObjectRecordCreateEvent,
+  CronPayload,
+} from 'twenty-sdk';
+import Twenty, { type Person } from '../generated';

-const handler = async (params: RoutePayload) => {
+// main handler can accept parameters from route, cron, or database events
+export const main = async (
+  params:
+    | { name?: string }
+    | DatabaseEventPayload<ObjectRecordCreateEvent<Person>>
+    | CronPayload,
+) => {
  const client = new Twenty(); // generated typed client
-  const name = 'name' in params.queryStringParameters
-    ? params.queryStringParameters.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
+  const name = 'name' in params
+    ? params.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
    : 'Hello world';

  const result = await client.mutation({
@@ -407,208 +408,76 @@ const handler = async (params: RoutePayload) => {
  return result;
 };

-export default defineLogicFunction({
-  universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
+export const config: FunctionConfig = {
+  universalIdentifier: '<function-uuid>',
  name: 'create-new-post-card',
  timeoutSeconds: 2,
-  handler,
  triggers: [
    // Public HTTP route trigger '/s/post-card/create'
    {
-      universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6',
+      universalIdentifier: '<route-trigger-uuid>',
      type: 'route',
      path: '/post-card/create',
      httpMethod: 'GET',
      isAuthRequired: false,
    },
    // Cron trigger (CRON pattern)
-    // {
-    //   universalIdentifier: 'dd802808-0695-49e1-98c9-d5c9e2704ce2',
-    //   type: 'cron',
-    //   pattern: '0 0 1 1 *',
-    // },
+    {
+      universalIdentifier: '<cron-trigger-uuid>',
+      type: 'cron',
+      pattern: '0 0 1 1 *',
+    },
    // Database event trigger
-    // {
-    //   universalIdentifier: '203f1df3-4a82-4d06-a001-b8cf22a31156',
-    //   type: 'databaseEvent',
-    //   eventName: 'person.updated',
-    //   updatedFields: ['name'],
-    // },
+    {
+      universalIdentifier: '<db-trigger-uuid>',
+      type: 'databaseEvent',
+      eventName: 'person.created',
+    },
  ],
-});
+};
 ```

 Common trigger types:
- **route**: Exposes your function on an HTTP path and method **under the `/s/` endpoint**:
+- route: Exposes your function on an HTTP path and method **under the `/s/` endpoint**:
 > e.g. `path: '/post-card/create',` -> call on `<APP_URL>/s/post-card/create`
- **cron**: Runs your function on a schedule using a CRON expression.
- **databaseEvent**: Runs on workspace object lifecycle events. When the event operation is `updated`, specific fields to listen to can be specified in the `updatedFields` array. If left undefined or empty, any update will trigger the function.
-> e.g. `person.updated`
-
-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.
-
-### Route trigger payload
-
-<Warning>
-**Breaking change (v1.16, January 2026):** The route trigger payload format has changed. Prior to v1.16, query parameters, path parameters, and body were sent directly as the payload. Starting with v1.16, they are nested inside a structured `RoutePayload` object.
-
-**Before v1.16:**
-```typescript
-const handler = async (params) => {
-  const { param1, param2 } = params; // Direct access
-};
-```
-
-**After v1.16:**
-```typescript
-const handler = async (event: RoutePayload) => {
-  const { param1, param2 } = event.body; // Access via .body
-  const { queryParam } = event.queryStringParameters;
-  const { id } = event.pathParameters;
-};
-```
-
-**To migrate existing functions:** Update your handler to destructure from `event.body`, `event.queryStringParameters`, or `event.pathParameters` instead of directly from the params object.
-</Warning>
-
-When a route trigger invokes your logic function, it receives a `RoutePayload` object that follows the AWS HTTP API v2 format. Import the type from `twenty-sdk`:
-
-```typescript
-import { defineLogicFunction, type RoutePayload } from 'twenty-sdk';
-
-const handler = async (event: RoutePayload) => {
-  // Access request data
-  const { headers, queryStringParameters, pathParameters, body } = event;
-
-  // HTTP method and path are available in requestContext
-  const { method, path } = event.requestContext.http;
-
-  return { message: 'Success' };
-};
-```
-
-The `RoutePayload` type has the following structure:
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `headers` | `Record<string, string \| undefined>` | HTTP headers (only those listed in `forwardedRequestHeaders`) |
-| `queryStringParameters` | `Record<string, string \| undefined>` | Query string parameters (multiple values joined with commas) |
-| `pathParameters` | `Record<string, string \| undefined>` | Path parameters extracted from the route pattern (e.g., `/users/:id` → `{ id: '123' }`) |
-| `body` | `object \| null` | Parsed request body (JSON) |
-| `isBase64Encoded` | `boolean` | Whether the body is base64 encoded |
-| `requestContext.http.method` | `string` | HTTP method (GET, POST, PUT, PATCH, DELETE) |
-| `requestContext.http.path` | `string` | Raw request path |
-
-### Forwarding HTTP headers
-
-By default, HTTP headers from incoming requests are **not** passed to your logic function for security reasons. To access specific headers, explicitly list them in the `forwardedRequestHeaders` array:
-
-```typescript
-export default defineLogicFunction({
-  universalIdentifier: 'e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf',
-  name: 'webhook-handler',
-  handler,
-  triggers: [
-    {
-      universalIdentifier: 'c9f84c8d-b26d-40d1-95dd-4f834ae5a2c6',
-      type: 'route',
-      path: '/webhook',
-      httpMethod: 'POST',
-      isAuthRequired: false,
-      forwardedRequestHeaders: ['x-webhook-signature', 'content-type'],
-    },
-  ],
-});
-```
-
-In your handler, you can then access these headers:
-
-```typescript
-const handler = async (event: RoutePayload) => {
-  const signature = event.headers['x-webhook-signature'];
-  const contentType = event.headers['content-type'];
-
-  // Validate webhook signature...
-  return { received: true };
-};
-```
-
-<Note>
-  Header names are normalized to lowercase. Access them using lowercase keys (for example, `event.headers['content-type']`).
-</Note>
+- cron: Runs your function on a schedule using a CRON expression.
+- databaseEvent: Runs on workspace object lifecycle events
+> e.g. `person.created`

 You can create new functions in two ways:

- **Scaffolded**: Run `yarn entity:add` and choose the option to add a new logic function. This generates a starter file with a handler and config.
- **Manual**: Create a new `*.logic-function.ts` file and use `defineLogicFunction()`, following the same pattern.
-
-### Front components
-
-Front components let you build custom React components that render within Twenty's UI. Use `defineFrontComponent()` to define components with built-in validation:
-
-```typescript
-// src/my-widget.front-component.tsx
-import { defineFrontComponent } from 'twenty-sdk';
-
-const MyWidget = () => {
-  return (
-    <div style={{ padding: '20px', fontFamily: 'sans-serif' }}>
-      <h1>My Custom Widget</h1>
-      <p>This is a custom front component for Twenty.</p>
-    </div>
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-  name: 'my-widget',
-  description: 'A custom widget component',
-  component: MyWidget,
-});
-```
-
-Key points:
- Front components are React components that render in isolated contexts within Twenty.
- Use the `*.front-component.tsx` file suffix for automatic detection.
- The `component` field references your React component.
- Components are built and synced automatically during `yarn app:dev`.
-
-You can create new front components in two ways:
-
- **Scaffolded**: Run `yarn entity:add` and choose the option to add a new front component.
- **Manual**: Create a new `*.front-component.tsx` file and use `defineFrontComponent()`.
+- **Scaffolded**: Run `yarn create-entity --path <custom-path>` and choose the option to add a new function. This generates a starter file under `<custom-path>` with a `main` handler and a `config` block similar to the example above.
+- **Manual**: Create a new file and export `main` and `config` yourself, following the same pattern.

 ### Generated typed client

-Run yarn app:generate to create a local typed client in generated/ based on your workspace schema. Use it in your functions:
+Run yarn generate to create a local typed client in generated/ based on your workspace schema. Use it in your functions:

 ```typescript
-import Twenty from '~/generated';
+import Twenty from './generated';

 const client = new Twenty();
 const { me } = await client.query({ me: { id: true, displayName: true } });
 ```

-The client is re-generated by `yarn app:generate`. Re-run after changing your objects or when onboarding to a new workspace.
+The client is re-generated by `yarn generate`. Re-run after changing your objects and `yarn sync` or when onboarding to a new workspace.

-#### Runtime credentials in logic functions
+#### Runtime credentials in serverless functions

 When your function runs on Twenty, the platform injects credentials as environment variables before your code executes:

 - `TWENTY_API_URL`: Base URL of the Twenty API your app targets.
- `TWENTY_API_KEY`: Short‑lived key scoped to your application's default function role.
+- `TWENTY_API_KEY`: Short‑lived key scoped to your application’s default function role.

 Notes:
 - You do not need to pass URL or API key to the generated client. It reads `TWENTY_API_URL` and `TWENTY_API_KEY` from process.env at runtime.
- The API key's permissions are determined by the role referenced in your `application-config.ts` via `defaultRoleUniversalIdentifier`. This is the default role used by logic functions of your application.
- Applications can define roles to follow least‑privilege. Grant only the permissions your functions need, then point `defaultRoleUniversalIdentifier` to that role's universal identifier.
+- The API key’s permissions are determined by the role referenced in your `application.config.ts` via `functionRoleUniversalIdentifier`. This is the default role used by serverless functions of your application.
+- Applications can define roles to follow least‑privilege. Grant only the permissions your functions need, then point `functionRoleUniversalIdentifier` to that role’s universal identifier.


 ### Hello World example

-Explore a minimal, end-to-end example that demonstrates objects, logic functions, front components, and multiple triggers [here](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/hello-world):
+Explore a minimal, end-to-end example that demonstrates objects, functions, and multiple triggers [here](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/hello-world):

 ## Manual setup (without the scaffolder)

@@ -623,29 +492,25 @@ Then add scripts like these:
 ```json filename="package.json"
 {
  "scripts": {
-    "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:generate": "twenty app:generate",
-    "app:uninstall": "twenty app:uninstall",
-    "entity:add": "twenty entity:add",
-    "function:logs": "twenty function:logs",
-    "function:execute": "twenty function:execute",
-    "help": "twenty help"
+    "auth": "twenty auth login",
+    "generate": "twenty app generate",
+    "dev": "twenty app dev",
+    "sync": "twenty app sync",
+    "uninstall": "twenty app uninstall",
+    "logs": "twenty app logs",
+    "create-entity": "twenty app add",
+    "help": "twenty --help"
  }
 }
 ```

-Now you can run the same commands via Yarn, e.g. `yarn app:dev`, `yarn app:generate`, etc.
+Now you can run the same commands via Yarn, e.g. `yarn dev`, `yarn sync`, etc.

 ## Troubleshooting

- Authentication errors: run `yarn auth:login` and ensure your API key has the required permissions.
+- Authentication errors: run `yarn auth` and ensure your API key has the required permissions.
 - Cannot connect to server: verify the API URL and that the Twenty server is reachable.
- Types or client missing/outdated: run `yarn app:generate`.
- Dev mode not syncing: ensure `yarn app:dev` is running and that changes are not ignored by your environment.
+- Types or client missing/outdated: run `yarn generate` and then `yarn dev`.
+- Dev mode not syncing: ensure `yarn dev` is running and that changes are not ignored by your environment.

 Discord Help Channel: https://discord.com/channels/1130383047699738754/1130386664812982322
@@ -288,44 +288,3 @@ yarn command:prod cron:workflow:automated-cron-trigger
 <Warning>
 **Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
 </Warning>
-
-## Logic Functions
-
-Twenty supports logic functions for workflows and custom logic. The execution environment is configured via the `SERVERLESS_TYPE` environment variable.
-
-<Warning>
-**Security Notice:** The local driver (`SERVERLESS_TYPE=LOCAL`) runs code directly on the host in a Node.js process with no sandboxing. It should only be used for trusted code in development. For production deployments handling untrusted code, we highly recommend using `SERVERLESS_TYPE=LAMBDA` or `SERVERLESS_TYPE=DISABLED`.
-</Warning>
-
-### Available Drivers
-
-| Driver | Environment Variable | Use Case | Security Level |
-|--------|---------------------|----------|----------------|
-| Disabled | `SERVERLESS_TYPE=DISABLED` | Disable logic functions entirely | N/A |
-| Local | `SERVERLESS_TYPE=LOCAL` | Development and trusted environments | Low (no sandboxing) |
-| Lambda | `SERVERLESS_TYPE=LAMBDA` | Production with untrusted code | High (hardware-level isolation) |
-
-### Recommended Configuration
-
-**For development:**
-```bash
-SERVERLESS_TYPE=LOCAL  # default
-```
-
-**For production (AWS):**
-```bash
-SERVERLESS_TYPE=LAMBDA
-SERVERLESS_LAMBDA_REGION=us-east-1
-SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
-SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
-SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
-```
-
-**To disable logic functions:**
-```bash
-SERVERLESS_TYPE=DISABLED
-```
-
-<Note>
-When using `SERVERLESS_TYPE=DISABLED`, any attempt to execute a logic function will return an error. This is useful if you want to run Twenty without logic function capabilities.
-</Note>
--- a/Show More
+++ b/Show More