feat(server): new decorator and template and service

Fixes and updates to the website. (#19350 )
This PR implements a whole lot of fixes and updates to the website. It adds a release-notes page, terms and conditions page, privacy policy page, while fixing HomeStepper, ProductStepper, and WhyTwentyStepper. 3D models still need to be styled and their sizes need to be fixed.
2026-04-06 10:16:04 +02:00 · 2026-04-06 09:42:30 +02:00 · 2026-04-06 07:11:47 +00:00 · 2026-04-06 06:42:25 +00:00 · 2026-04-05 19:46:10 +00:00 · 2026-04-05 18:56:37 +00:00
2525 changed files with 129624 additions and 87906 deletions
@@ -35,12 +35,10 @@ jobs:
    runs-on: ubuntu-latest
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -77,6 +75,8 @@ jobs:
        run: |
          echo "Attempting to merge main into current branch..."

+          git config user.email "ci@twenty.com"
+          git config user.name "CI"
          git fetch origin main

          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
@@ -90,8 +90,8 @@ jobs:
            echo "❌ Merge failed due to conflicts"
            echo "⚠️ Falling back to comparing current branch against main without merge"

-            # Abort the failed merge
-            git merge --abort
+            # Abort the failed merge (may not exist if merge never started)
+            git merge --abort 2>/dev/null || true

            echo "merged=false" >> $GITHUB_OUTPUT
            echo "BRANCH_STATE=conflicts" >> $GITHUB_ENV
@@ -143,7 +143,6 @@ jobs:
          set_env_var "CLICKHOUSE_PASSWORD" "clickhousePassword"

          npx nx run twenty-server:database:init:prod
-          npx nx run twenty-server:database:migrate:prod

      - name: Seed current branch database with test data
        run: |
@@ -296,7 +295,6 @@ jobs:
          set_env_var "CLICKHOUSE_PASSWORD" "clickhousePassword"

          npx nx run twenty-server:database:init:prod
-          npx nx run twenty-server:database:migrate:prod

      - name: Seed main branch database with test data
        run: |
@@ -395,12 +393,30 @@ jobs:
          # Clean up temp directory
          rm -rf /tmp/current-branch-files

+      - name: Validate downloaded schema files
+        id: validate-schemas
+        run: |
+          valid=true
+
+          for file in main-schema-introspection.json current-schema-introspection.json \
+                      main-metadata-schema-introspection.json current-metadata-schema-introspection.json \
+                      main-rest-api.json current-rest-api.json \
+                      main-rest-metadata-api.json current-rest-metadata-api.json; do
+            if [ ! -f "$file" ] || ! jq empty "$file" 2>/dev/null; then
+              echo "::warning::Invalid or missing schema file: $file"
+              valid=false
+            fi
+          done
+
+          echo "valid=$valid" >> $GITHUB_OUTPUT
+
      - name: Install OpenAPI Diff Tool
        run: |
          # Using the Java-based OpenAPITools/openapi-diff via Docker
          echo "Using OpenAPITools/openapi-diff via Docker"

      - name: Generate GraphQL Schema Diff Reports
+        if: steps.validate-schemas.outputs.valid == 'true'
        run: |
          echo "=== INSTALLING GRAPHQL INSPECTOR CLI ==="
          npm install -g @graphql-inspector/cli
@@ -411,7 +427,6 @@ jobs:
          echo "Checking GraphQL schema for changes..."
          if graphql-inspector diff main-schema-introspection.json current-schema-introspection.json >/dev/null 2>&1; then
            echo "✅ No changes in GraphQL schema"
-            # Don't create a diff file for no changes
          else
            echo "⚠️ Changes detected in GraphQL schema, generating report..."
            echo "# GraphQL Schema Changes" > graphql-schema-diff.md
@@ -429,7 +444,6 @@ jobs:
          echo "Checking GraphQL metadata schema for changes..."
          if graphql-inspector diff main-metadata-schema-introspection.json current-metadata-schema-introspection.json >/dev/null 2>&1; then
            echo "✅ No changes in GraphQL metadata schema"
-            # Don't create a diff file for no changes
          else
            echo "⚠️ Changes detected in GraphQL metadata schema, generating report..."
            echo "# GraphQL Metadata Schema Changes" > graphql-metadata-diff.md
@@ -448,6 +462,7 @@ jobs:
          ls -la *-diff.md 2>/dev/null || echo "No diff files generated (no changes detected)"

      - name: Check REST API Breaking Changes
+        if: steps.validate-schemas.outputs.valid == 'true'
        run: |
          echo "=== CHECKING REST API FOR BREAKING CHANGES ==="

@@ -516,6 +531,7 @@ jobs:
          fi

      - name: Check REST Metadata API Breaking Changes
+        if: steps.validate-schemas.outputs.valid == 'true'
        run: |
          echo "=== CHECKING REST METADATA API FOR BREAKING CHANGES ==="

@@ -1,11 +1,13 @@
-name: CI Create App E2E
+name: CI Hello world App E2E

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

 permissions:
  contents: read
@@ -29,19 +31,17 @@ jobs:
        !packages/twenty-client-sdk/package.json
        !packages/twenty-shared/package.json
        !packages/twenty-server/package.json
-  create-app-e2e:
+  create-app-e2e-hello-world:
    needs: changed-files-check
    if: needs.changed-files-check.outputs.any_changed == 'true'
    timeout-minutes: 30
    runs-on: ubuntu-latest-4-cores
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -53,6 +53,8 @@ jobs:
        image: redis
        ports:
          - 6379:6379
+    env:
+      PUBLISHABLE_PACKAGES: twenty-client-sdk twenty-sdk create-twenty-app
    steps:
      - name: Fetch custom Github Actions and base branch history
        uses: actions/checkout@v4
@@ -66,13 +68,15 @@ jobs:
        run: |
          CI_VERSION="0.0.0-ci.$(date +%s)"
          echo "CI_VERSION=$CI_VERSION" >> $GITHUB_ENV
-          npx nx run-many -t set-local-version -p twenty-sdk twenty-client-sdk create-twenty-app --releaseVersion=$CI_VERSION
+          for pkg in $PUBLISHABLE_PACKAGES; do
+            npx nx run $pkg:set-local-version --releaseVersion=$CI_VERSION
+          done

      - name: Build packages
        run: |
-          npx nx build twenty-sdk
-          npx nx build twenty-client-sdk
-          npx nx build create-twenty-app
+          for pkg in $PUBLISHABLE_PACKAGES; do
+            npx nx build $pkg
+          done

      - name: Install and start Verdaccio
        run: |
@@ -89,11 +93,13 @@ jobs:

      - name: Publish packages to local registry
        run: |
-          npm set //localhost:4873/:_authToken "ci-auth-token"
+          yarn config set npmRegistryServer http://localhost:4873
+          yarn config set unsafeHttpWhitelist --json '["localhost"]'
+          yarn config set npmAuthToken ci-auth-token

-          for pkg in twenty-sdk twenty-client-sdk create-twenty-app; do
+          for pkg in $PUBLISHABLE_PACKAGES; do
            cd packages/$pkg
-            npm publish --registry http://localhost:4873 --tag ci
+            yarn npm publish --tag ci
            cd ../..
          done

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

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

      - name: Verify installed app versions
        run: |
@@ -118,7 +126,7 @@ jobs:
          echo "--- Checking package.json references correct SDK version ---"
          node -e "
            const pkg = require('./package.json');
-            const sdkVersion = pkg.devDependencies['twenty-sdk'];
+            const sdkVersion = pkg.dependencies['twenty-sdk'];
            if (!sdkVersion.startsWith('0.0.0-ci.')) {
              console.error('Expected twenty-sdk version to start with 0.0.0-ci., got:', sdkVersion);
              process.exit(1);
@@ -154,7 +162,7 @@ jobs:
          SEED_API_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik'
        run: |
          cd /tmp/e2e-test-workspace/test-app
-          npx --no-install twenty remote add --token $SEED_API_KEY --url http://localhost:3000
+          npx --no-install twenty remote add --api-key $SEED_API_KEY --api-url http://localhost:3000

      - name: Deploy scaffolded app
        run: |
@@ -178,7 +186,7 @@ jobs:
          cd /tmp/e2e-test-workspace/test-app
          EXEC_OUTPUT=$(npx --no-install twenty exec --functionName create-hello-world-company)
          echo "$EXEC_OUTPUT"
-          echo "$EXEC_OUTPUT" | grep -q "Created company"
+          echo "$EXEC_OUTPUT" | grep -q 'Created company.*Hello World.*with id'

      - name: Run scaffolded app integration test
        env:
@@ -187,11 +195,11 @@ jobs:
          cd /tmp/e2e-test-workspace/test-app
          yarn test

-  ci-create-app-e2e-status-check:
+  ci-create-app-e2e-hello-world-status-check:
    if: always() && !cancelled()
    timeout-minutes: 5
    runs-on: ubuntu-latest
-    needs: [changed-files-check, create-app-e2e]
+    needs: [changed-files-check, create-app-e2e-hello-world]
    steps:
      - name: Fail job if any needs failed
        if: contains(needs.*.result, 'failure')
@@ -0,0 +1,186 @@
+name: CI Create App E2E minimal
+
+on:
+  push:
+    branches:
+      - main
+
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  changed-files-check:
+    uses: ./.github/workflows/changed-files.yaml
+    with:
+      files: |
+        packages/create-twenty-app/**
+        packages/twenty-sdk/**
+        packages/twenty-client-sdk/**
+        packages/twenty-shared/**
+        packages/twenty-server/**
+        !packages/create-twenty-app/package.json
+        !packages/twenty-sdk/package.json
+        !packages/twenty-client-sdk/package.json
+        !packages/twenty-shared/package.json
+        !packages/twenty-server/package.json
+  create-app-e2e-minimal:
+    needs: changed-files-check
+    if: needs.changed-files-check.outputs.any_changed == 'true'
+    timeout-minutes: 30
+    runs-on: ubuntu-latest-4-cores
+    services:
+      postgres:
+        image: postgres:18
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+      redis:
+        image: redis
+        ports:
+          - 6379:6379
+    env:
+      PUBLISHABLE_PACKAGES: twenty-client-sdk twenty-sdk create-twenty-app
+    steps:
+      - name: Fetch custom Github Actions and base branch history
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 10
+
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+
+      - name: Set CI version and prepare packages for publish
+        run: |
+          CI_VERSION="0.0.0-ci.$(date +%s)"
+          echo "CI_VERSION=$CI_VERSION" >> $GITHUB_ENV
+          npx nx run-many -t set-local-version -p $PUBLISHABLE_PACKAGES --releaseVersion=$CI_VERSION
+
+      - name: Build packages
+        run: |
+          for pkg in $PUBLISHABLE_PACKAGES; do
+            npx nx build $pkg
+          done
+
+      - name: Install and start Verdaccio
+        run: |
+          npx verdaccio --config .github/verdaccio-config.yaml &
+
+          for i in $(seq 1 30); do
+            if curl -s http://localhost:4873 > /dev/null 2>&1; then
+              echo "Verdaccio is ready"
+              break
+            fi
+            echo "Waiting for Verdaccio... ($i/30)"
+            sleep 1
+          done
+
+      - name: Publish packages to local registry
+        run: |
+          yarn config set npmRegistryServer http://localhost:4873
+          yarn config set unsafeHttpWhitelist --json '["localhost"]'
+          yarn config set npmAuthToken ci-auth-token
+
+          for pkg in $PUBLISHABLE_PACKAGES; do
+            cd packages/$pkg
+            yarn npm publish --tag ci
+            cd ../..
+          done
+
+      - name: Scaffold app using published create-twenty-app
+        run: |
+          npm install -g create-twenty-app@$CI_VERSION --registry http://localhost:4873
+          create-twenty-app --version
+          mkdir -p /tmp/e2e-test-workspace
+          cd /tmp/e2e-test-workspace
+          create-twenty-app test-app --display-name "Test scaffolded app" --description "E2E test scaffolded app" --skip-local-instance
+
+      - name: Install scaffolded app dependencies
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          echo 'npmRegistryServer: "http://localhost:4873"' >> .yarnrc.yml
+          echo 'unsafeHttpWhitelist: ["localhost"]' >> .yarnrc.yml
+          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn install --no-immutable
+
+      - name: Verify installed app versions
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          echo "--- Checking package.json references correct SDK version ---"
+          node -e "
+            const pkg = require('./package.json');
+            const sdkVersion = pkg.dependencies['twenty-sdk'];
+            if (!sdkVersion.startsWith('0.0.0-ci.')) {
+              console.error('Expected twenty-sdk version to start with 0.0.0-ci., got:', sdkVersion);
+              process.exit(1);
+            }
+            console.log('SDK version in scaffolded app:', sdkVersion);
+          "
+
+      - name: Verify SDK CLI is available
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty --version
+
+      - name: Setup server environment
+        run: npx nx reset:env:e2e-testing-server twenty-server
+
+      - name: Build server
+        run: npx nx build twenty-server
+
+      - name: Create and setup database
+        run: |
+          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
+          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
+          npx nx run twenty-server:database:reset
+
+      - name: Start server
+        run: |
+          npx nx start twenty-server &
+          echo "Waiting for server to be ready..."
+          timeout 60 bash -c 'until curl -s http://localhost:3000/health; do sleep 2; done'
+
+      - name: Authenticate with twenty-server
+        env:
+          SEED_API_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik'
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty remote add --api-key $SEED_API_KEY --api-url http://localhost:3000
+
+      - name: Deploy scaffolded app
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty deploy
+
+      - name: Install scaffolded app
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty install
+
+      - name: Run scaffolded app integration test
+        env:
+          TWENTY_API_URL: http://localhost:3000
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          yarn test
+
+  ci-create-app-e2e-minimal-status-check:
+    if: always() && !cancelled()
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    needs: [changed-files-check, create-app-e2e-minimal]
+    steps:
+      - name: Fail job if any needs failed
+        if: contains(needs.*.result, 'failure')
+        run: exit 1
@@ -0,0 +1,204 @@
+name: CI Postcard App E2E
+
+on:
+  # Temporarily disabled — will be re-enabled when example apps are published.
+  # push:
+  #   branches:
+  #     - main
+  #
+  # pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  changed-files-check:
+    uses: ./.github/workflows/changed-files.yaml
+    with:
+      files: |
+        packages/create-twenty-app/**
+        packages/twenty-sdk/**
+        packages/twenty-client-sdk/**
+        packages/twenty-shared/**
+        packages/twenty-server/**
+        !packages/create-twenty-app/package.json
+        !packages/twenty-sdk/package.json
+        !packages/twenty-client-sdk/package.json
+        !packages/twenty-shared/package.json
+        !packages/twenty-server/package.json
+  create-app-e2e-postcard:
+    needs: changed-files-check
+    if: needs.changed-files-check.outputs.any_changed == 'true'
+    timeout-minutes: 30
+    runs-on: ubuntu-latest-4-cores
+    services:
+      postgres:
+        image: postgres:18
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+      redis:
+        image: redis
+        ports:
+          - 6379:6379
+    env:
+      PUBLISHABLE_PACKAGES: twenty-client-sdk twenty-sdk create-twenty-app
+    steps:
+      - name: Fetch custom Github Actions and base branch history
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 10
+
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+
+      - name: Set CI version and prepare packages for publish
+        run: |
+          CI_VERSION="0.0.0-ci.$(date +%s)"
+          echo "CI_VERSION=$CI_VERSION" >> $GITHUB_ENV
+          npx nx run-many -t set-local-version -p $PUBLISHABLE_PACKAGES --releaseVersion=$CI_VERSION
+
+      - name: Build packages
+        run: |
+          for pkg in $PUBLISHABLE_PACKAGES; do
+            npx nx build $pkg
+          done
+
+      - name: Install and start Verdaccio
+        run: |
+          npx verdaccio --config .github/verdaccio-config.yaml &
+
+          for i in $(seq 1 30); do
+            if curl -s http://localhost:4873 > /dev/null 2>&1; then
+              echo "Verdaccio is ready"
+              break
+            fi
+            echo "Waiting for Verdaccio... ($i/30)"
+            sleep 1
+          done
+
+      - name: Publish packages to local registry
+        run: |
+          yarn config set npmRegistryServer http://localhost:4873
+          yarn config set unsafeHttpWhitelist --json '["localhost"]'
+          yarn config set npmAuthToken ci-auth-token
+
+          for pkg in $PUBLISHABLE_PACKAGES; do
+            cd packages/$pkg
+            yarn npm publish --tag ci
+            cd ../..
+          done
+
+      - name: Scaffold app using published create-twenty-app
+        run: |
+          npm install -g create-twenty-app@$CI_VERSION --registry http://localhost:4873
+          create-twenty-app --version
+          mkdir -p /tmp/e2e-test-workspace
+          cd /tmp/e2e-test-workspace
+          create-twenty-app test-app --example postcard --display-name "Test postcard app" --description "E2E test postcard app" --skip-local-instance
+
+      - name: Install scaffolded app dependencies
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          echo 'npmRegistryServer: "http://localhost:4873"' >> .yarnrc.yml
+          echo 'unsafeHttpWhitelist: ["localhost"]' >> .yarnrc.yml
+          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn install --no-immutable
+          echo "--- Installing last SDK versions ---"
+          YARN_ENABLE_IMMUTABLE_INSTALLS=false yarn add twenty-sdk twenty-client-sdk
+
+      - name: Verify installed app versions
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          echo "--- Checking package.json references correct SDK version ---"
+          node -e "
+            const pkg = require('./package.json');
+            const sdkVersion = pkg.dependencies['twenty-sdk'];
+            if (!sdkVersion.startsWith('0.0.0-ci.')) {
+              console.error('Expected twenty-sdk version to start with 0.0.0-ci., got:', sdkVersion);
+              process.exit(1);
+            }
+            console.log('SDK version in scaffolded app:', sdkVersion);
+          "
+
+      - name: Verify SDK CLI is available
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty --version
+
+      - name: Setup server environment
+        run: npx nx reset:env:e2e-testing-server twenty-server
+
+      - name: Build server
+        run: npx nx build twenty-server
+
+      - name: Create and setup database
+        run: |
+          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
+          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
+          npx nx run twenty-server:database:reset
+
+      - name: Start server
+        run: |
+          npx nx start twenty-server &
+          echo "Waiting for server to be ready..."
+          timeout 60 bash -c 'until curl -s http://localhost:3000/health; do sleep 2; done'
+
+      - name: Authenticate with twenty-server
+        env:
+          SEED_API_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik'
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty remote add --api-key $SEED_API_KEY --api-url http://localhost:3000
+
+      - name: Deploy scaffolded app
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty deploy
+
+      - name: Install scaffolded app
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          npx --no-install twenty install
+
+      - name: Execute postcard logic function
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          EXEC_OUTPUT=$(npx --no-install twenty exec --functionName postcard-logic-function)
+          echo "$EXEC_OUTPUT"
+          echo "$EXEC_OUTPUT" | grep -q "Hello, World!"
+
+      - name: Execute create-postcard-company logic function
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          EXEC_OUTPUT=$(npx --no-install twenty exec --functionName create-postcard-company)
+          echo "$EXEC_OUTPUT"
+          echo "$EXEC_OUTPUT" | grep -q 'Created company.*Hello World.*with id'
+
+      - name: Run scaffolded app integration test
+        env:
+          TWENTY_API_URL: http://localhost:3000
+        run: |
+          cd /tmp/e2e-test-workspace/test-app
+          yarn test
+
+  ci-create-app-e2e-postcard-status-check:
+    if: always() && !cancelled()
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    needs: [changed-files-check, create-app-e2e-postcard]
+    steps:
+      - name: Fail job if any needs failed
+        if: contains(needs.*.result, 'failure')
+        run: exit 1
@@ -0,0 +1,114 @@
+name: CI Front Component Renderer
+
+on:
+  pull_request:
+  merge_group:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  changed-files-check:
+    if: github.event_name != 'merge_group'
+    uses: ./.github/workflows/changed-files.yaml
+    with:
+      files: |
+        package.json
+        yarn.lock
+        packages/twenty-front-component-renderer/**
+        packages/twenty-sdk/**
+        packages/twenty-shared/**
+        !packages/twenty-sdk/package.json
+  renderer-task:
+    needs: changed-files-check
+    if: needs.changed-files-check.outputs.any_changed == 'true'
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        task: [build, typecheck, lint]
+    steps:
+      - name: Cancel Previous Runs
+        uses: styfle/cancel-workflow-action@0.11.0
+        with:
+          access_token: ${{ github.token }}
+      - name: Fetch custom Github Actions and base branch history
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 10
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+      - name: Run ${{ matrix.task }}
+        run: npx nx ${{ matrix.task }} twenty-front-component-renderer
+  renderer-sb-build:
+    needs: changed-files-check
+    if: needs.changed-files-check.outputs.any_changed == 'true'
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cancel Previous Runs
+        uses: styfle/cancel-workflow-action@0.11.0
+        with:
+          access_token: ${{ github.token }}
+      - name: Fetch custom Github Actions and base branch history
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 10
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+      - name: Build storybook
+        run: npx nx storybook:build twenty-front-component-renderer
+      - name: Upload storybook build
+        uses: actions/upload-artifact@v4
+        with:
+          name: storybook-twenty-front-component-renderer
+          path: packages/twenty-front-component-renderer/storybook-static
+          retention-days: 1
+  renderer-sb-test:
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    needs: renderer-sb-build
+    env:
+      STORYBOOK_URL: http://localhost:6008
+    steps:
+      - name: Fetch custom Github Actions and base branch history
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 10
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+      - name: Build dependencies
+        run: npx nx build twenty-sdk
+      - name: Download storybook build
+        uses: actions/download-artifact@v4
+        with:
+          name: storybook-twenty-front-component-renderer
+          path: packages/twenty-front-component-renderer/storybook-static
+      - name: Install Playwright
+        run: |
+          cd packages/twenty-front-component-renderer
+          npx playwright install
+      - name: Serve storybook & run tests
+        run: |
+          npx http-server packages/twenty-front-component-renderer/storybook-static --port 6008 --silent &
+          timeout 30 bash -c 'until curl -sf http://localhost:6008 > /dev/null 2>&1; do sleep 1; done'
+          npx nx storybook:test twenty-front-component-renderer
+  ci-front-component-renderer-status-check:
+    if: always() && !cancelled()
+    timeout-minutes: 5
+    runs-on: ubuntu-latest
+    needs:
+      [
+        changed-files-check,
+        renderer-task,
+        renderer-sb-build,
+        renderer-sb-test,
+      ]
+    steps:
+      - name: Fail job if any needs failed
+        if: contains(needs.*.result, 'failure')
+        run: exit 1
@@ -25,6 +25,7 @@ jobs:
        package.json
        yarn.lock
        packages/twenty-front/**
+        packages/twenty-front-component-renderer/**
        packages/twenty-ui/**
        packages/twenty-shared/**
        packages/twenty-sdk/**
@@ -93,7 +94,7 @@ jobs:
        run: |
          npx nx build twenty-shared
          npx nx build twenty-ui
-          npx nx build twenty-sdk
+          npx nx build twenty-front-component-renderer
      - name: Download storybook build
        uses: actions/download-artifact@v4
        with:
@@ -25,12 +25,10 @@ jobs:
      NODE_OPTIONS: "--max-old-space-size=10240"
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: "true"
-          SPILO_PROVIDER: "local"
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -27,7 +27,7 @@ jobs:
    runs-on: ubuntu-latest
    strategy:
      matrix:
-        task: [lint, typecheck, test:unit, storybook:build, storybook:test, test:integration]
+        task: [lint, typecheck, test:unit, test:integration]
    steps:
      - name: Cancel Previous Runs
        uses: styfle/cancel-workflow-action@0.11.0
@@ -41,9 +41,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:
@@ -56,12 +53,10 @@ jobs:
    if: needs.changed-files-check.outputs.any_changed == 'true'
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -83,12 +83,10 @@ jobs:
    runs-on: ubuntu-latest
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -122,7 +120,6 @@ jobs:
          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
          PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "test";'
          npx nx run twenty-server:database:init:prod
-          npx nx run twenty-server:database:migrate:prod
      - name: Worker / Run
        run: |
          timeout 30s npx nx run twenty-server:worker || exit_code=$?
@@ -147,15 +144,15 @@ jobs:
          exit 1
      - name: Server / Check for Pending Migrations
        run: |
-          CORE_MIGRATION_OUTPUT=$(npx nx run twenty-server:typeorm migration:generate core-migration-check -d src/database/typeorm/core/core.datasource.ts || true)
+          CORE_MIGRATION_OUTPUT=$(npx nx database:migrate:generate twenty-server -- --name core-migration-check || true)

-          CORE_MIGRATION_FILE=$(ls packages/twenty-server/*core-migration-check.ts 2>/dev/null || echo "")
+          CORE_MIGRATION_FILE=$(ls packages/twenty-server/src/database/typeorm/core/migrations/common/*core-migration-check.ts 2>/dev/null || echo "")

          if [ -n "$CORE_MIGRATION_FILE" ]; then
-            echo "::error::Unexpected migration files were generated. Please create a proper migration manually."
+            echo "::error::Unexpected migration files were generated. Please run 'npx nx database:migrate:generate twenty-server -- --name <migration-name>' and commit the result."
            echo "$CORE_MIGRATION_OUTPUT"

-            rm -f packages/twenty-server/*core-migration-check.ts
+            rm -f packages/twenty-server/src/database/typeorm/core/migrations/common/*core-migration-check.ts

            exit 1
          fi
@@ -226,12 +223,10 @@ jobs:
        shard: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -27,6 +27,11 @@ jobs:
    steps:
      - name: Checkout
        uses: actions/checkout@v4
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ vars.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
      - name: Run compose
        run: |
          echo "Patching docker-compose.yml..."
@@ -97,6 +102,11 @@ jobs:
    steps:
      - name: Checkout
        uses: actions/checkout@v4
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ vars.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
      - name: Create frontend placeholder
        run: |
          mkdir -p packages/twenty-front/build
@@ -111,7 +121,7 @@ jobs:
      - name: Start container
        run: |
          docker run -d --name twenty-app-dev \
-            -p 3000:3000 \
+            -p 2020:2020 \
            twenty-app-dev-ci
          docker logs twenty-app-dev -f &
      - name: Wait for server health
@@ -119,10 +129,10 @@ jobs:
          echo "Waiting for twenty-app-dev to become healthy..."
          count=0
          while true; do
-            status=$(curl -s -o /dev/null -w '%{http_code}' http://localhost:3000/healthz 2>/dev/null || echo "000")
+            status=$(curl -s -o /dev/null -w '%{http_code}' http://localhost:2020/healthz 2>/dev/null || echo "000")
            if [ "$status" = "200" ]; then
              echo "Server is healthy!"
-              curl -s http://localhost:3000/healthz
+              curl -s http://localhost:2020/healthz
              break
            fi

@@ -26,12 +26,10 @@ jobs:
    runs-on: ubuntu-latest
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -29,12 +29,10 @@ jobs:
    runs-on: ubuntu-latest
    services:
      postgres:
-        image: twentycrm/twenty-postgres-spilo
+        image: postgres:18
        env:
-          PGUSER_SUPERUSER: postgres
-          PGPASSWORD_SUPERUSER: postgres
-          ALLOW_NOSSL: 'true'
-          SPILO_PROVIDER: 'local'
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
        ports:
          - 5432:5432
        options: >-
@@ -17,6 +17,12 @@ jobs:
        with:
          ref: ${{ github.event.client_payload.pr_head_sha }}

+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ vars.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
      - name: Run compose setup
        run: |
          echo "Patching docker-compose.yml..."
@@ -52,3 +52,4 @@ mcp.json
 /.junie/
 TRANSLATION_QA_REPORT.md
 .playwright-mcp/
+.playwright-cli/
@@ -6,4 +6,4 @@ enableInlineHunks: true

 nodeLinker: node-modules

-yarnPath: .yarn/releases/yarn-4.9.2.cjs
+yarnPath: .yarn/releases/yarn-4.13.0.cjs
@@ -141,7 +141,7 @@
      "cache": false,
      "options": {
        "cwd": "{projectRoot}",
-        "command": "npm pkg set version={args.releaseVersion}"
+        "command": "node -e \"const fs=require('fs'),p=JSON.parse(fs.readFileSync('package.json','utf8'));p.version='{args.releaseVersion}';fs.writeFileSync('package.json',JSON.stringify(p,null,2)+'\\n');\""
      }
    },
    "storybook:build": {
@@ -82,11 +82,11 @@
    "@sentry/types": "^8",
    "@storybook-community/storybook-addon-cookie": "^5.0.0",
    "@storybook/addon-coverage": "^3.0.0",
-    "@storybook/addon-docs": "^10.2.13",
-    "@storybook/addon-links": "^10.2.13",
-    "@storybook/addon-vitest": "^10.2.13",
+    "@storybook/addon-docs": "^10.3.3",
+    "@storybook/addon-links": "^10.3.3",
+    "@storybook/addon-vitest": "^10.3.3",
    "@storybook/icons": "^2.0.1",
-    "@storybook/react-vite": "^10.2.13",
+    "@storybook/react-vite": "^10.3.3",
    "@storybook/test-runner": "^0.24.2",
    "@swc-node/register": "^1.11.1",
    "@swc/cli": "^0.7.10",
@@ -154,9 +154,9 @@
    "raw-loader": "^4.0.2",
    "rimraf": "^5.0.5",
    "source-map-support": "^0.5.20",
-    "storybook": "^10.2.13",
+    "storybook": "^10.3.3",
    "storybook-addon-mock-date": "2.0.0",
-    "storybook-addon-pseudo-states": "^10.2.13",
+    "storybook-addon-pseudo-states": "^10.3.3",
    "supertest": "^6.1.3",
    "ts-jest": "^29.1.1",
    "ts-loader": "^9.2.3",
@@ -175,11 +175,12 @@
  },
  "license": "AGPL-3.0",
  "name": "twenty",
-  "packageManager": "yarn@4.9.2",
+  "packageManager": "yarn@4.13.0",
  "resolutions": {
    "graphql": "16.8.1",
    "type-fest": "4.10.1",
    "typescript": "5.9.2",
+    "nodemailer": "8.0.4",
    "graphql-redis-subscriptions/ioredis": "^5.6.0",
    "@lingui/core": "5.1.2",
    "@types/qs": "6.9.16",
@@ -203,10 +204,12 @@
      "packages/twenty-utils",
      "packages/twenty-zapier",
      "packages/twenty-website",
+      "packages/twenty-website-new",
      "packages/twenty-docs",
      "packages/twenty-e2e-testing",
      "packages/twenty-shared",
      "packages/twenty-sdk",
+      "packages/twenty-front-component-renderer",
      "packages/twenty-client-sdk",
      "packages/twenty-apps",
      "packages/twenty-cli",
@@ -12,172 +12,52 @@

 </div>

-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), uninstall, and function management
- 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
- Docker (for the local Twenty dev server)
+The official scaffolding CLI for building apps on top of [Twenty CRM](https://twenty.com). Sets up a ready-to-run project with [twenty-sdk](https://www.npmjs.com/package/twenty-sdk).

 ## Quick start

 ```bash
-# Scaffold a new app — the CLI will offer to start a local Twenty server
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app
-
-# The scaffolder can automatically:
-# 1. Start a local Twenty server (Docker)
-# 2. Open the browser to log in (tim@apple.dev / tim@apple.dev)
-# 3. Authenticate your app via OAuth
-
-# Or do it manually:
-yarn twenty server start          # Start local Twenty server
-yarn twenty remote add --local    # Authenticate via OAuth
-
-# Start dev mode: watches, builds, and syncs local changes to your workspace
-# (also auto-generates typed CoreApiClient — MetadataApiClient ships pre-built — both available via `twenty-client-sdk`)
 yarn twenty dev
-
-# Watch your application's function logs
-yarn twenty logs
-
-# Execute a function with a JSON payload
-yarn twenty exec -n my-function -p '{"key": "value"}'
-
-# Execute the pre-install function
-yarn twenty exec --preInstall
-
-# Execute the post-install function
-yarn twenty exec --postInstall
-
-# Build the app for distribution
-yarn twenty build
-
-# Publish the app to npm or directly to a Twenty server
-yarn twenty publish
-
-# Uninstall the application from the current workspace
-yarn twenty uninstall
 ```

-## Scaffolding modes
+The scaffolder will:

-Control which example files are included when creating a new app:
+1. Create a new project with TypeScript, linting, tests, and a preconfigured `twenty` CLI
+2. Optionally start a local Twenty server (Docker)
+3. Open the browser for OAuth authentication

-| Flag               | Behavior                                                                |
-| ------------------ | ----------------------------------------------------------------------- |
-| `-e, --exhaustive` | **(default)** Creates all example files                                 |
-| `-m, --minimal`    | Creates only core files (`application-config.ts` and `default-role.ts`) |
+## Options
+
+| Flag                           | Description                             |
+| ------------------------------ | --------------------------------------- |
+| `--example <name>`             | Initialize from an example              |
+| `--name <name>`                | Set the app name (skips the prompt)     |
+| `--display-name <displayName>` | Set the display name (skips the prompt) |
+| `--description <description>`  | Set the description (skips the prompt)  |
+| `--skip-local-instance`        | Skip the local server setup prompt      |
+
+By default (no flags), a minimal app is generated with core files and an integration test. Use `--example` to start from a richer example:

 ```bash
-# Default: all examples included
-npx create-twenty-app@latest my-app
-
-# Minimal: only core files
-npx create-twenty-app@latest my-app -m
+npx create-twenty-app@latest my-twenty-app --example hello-world
 ```

-## What gets scaffolded
+Examples are sourced from [twentyhq/twenty/packages/twenty-apps/examples](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples).

-**Core files (always created):**
+## Documentation

- `application-config.ts` — Application metadata configuration
- `roles/default-role.ts` — Default role for logic functions
- `logic-functions/pre-install.ts` — Pre-install logic function (runs before app installation)
- `logic-functions/post-install.ts` — Post-install logic function (runs after app installation)
- TypeScript configuration, Oxlint, package.json, .gitignore
- A prewired `twenty` script that delegates to the `twenty` CLI from twenty-sdk
+Full documentation is available at **[docs.twenty.com/developers/extend/apps](https://docs.twenty.com/developers/extend/apps/getting-started)**:

-**Example files (controlled by scaffolding mode):**
-
- `objects/example-object.ts` — Example custom object with a text field
- `fields/example-field.ts` — Example standalone field extending the example object
- `logic-functions/hello-world.ts` — Example logic function with HTTP trigger
- `front-components/hello-world.tsx` — Example front component
- `views/example-view.ts` — Example saved view for the example object
- `navigation-menu-items/example-navigation-menu-item.ts` — Example sidebar navigation link
- `skills/example-skill.ts` — Example AI agent skill definition
- `__tests__/app-install.integration-test.ts` — Integration test that builds, installs, and verifies the app (includes `vitest.config.ts`, `tsconfig.spec.json`, and a setup file)
-
-## Local server
-
-The scaffolder can start a local Twenty dev server for you (all-in-one Docker image with PostgreSQL, Redis, server, and worker). You can also manage it manually:
-
-```bash
-yarn twenty server start     # Start (pulls image if needed)
-yarn twenty server status    # Check if it's healthy
-yarn twenty server logs      # Stream logs
-yarn twenty server stop      # Stop (data is preserved)
-yarn twenty server reset     # Wipe all data and start fresh
-```
-
-The server is pre-seeded with a workspace and user (`tim@apple.dev` / `tim@apple.dev`).
-
-### How to use a local Twenty instance
-
-If you're already running a local Twenty instance, you can connect to it instead of using Docker. Pass the port your local server is listening on (default: `3000`):
-
-```bash
-npx create-twenty-app@latest my-app --port 3000
-```
-
-## Next steps
-
- Run `yarn twenty help` to see all available commands.
- Use `yarn twenty remote add --local` to authenticate with your Twenty workspace via OAuth.
- Explore the generated project and add your first entity with `yarn twenty add` (logic functions, front components, objects, roles, views, navigation menu items, skills).
- Use `yarn twenty dev` while you iterate — it watches, builds, and syncs changes to your workspace in real time.
- `CoreApiClient` is auto-generated by `yarn twenty dev`. `MetadataApiClient` (for workspace configuration and file uploads via `/metadata`) ships pre-built with the SDK. Both are available via `import { CoreApiClient } from 'twenty-client-sdk/core'` and `import { MetadataApiClient } from 'twenty-client-sdk/metadata'`.
-
-## Build and publish your application
-
-Once your app is ready, build and publish it using the CLI:
-
-```bash
-# Build the app (output goes to .twenty/output/)
-yarn twenty build
-
-# Build and create a tarball (.tgz) for distribution
-yarn twenty build --tarball
-
-# Publish to npm (requires npm login)
-yarn twenty publish
-
-# Publish with a dist-tag (e.g. beta, next)
-yarn twenty publish --tag beta
-
-# Deploy directly to a Twenty server (builds, uploads, and installs in one step)
-yarn twenty deploy
-```
-
-### Publish to the Twenty marketplace
-
-You can also contribute your application to the curated marketplace:
-
-```bash
-git clone https://github.com/twentyhq/twenty.git
-cd twenty
-git checkout -b feature/my-awesome-app
-```
-
- Copy your app folder into `twenty/packages/twenty-apps`.
- Commit your changes and open a pull request on https://github.com/twentyhq/twenty
-
-Our team reviews contributions for quality, security, and reusability before merging.
+- [Getting Started](https://docs.twenty.com/developers/extend/apps/getting-started) — step-by-step setup, project structure, server management, CI
+- [Building Apps](https://docs.twenty.com/developers/extend/apps/building) — entity definitions, API clients, testing
+- [Publishing](https://docs.twenty.com/developers/extend/apps/publishing) — deploy, npm publish, marketplace

 ## Troubleshooting

 - Server not starting: check Docker is running (`docker info`), then try `yarn twenty server logs`.
- Auth not working: make sure you're logged in to Twenty in the browser first, then run `yarn twenty remote add --local`.
+- Auth not working: make sure you are logged in to Twenty in the browser, then run `yarn twenty remote add`.
 - Types not generated: ensure `yarn twenty dev` is running — it auto-generates the typed client.

 ## Contributing
@@ -1,6 +1,6 @@
 {
  "name": "create-twenty-app",
-  "version": "0.8.0-canary.2",
+  "version": "0.8.0",
  "description": "Command-line interface to create Twenty application",
  "main": "dist/cli.cjs",
  "bin": "dist/cli.cjs",
@@ -36,6 +36,7 @@
    "lodash.camelcase": "^4.3.0",
    "lodash.kebabcase": "^4.1.1",
    "lodash.startcase": "^4.4.0",
+    "twenty-sdk": "workspace:*",
    "uuid": "^13.0.0"
  },
  "devDependencies": {
@@ -45,7 +46,6 @@
    "@types/lodash.kebabcase": "^4.1.7",
    "@types/lodash.startcase": "^4",
    "@types/node": "^20.0.0",
-    "twenty-sdk": "workspace:*",
    "twenty-shared": "workspace:*",
    "typescript": "^5.9.2",
    "vite": "^7.0.0",
@@ -2,7 +2,6 @@
 import chalk from 'chalk';
 import { Command, CommanderError } from 'commander';
 import { CreateAppCommand } from '@/create-app.command';
-import { type ScaffoldingMode } from '@/types/scaffolding-options';
 import packageJson from '../package.json';

 const program = new Command(packageJson.name)
@@ -13,11 +12,7 @@ const program = new Command(packageJson.name)
    'Output the current version of create-twenty-app.',
  )
  .argument('[directory]')
-  .option('-e, --exhaustive', 'Create all example entities (default)')
-  .option(
-    '-m, --minimal',
-    'Create only core entities (application-config and default-role)',
-  )
+  .option('--example <name>', 'Initialize from an example')
  .option('-n, --name <name>', 'Application name (skips prompt)')
  .option(
    '-d, --display-name <displayName>',
@@ -31,35 +26,18 @@ const program = new Command(packageJson.name)
    '--skip-local-instance',
    'Skip the local Twenty instance setup prompt',
  )
-  .option(
-    '-p, --port <port>',
-    'Port of an existing Twenty server (skips Docker setup)',
-  )
  .helpOption('-h, --help', 'Display this help message.')
  .action(
    async (
      directory?: string,
      options?: {
-        exhaustive?: boolean;
-        minimal?: boolean;
+        example?: string;
        name?: string;
        displayName?: string;
        description?: string;
        skipLocalInstance?: boolean;
-        port?: string;
      },
    ) => {
-      const modeFlags = [options?.exhaustive, options?.minimal].filter(Boolean);
-
-      if (modeFlags.length > 1) {
-        console.error(
-          chalk.red(
-            'Error: --exhaustive and --minimal are mutually exclusive.',
-          ),
-        );
-        process.exit(1);
-      }
-
      if (directory && !/^[a-z0-9-]+$/.test(directory)) {
        console.error(
          chalk.red(
@@ -74,18 +52,13 @@ const program = new Command(packageJson.name)
        process.exit(1);
      }

-      const mode: ScaffoldingMode = options?.minimal ? 'minimal' : 'exhaustive';
-
-      const port = options?.port ? parseInt(options.port, 10) : undefined;
-
      await new CreateAppCommand().execute({
        directory,
-        mode,
+        example: options?.example,
        name: options?.name,
        displayName: options?.displayName,
        description: options?.description,
        skipLocalInstance: options?.skipLocalInstance,
-        port,
      });
    },
  );
@@ -0,0 +1,14 @@
+## Base documentation
+
+- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples/postcard
+
+## UUID requirement
+
+- All generated UUIDs must be valid UUID v4.
+
+## Common Pitfalls
+
+- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
+- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
+- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -0,0 +1,14 @@
+## Base documentation
+
+- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples/postcard
+
+## UUID requirement
+
+- All generated UUIDs must be valid UUID v4.
+
+## Common Pitfalls
+
+- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
+- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
+- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -1,7 +1,7 @@
 ## Base documentation

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

 ## UUID requirement

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

 ## Learn More

- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/capabilities/apps)
+- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started)
 - [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)
 - [Discord](https://discord.gg/cx5n4Jzs57)
@@ -0,0 +1,35 @@
+{
+  "name": "TO-BE-GENERATED",
+  "version": "0.1.0",
+  "license": "MIT",
+  "engines": {
+    "node": "^24.5.0",
+    "npm": "please-use-yarn",
+    "yarn": ">=4.0.2"
+  },
+  "keywords": [
+    "twenty-app"
+  ],
+  "packageManager": "yarn@4.9.2",
+  "scripts": {
+    "twenty": "twenty",
+    "lint": "oxlint -c .oxlintrc.json .",
+    "lint:fix": "oxlint --fix -c .oxlintrc.json .",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "twenty-client-sdk": "TO-BE-GENERATED",
+    "twenty-sdk": "TO-BE-GENERATED"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "@types/react": "^19.0.0",
+    "oxlint": "^0.16.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^4.2.1",
+    "vitest": "^3.1.1"
+  }
+}
@@ -0,0 +1,70 @@
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+  beforeAll(async () => {
+    const buildResult = await appBuild({
+      appPath: APP_PATH,
+      tarball: true,
+      onProgress: (message: string) => console.log(`[build] ${message}`),
+    });
+
+    if (!buildResult.success) {
+      throw new Error(
+        `Build failed: ${buildResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+
+    const deployResult = await appDeploy({
+      tarballPath: buildResult.data.tarballPath!,
+      onProgress: (message: string) => console.log(`[deploy] ${message}`),
+    });
+
+    if (!deployResult.success) {
+      throw new Error(
+        `Deploy failed: ${deployResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+
+    const installResult = await appInstall({ appPath: APP_PATH });
+
+    if (!installResult.success) {
+      throw new Error(
+        `Install failed: ${installResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+  });
+
+  afterAll(async () => {
+    const uninstallResult = await appUninstall({ appPath: APP_PATH });
+
+    if (!uninstallResult.success) {
+      console.warn(
+        `App uninstall failed: ${uninstallResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+  });
+
+  it('should find the installed app in the applications list', async () => {
+    const metadataClient = new MetadataApiClient();
+
+    const result = await metadataClient.query({
+      findManyApplications: {
+        id: true,
+        name: true,
+        universalIdentifier: true,
+      },
+    });
+
+    const installedApp = result.findManyApplications.find(
+      (application: { universalIdentifier: string }) =>
+        application.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+    );
+
+    expect(installedApp).toBeDefined();
+  });
+});
@@ -0,0 +1,45 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+const assertServerIsReachable = async () => {
+  let response: Response;
+
+  try {
+    response = await fetch(`${TWENTY_API_URL}/healthz`);
+  } catch {
+    throw new Error(
+      `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+        'Make sure the server is running before executing integration tests.',
+    );
+  }
+
+  if (!response.ok) {
+    throw new Error(`Server at ${TWENTY_API_URL} returned ${response.status}`);
+  }
+};
+
+beforeAll(async () => {
+  await assertServerIsReachable();
+
+  fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+  const configFile = {
+    remotes: {
+      local: {
+        apiUrl: process.env.TWENTY_API_URL,
+        apiKey: process.env.TWENTY_API_KEY,
+      },
+    },
+    defaultRemote: 'local',
+  };
+
+  fs.writeFileSync(
+    path.join(TEST_CONFIG_DIR, 'config.json'),
+    JSON.stringify(configFile, null, 2),
+  );
+});
@@ -0,0 +1,15 @@
+import { defineApplication } from 'twenty-sdk';
+
+import {
+  APP_DESCRIPTION,
+  APP_DISPLAY_NAME,
+  APPLICATION_UNIVERSAL_IDENTIFIER,
+  DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+} from 'src/constants/universal-identifiers';
+
+export default defineApplication({
+  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
+  displayName: APP_DISPLAY_NAME,
+  description: APP_DESCRIPTION,
+  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+});
@@ -0,0 +1,4 @@
+export const APP_DISPLAY_NAME = 'DISPLAY-NAME-TO-BE-GENERATED';
+export const APP_DESCRIPTION = 'DESCRIPTION-TO-BE-GENERATED';
+export const APPLICATION_UNIVERSAL_IDENTIFIER = 'UUID-TO-BE-GENERATED';
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER = 'UUID-TO-BE-GENERATED';
@@ -0,0 +1,16 @@
+import { defineRole } from 'twenty-sdk';
+
+import {
+  APP_DISPLAY_NAME,
+  DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+} from 'src/constants/universal-identifiers';
+
+export default defineRole({
+  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  label: `${APP_DISPLAY_NAME} default function role`,
+  description: `${APP_DISPLAY_NAME} default function role`,
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: true,
+  canDestroyAllObjectRecords: false,
+});
@@ -33,5 +33,10 @@
    "**/*.test.ts",
    "**/*.spec.ts",
    "**/*.integration-test.ts"
+  ],
+  "references": [
+    {
+      "path": "./tsconfig.spec.json"
+    }
  ]
 }
@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "types": ["vitest/globals", "node"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["node_modules", "dist"]
+}
@@ -0,0 +1,21 @@
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  plugins: [
+    tsconfigPaths({
+      projects: ['tsconfig.spec.json'],
+      ignoreConfigErrors: true,
+    }),
+  ],
+  test: {
+    testTimeout: 120_000,
+    hookTimeout: 120_000,
+    include: ['src/**/*.integration-test.ts'],
+    setupFiles: ['src/__tests__/setup-test.ts'],
+    env: {
+      TWENTY_API_KEY:
+        'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ1c2VySWQiOiIyMDIwMjAyMC1lNmI1LTQ2ODAtOGEzMi1iODIwOTczNzE1NmIiLCJ3b3Jrc3BhY2VJZCI6IjIwMjAyMDIwLTFjMjUtNGQwMi1iZjI1LTZhZWNjZjdlYTQxOSIsIndvcmtzcGFjZU1lbWJlcklkIjoiMjAyMDIwMjAtNDYzZi00MzViLTgyOGMtMTA3ZTAwN2EyNzExIiwidXNlcldvcmtzcGFjZUlkIjoiMjAyMDIwMjAtMWU3Yy00M2Q5LWE1ZGItNjg1YjUwNjlkODE2IiwidHlwZSI6IkFDQ0VTUyIsImF1dGhQcm92aWRlciI6InBhc3N3b3JkIiwiaWF0IjoxNzUxMjgxNzA0LCJleHAiOjIwNjY4NTc3MDR9.HMGqCsVlOAPVUBhKSGlD1X86VoHKt4LIUtET3CGIdik',
+    },
+  },
+});
@@ -0,0 +1,2 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
@@ -1,35 +1,32 @@
-import { basename } from 'path';
 import { copyBaseApplicationProject } from '@/utils/app-template';
+import { downloadExample } from '@/utils/download-example';
 import { convertToLabel } from '@/utils/convert-to-label';
 import { install } from '@/utils/install';
-import {
-  type LocalInstanceResult,
-  setupLocalInstance,
-} from '@/utils/setup-local-instance';
 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 { execSync } from 'node:child_process';
 import * as path from 'path';
-import { isDefined } from 'twenty-shared/utils';
-
+import { basename } from 'path';
 import {
-  type ExampleOptions,
-  type ScaffoldingMode,
-} from '@/types/scaffolding-options';
+  authLoginOAuth,
+  ConfigService,
+  detectLocalServer,
+  serverStart,
+  type ServerStartResult,
+} from 'twenty-sdk/cli';
+import { isDefined } from 'twenty-shared/utils';

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

 type CreateAppOptions = {
  directory?: string;
-  mode?: ScaffoldingMode;
+  example?: string;
  name?: string;
  displayName?: string;
  description?: string;
  skipLocalInstance?: boolean;
-  port?: number;
 };

 export class CreateAppCommand {
@@ -38,39 +35,59 @@ export class CreateAppCommand {
      await this.getAppInfos(options);

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

      this.logCreationInfo({ appDirectory, appName });

      await fs.ensureDir(appDirectory);

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

      await install(appDirectory);

      await tryGitInit(appDirectory);

-      let localResult: LocalInstanceResult = { running: false };
+      let serverResult: ServerStartResult | undefined;

      if (!options.skipLocalInstance) {
-        localResult = await setupLocalInstance(appDirectory, options.port);
+        const shouldStartServer = await this.shouldStartServer();

-        if (localResult.running && localResult.serverUrl) {
-          await this.connectToLocal(appDirectory, localResult.serverUrl);
+        if (shouldStartServer) {
+          const startResult = await serverStart({
+            onProgress: (message: string) => console.log(chalk.gray(message)),
+          });
+
+          if (startResult.success) {
+            serverResult = startResult.data;
+            await this.promptConnectToLocal(serverResult.url);
+          } else {
+            console.log(chalk.yellow(`\n${startResult.error.message}`));
+          }
        }
      }

-      this.logSuccess(appDirectory, localResult);
+      this.logSuccess(appDirectory, serverResult);
    } catch (error) {
      console.error(
        chalk.red('\nCreate application failed:'),
@@ -91,13 +108,14 @@ export class CreateAppCommand {
    const hasName = isDefined(options.name) || isDefined(directory);
    const hasDisplayName = isDefined(options.displayName);
    const hasDescription = isDefined(options.description);
+    const hasExample = isDefined(options.example);

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

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

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

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

-  private async connectToLocal(
-    appDirectory: string,
-    serverUrl: string,
-  ): Promise<void> {
+  private async shouldStartServer(): Promise<boolean> {
+    const existingServerUrl = await detectLocalServer();
+
+    if (existingServerUrl) {
+      return true;
+    }
+
+    const { startDocker } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'startDocker',
+        message:
+          'No running Twenty instance found. Would you like to start one using Docker?',
+        default: true,
+      },
+    ]);
+
+    return startDocker;
+  }
+
+  private async promptConnectToLocal(serverUrl: string): Promise<void> {
+    const { shouldAuthenticate } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'shouldAuthenticate',
+        message: `Would you like to authenticate to the local Twenty instance (${serverUrl})?`,
+        default: true,
+      },
+    ]);
+
+    if (!shouldAuthenticate) {
+      console.log(
+        chalk.gray(
+          'Authentication skipped. Run `yarn twenty remote add --local` manually.',
+        ),
+      );
+
+      return;
+    }
+
    try {
-      execSync(`yarn twenty remote add ${serverUrl} --as local`, {
-        cwd: appDirectory,
-        stdio: 'inherit',
+      const result = await authLoginOAuth({
+        apiUrl: serverUrl,
+        remote: 'local',
      });
+
+      if (result.success) {
+        const configService = new ConfigService();
+
+        await configService.setDefaultRemote('local');
+      } else {
+        console.log(
+          chalk.yellow(
+            'Authentication failed. Run `yarn twenty remote add --local` manually.',
+          ),
+        );
+      }
    } catch {
      console.log(
        chalk.yellow(
-          'Authentication skipped. Run `yarn twenty remote add --local` manually.',
+          'Authentication failed. Run `yarn twenty remote add` manually.',
        ),
      );
    }
@@ -217,17 +291,17 @@ export class CreateAppCommand {

  private logSuccess(
    appDirectory: string,
-    localResult: LocalInstanceResult,
+    serverResult?: ServerStartResult,
  ): void {
    const dirName = basename(appDirectory);

    console.log(chalk.blue('\nApplication created. Next steps:'));
    console.log(chalk.gray(`- cd ${dirName}`));

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

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

 const SRC_FOLDER = 'src';

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

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

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

-const createPublicAssetDirectory = async (appDirectory: string) => {
-  await fs.ensureDir(join(appDirectory, ASSETS_DIR));
+const renameGitignore = async ({ appDirectory }: { appDirectory: string }) => {
+  const gitignorePath = join(appDirectory, 'gitignore');
+
+  if (await fs.pathExists(gitignorePath)) {
+    await fs.rename(gitignorePath, join(appDirectory, '.gitignore'));
+  }
 };

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

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

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

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

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

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

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

 ## UUID requirement
 - All generated UUIDs must be valid UUID v4.
@@ -5,7 +5,7 @@ This is a [Twenty](https://twenty.com) application project bootstrapped with [`c
 First, authenticate to your workspace:

 ```bash
-yarn twenty remote add --local
+yarn twenty remote add http://localhost:2020 --as local
 ```

 Then, start development mode to sync your app and watch for changes:
@@ -22,7 +22,7 @@ Run `yarn twenty help` to list all available commands. Common commands:

 ```bash
 # Remotes & Authentication
-yarn twenty remote add --local     # Authenticate with Twenty
+yarn twenty remote add http://localhost:2020 --as local     # Authenticate with Twenty
 yarn twenty remote status         # Check auth status
 yarn twenty remote switch         # Switch default remote
 yarn twenty remote list           # List all configured remotes
@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+env:
+  TWENTY_VERSION: latest
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Spawn Twenty instance
+        id: twenty
+        uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+        with:
+          twenty-version: ${{ env.TWENTY_VERSION }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Run integration tests
+        run: yarn test
+        env:
+          TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+          TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
@@ -0,0 +1,38 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn
+
+# codegen
+generated
+
+# testing
+/coverage
+
+# dev
+/dist/
+
+.twenty
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# typescript
+*.tsbuildinfo
+*.d.ts
@@ -1,7 +1,7 @@
 ## Base documentation

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

 ## UUID requirement

@@ -5,7 +5,7 @@ This is a [Twenty](https://twenty.com) application project bootstrapped with [`c
 First, authenticate to your workspace:

 ```bash
-yarn twenty remote add --local
+yarn twenty remote add --api-url http://localhost:2020 --as local
 ```

 Then, start development mode to sync your app and watch for changes:
@@ -22,7 +22,7 @@ Run `yarn twenty help` to list all available commands. Common commands:

 ```bash
 # Remotes & Authentication
-yarn twenty remote add --local     # Authenticate with Twenty
+yarn twenty remote add --api-url http://localhost:2020 --as local     # Authenticate with Twenty
 yarn twenty remote status         # Check auth status
 yarn twenty remote switch         # Switch default remote
 yarn twenty remote list           # List all configured remotes
@@ -15,13 +15,15 @@
    "test": "vitest run",
    "test:watch": "vitest"
  },
+  "dependencies": {
+    "twenty-client-sdk": "0.8.0-canary.5",
+    "twenty-sdk": "0.8.0-canary.5"
+  },
  "devDependencies": {
    "@types/node": "^24.7.2",
    "@types/react": "^18.2.0",
    "oxlint": "^0.16.0",
    "react": "^18.2.0",
-    "twenty-client-sdk": "portal:../../twenty-client-sdk",
-    "twenty-sdk": "portal:../../twenty-sdk",
    "typescript": "^5.9.3",
    "vite-tsconfig-paths": "^4.2.1",
    "vitest": "^3.1.1"
@@ -16,8 +16,12 @@ const handler = async (): Promise<{ message: string }> => {
    },
  });

+  if (!createCompany?.id || !createCompany?.name) {
+    throw new Error('Failed to create company: missing id or name in response');
+  }
+
  return {
-    message: `Created company "${createCompany?.name}" with id ${createCompany?.id}`,
+    message: `Created company "${createCompany.name}" with id ${createCompany.id}`,
  };
 };

@@ -14,7 +14,8 @@ export default defineObject({
  labelPlural: 'Example items',
  description: 'A sample custom object',
  icon: 'IconBox',
-  labelIdentifierFieldMetadataUniversalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
+  labelIdentifierFieldMetadataUniversalIdentifier:
+    NAME_FIELD_UNIVERSAL_IDENTIFIER,
  fields: [
    {
      universalIdentifier: NAME_FIELD_UNIVERSAL_IDENTIFIER,
@@ -5,13 +5,13 @@ __metadata:
  version: 8
  cacheKey: 10c0

-"@alcalzone/ansi-tokenize@npm:^0.1.3":
-  version: 0.1.3
-  resolution: "@alcalzone/ansi-tokenize@npm:0.1.3"
+"@alcalzone/ansi-tokenize@npm:^0.2.4":
+  version: 0.2.5
+  resolution: "@alcalzone/ansi-tokenize@npm:0.2.5"
  dependencies:
    ansi-styles: "npm:^6.2.1"
-    is-fullwidth-code-point: "npm:^4.0.0"
-  checksum: 10c0/b88c5708271bb64ce132fc80dac8d5b87fc1699bf3abfdf10ecae40dbb56ab82460818f5746ecdd9870a00be9854e039d5cb3a121b808d0ff6f5bc7d0146cb38
+    is-fullwidth-code-point: "npm:^5.0.0"
+  checksum: 10c0/dd8622288426b5b7dbf8b68d51d4b930cea591d0e3b9dbc3f523131464d78ac922c165fcb7ba5307f133d35dbcaa0e6648a1c3fb6a0dc2725546d6f867b70af4
  languageName: node
  linkType: hard

@@ -2655,7 +2655,7 @@ __metadata:
  languageName: node
  linkType: hard

-"ansi-escapes@npm:^7.0.0":
+"ansi-escapes@npm:^7.3.0":
  version: 7.3.0
  resolution: "ansi-escapes@npm:7.3.0"
  dependencies:
@@ -2717,7 +2717,7 @@ __metadata:
  languageName: node
  linkType: hard

-"ansi-styles@npm:^6.0.0, ansi-styles@npm:^6.2.1":
+"ansi-styles@npm:^6.2.1, ansi-styles@npm:^6.2.3":
  version: 6.2.3
  resolution: "ansi-styles@npm:6.2.3"
  checksum: 10c0/23b8a4ce14e18fb854693b95351e286b771d23d8844057ed2e7d083cd3e708376c3323707ec6a24365f7d7eda3ca00327fe04092e29e551499ec4c8b7bfac868
@@ -2948,7 +2948,7 @@ __metadata:
  languageName: node
  linkType: hard

-"chalk@npm:^5.3.0":
+"chalk@npm:^5.3.0, chalk@npm:^5.6.0":
  version: 5.6.2
  resolution: "chalk@npm:5.6.2"
  checksum: 10c0/99a4b0f0e7991796b1e7e3f52dceb9137cae2a9dfc8fc0784a550dc4c558e15ab32ed70b14b21b52beb2679b4892b41a0aa44249bcb996f01e125d58477c6976
@@ -3020,13 +3020,13 @@ __metadata:
  languageName: node
  linkType: hard

-"cli-truncate@npm:^4.0.0":
-  version: 4.0.0
-  resolution: "cli-truncate@npm:4.0.0"
+"cli-truncate@npm:^5.1.1":
+  version: 5.2.0
+  resolution: "cli-truncate@npm:5.2.0"
  dependencies:
-    slice-ansi: "npm:^5.0.0"
-    string-width: "npm:^7.0.0"
-  checksum: 10c0/d7f0b73e3d9b88cb496e6c086df7410b541b56a43d18ade6a573c9c18bd001b1c3fba1ad578f741a4218fdc794d042385f8ac02c25e1c295a2d8b9f3cb86eb4c
+    slice-ansi: "npm:^8.0.0"
+    string-width: "npm:^8.2.0"
+  checksum: 10c0/0d4ec94702ca85b64522ac93633837fb5ea7db17b79b1322a60f6045e6ae2b8cd7bd4c1d19ac7d1f9e10e3bbda1112e172e439b68c02b785ee00da8d6a5c5471
  languageName: node
  linkType: hard

@@ -3306,7 +3306,7 @@ __metadata:
  languageName: node
  linkType: hard

-"es-toolkit@npm:^1.22.0":
+"es-toolkit@npm:^1.39.10":
  version: 1.45.1
  resolution: "es-toolkit@npm:1.45.1"
  dependenciesMeta:
@@ -3727,7 +3727,7 @@ __metadata:
  languageName: node
  linkType: hard

-"get-east-asian-width@npm:^1.0.0, get-east-asian-width@npm:^1.3.1":
+"get-east-asian-width@npm:^1.0.0, get-east-asian-width@npm:^1.3.1, get-east-asian-width@npm:^1.5.0":
  version: 1.5.0
  resolution: "get-east-asian-width@npm:1.5.0"
  checksum: 10c0/bff8bbc8d81790b9477f7aa55b1806b9f082a8dc1359fff7bd8b96939622c86b729685afc2bfeb22def1fc6ef1e5228e4d87dd4e6da60bc43a5edfb03c4ee167
@@ -3906,8 +3906,8 @@ __metadata:
    "@types/react": "npm:^18.2.0"
    oxlint: "npm:^0.16.0"
    react: "npm:^18.2.0"
-    twenty-client-sdk: "portal:../../twenty-client-sdk"
-    twenty-sdk: "portal:../../twenty-sdk"
+    twenty-client-sdk: "npm:0.8.0-canary.5"
+    twenty-sdk: "npm:0.8.0-canary.5"
    typescript: "npm:^5.9.3"
    vite-tsconfig-paths: "npm:^4.2.1"
    vitest: "npm:^3.1.1"
@@ -4030,44 +4030,45 @@ __metadata:
  languageName: node
  linkType: hard

-"ink@npm:^5.1.1":
-  version: 5.2.1
-  resolution: "ink@npm:5.2.1"
+"ink@npm:^6.8.0":
+  version: 6.8.0
+  resolution: "ink@npm:6.8.0"
  dependencies:
-    "@alcalzone/ansi-tokenize": "npm:^0.1.3"
-    ansi-escapes: "npm:^7.0.0"
+    "@alcalzone/ansi-tokenize": "npm:^0.2.4"
+    ansi-escapes: "npm:^7.3.0"
    ansi-styles: "npm:^6.2.1"
    auto-bind: "npm:^5.0.1"
-    chalk: "npm:^5.3.0"
+    chalk: "npm:^5.6.0"
    cli-boxes: "npm:^3.0.0"
    cli-cursor: "npm:^4.0.0"
-    cli-truncate: "npm:^4.0.0"
+    cli-truncate: "npm:^5.1.1"
    code-excerpt: "npm:^4.0.0"
-    es-toolkit: "npm:^1.22.0"
+    es-toolkit: "npm:^1.39.10"
    indent-string: "npm:^5.0.0"
-    is-in-ci: "npm:^1.0.0"
+    is-in-ci: "npm:^2.0.0"
    patch-console: "npm:^2.0.0"
-    react-reconciler: "npm:^0.29.0"
-    scheduler: "npm:^0.23.0"
+    react-reconciler: "npm:^0.33.0"
+    scheduler: "npm:^0.27.0"
    signal-exit: "npm:^3.0.7"
-    slice-ansi: "npm:^7.1.0"
+    slice-ansi: "npm:^8.0.0"
    stack-utils: "npm:^2.0.6"
-    string-width: "npm:^7.2.0"
-    type-fest: "npm:^4.27.0"
-    widest-line: "npm:^5.0.0"
+    string-width: "npm:^8.1.1"
+    terminal-size: "npm:^4.0.1"
+    type-fest: "npm:^5.4.1"
+    widest-line: "npm:^6.0.0"
    wrap-ansi: "npm:^9.0.0"
    ws: "npm:^8.18.0"
    yoga-layout: "npm:~3.2.1"
  peerDependencies:
-    "@types/react": ">=18.0.0"
-    react: ">=18.0.0"
-    react-devtools-core: ^4.19.1
+    "@types/react": ">=19.0.0"
+    react: ">=19.0.0"
+    react-devtools-core: ">=6.1.2"
  peerDependenciesMeta:
    "@types/react":
      optional: true
    react-devtools-core:
      optional: true
-  checksum: 10c0/0e2607712783353fbe99438ca4220db3d5874c7ae1a07e2b232f7539489b13a9db929b3046eedeccf318a3ffa222a572287dbe2307c848b8e7f6ec4bba39e550
+  checksum: 10c0/50500e547fdf6a1f1d836d6befbd4770e3ab649ef0be1884500a6da411fb68a90e22dd7dcc9c404911d30e9f87506b3b9d8e997c6c6ceac85ee054b4dadefaff
  languageName: node
  linkType: hard

@@ -4140,14 +4141,7 @@ __metadata:
  languageName: node
  linkType: hard

-"is-fullwidth-code-point@npm:^4.0.0":
-  version: 4.0.0
-  resolution: "is-fullwidth-code-point@npm:4.0.0"
-  checksum: 10c0/df2a717e813567db0f659c306d61f2f804d480752526886954a2a3e2246c7745fd07a52b5fecf2b68caf0a6c79dcdace6166fdf29cc76ed9975cc334f0a018b8
-  languageName: node
-  linkType: hard
-
-"is-fullwidth-code-point@npm:^5.0.0":
+"is-fullwidth-code-point@npm:^5.0.0, is-fullwidth-code-point@npm:^5.1.0":
  version: 5.1.0
  resolution: "is-fullwidth-code-point@npm:5.1.0"
  dependencies:
@@ -4165,12 +4159,12 @@ __metadata:
  languageName: node
  linkType: hard

-"is-in-ci@npm:^1.0.0":
-  version: 1.0.0
-  resolution: "is-in-ci@npm:1.0.0"
+"is-in-ci@npm:^2.0.0":
+  version: 2.0.0
+  resolution: "is-in-ci@npm:2.0.0"
  bin:
    is-in-ci: cli.js
-  checksum: 10c0/98f9cec4c35aece4cf731abf35ebf28359a9b0324fac810da05b842515d9ccb33b8999c1d9a679f0362e1a4df3292065c38d7f86327b1387fa667bc0150f4898
+  checksum: 10c0/1e1d1056939a681e8206035de5ad84e0404556eaa7622bb55f0f1868b9788bff3df427bc0b1ed5a172623154a90fcb1e759a230817cd73d09435543ae3c71feb
  languageName: node
  linkType: hard

@@ -5014,15 +5008,14 @@ __metadata:
  languageName: node
  linkType: hard

-"react-dom@npm:^18.2.0":
-  version: 18.3.1
-  resolution: "react-dom@npm:18.3.1"
+"react-dom@npm:^19.0.0":
+  version: 19.2.4
+  resolution: "react-dom@npm:19.2.4"
  dependencies:
-    loose-envify: "npm:^1.1.0"
-    scheduler: "npm:^0.23.2"
+    scheduler: "npm:^0.27.0"
  peerDependencies:
-    react: ^18.3.1
-  checksum: 10c0/a752496c1941f958f2e8ac56239172296fcddce1365ce45222d04a1947e0cc5547df3e8447f855a81d6d39f008d7c32eab43db3712077f09e3f67c4874973e85
+    react: ^19.2.4
+  checksum: 10c0/f0c63f1794dedb154136d4d0f59af00b41907f4859571c155940296808f4b94bf9c0c20633db75b5b2112ec13d8d7dd4f9bf57362ed48782f317b11d05a44f35
  languageName: node
  linkType: hard

@@ -5033,15 +5026,14 @@ __metadata:
  languageName: node
  linkType: hard

-"react-reconciler@npm:^0.29.0":
-  version: 0.29.2
-  resolution: "react-reconciler@npm:0.29.2"
+"react-reconciler@npm:^0.33.0":
+  version: 0.33.0
+  resolution: "react-reconciler@npm:0.33.0"
  dependencies:
-    loose-envify: "npm:^1.1.0"
-    scheduler: "npm:^0.23.2"
+    scheduler: "npm:^0.27.0"
  peerDependencies:
-    react: ^18.3.1
-  checksum: 10c0/94f48ddc348a974256cf13c859f5a94efdb0cd72e04c51b1a4d5c72a8b960ccd35df2196057ee6a4cbcb26145e12b01e3f9ba3b183fddb901414db36a07cbf43
+    react: ^19.2.0
+  checksum: 10c0/3f7b27ea8d0ff4c8bf0e402a285e1af9b7d0e6f4c1a70a28f4384938bc1130bc82a90a31df0b79ef5e380e2e55e2598bd90b4dbf802b1203d735ba0355817d3a
  languageName: node
  linkType: hard

@@ -5054,6 +5046,13 @@ __metadata:
  languageName: node
  linkType: hard

+"react@npm:^19.0.0":
+  version: 19.2.4
+  resolution: "react@npm:19.2.4"
+  checksum: 10c0/cd2c9ff67a720799cc3b38a516009986f7fc4cb8d3e15716c6211cf098d1357ee3e348ab05ad0600042bbb0fd888530ba92e329198c92eafa0994f5213396596
+  languageName: node
+  linkType: hard
+
 "readdirp@npm:^4.0.1":
  version: 4.1.2
  resolution: "readdirp@npm:4.1.2"
@@ -5298,12 +5297,10 @@ __metadata:
  languageName: node
  linkType: hard

-"scheduler@npm:^0.23.0, scheduler@npm:^0.23.2":
-  version: 0.23.2
-  resolution: "scheduler@npm:0.23.2"
-  dependencies:
-    loose-envify: "npm:^1.1.0"
-  checksum: 10c0/26383305e249651d4c58e6705d5f8425f153211aef95f15161c151f7b8de885f24751b377e4a0b3dd42cce09aad3f87a61dab7636859c0d89b7daf1a1e2a5c78
+"scheduler@npm:^0.27.0":
+  version: 0.27.0
+  resolution: "scheduler@npm:0.27.0"
+  checksum: 10c0/4f03048cb05a3c8fddc45813052251eca00688f413a3cee236d984a161da28db28ba71bd11e7a3dd02f7af84ab28d39fb311431d3b3772fed557945beb00c452
  languageName: node
  linkType: hard

@@ -5406,23 +5403,13 @@ __metadata:
  languageName: node
  linkType: hard

-"slice-ansi@npm:^5.0.0":
-  version: 5.0.0
-  resolution: "slice-ansi@npm:5.0.0"
+"slice-ansi@npm:^8.0.0":
+  version: 8.0.0
+  resolution: "slice-ansi@npm:8.0.0"
  dependencies:
-    ansi-styles: "npm:^6.0.0"
-    is-fullwidth-code-point: "npm:^4.0.0"
-  checksum: 10c0/2d4d40b2a9d5cf4e8caae3f698fe24ae31a4d778701724f578e984dcb485ec8c49f0c04dab59c401821e80fcdfe89cace9c66693b0244e40ec485d72e543914f
-  languageName: node
-  linkType: hard
-
-"slice-ansi@npm:^7.1.0":
-  version: 7.1.2
-  resolution: "slice-ansi@npm:7.1.2"
-  dependencies:
-    ansi-styles: "npm:^6.2.1"
-    is-fullwidth-code-point: "npm:^5.0.0"
-  checksum: 10c0/36742f2eb0c03e2e81a38ed14d13a64f7b732fe38c3faf96cce0599788a345011e840db35f1430ca606ea3f8db2abeb92a8d25c2753a819e3babaa10c2e289a2
+    ansi-styles: "npm:^6.2.3"
+    is-fullwidth-code-point: "npm:^5.1.0"
+  checksum: 10c0/0ce4aa91febb7cea4a00c2c27bb820fa53b6d2862ce0f80f7120134719f7914fc416b0ed966cf35250a3169e152916392f35917a2d7cad0fcc5d8b841010fa9a
  languageName: node
  linkType: hard

@@ -5532,7 +5519,7 @@ __metadata:
  languageName: node
  linkType: hard

-"string-width@npm:^7.0.0, string-width@npm:^7.2.0":
+"string-width@npm:^7.0.0":
  version: 7.2.0
  resolution: "string-width@npm:7.2.0"
  dependencies:
@@ -5543,6 +5530,16 @@ __metadata:
  languageName: node
  linkType: hard

+"string-width@npm:^8.1.0, string-width@npm:^8.1.1, string-width@npm:^8.2.0":
+  version: 8.2.0
+  resolution: "string-width@npm:8.2.0"
+  dependencies:
+    get-east-asian-width: "npm:^1.5.0"
+    strip-ansi: "npm:^7.1.2"
+  checksum: 10c0/d8915428b43519b0f494da6590dbe4491857d8a12e40250e50fc01fbb616ffd8400a436bbe25712255ee129511fe0414c49d3b6b9627e2bc3a33dcec1d2eda02
+  languageName: node
+  linkType: hard
+
 "strip-ansi@npm:^3.0.0, strip-ansi@npm:^3.0.1":
  version: 3.0.1
  resolution: "strip-ansi@npm:3.0.1"
@@ -5570,7 +5567,7 @@ __metadata:
  languageName: node
  linkType: hard

-"strip-ansi@npm:^7.1.0":
+"strip-ansi@npm:^7.1.0, strip-ansi@npm:^7.1.2":
  version: 7.2.0
  resolution: "strip-ansi@npm:7.2.0"
  dependencies:
@@ -5640,6 +5637,13 @@ __metadata:
  languageName: node
  linkType: hard

+"tagged-tag@npm:^1.0.0":
+  version: 1.0.0
+  resolution: "tagged-tag@npm:1.0.0"
+  checksum: 10c0/91d25c9ffb86a91f20522cefb2cbec9b64caa1febe27ad0df52f08993ff60888022d771e868e6416cf2e72dab68449d2139e8709ba009b74c6c7ecd4000048d1
+  languageName: node
+  linkType: hard
+
 "tar@npm:^7.5.4":
  version: 7.5.11
  resolution: "tar@npm:7.5.11"
@@ -5653,6 +5657,13 @@ __metadata:
  languageName: node
  linkType: hard

+"terminal-size@npm:^4.0.1":
+  version: 4.0.1
+  resolution: "terminal-size@npm:4.0.1"
+  checksum: 10c0/89afd9d816dd9dbfe4499da9aeea70491bbde4ff4592226a9c8ac71074a7580afead6a78e95ecc35f6d42e09087b55ffcb1019302cd55e0cc957b6ce5c4847e8
+  languageName: node
+  linkType: hard
+
 "tinybench@npm:^2.9.0":
  version: 2.9.0
  resolution: "tinybench@npm:2.9.0"
@@ -5751,20 +5762,21 @@ __metadata:
  languageName: node
  linkType: hard

-"twenty-client-sdk@portal:../../twenty-client-sdk::locator=hello-world%40workspace%3A.":
-  version: 0.0.0-use.local
-  resolution: "twenty-client-sdk@portal:../../twenty-client-sdk::locator=hello-world%40workspace%3A."
+"twenty-client-sdk@npm:0.8.0-canary.5":
+  version: 0.8.0-canary.5
+  resolution: "twenty-client-sdk@npm:0.8.0-canary.5"
  dependencies:
    "@genql/cli": "npm:^3.0.3"
    "@genql/runtime": "npm:^2.10.0"
    esbuild: "npm:^0.25.0"
    graphql: "npm:^16.8.1"
+  checksum: 10c0/754b92b732c8e03c9779f6557324710afe4c07f7e6efbe766bd8ff3b6dd8a00c0d9f3fecce2098d68ef9556cafa722b2189e490473e420fdb9cf30c56beb3619
  languageName: node
-  linkType: soft
+  linkType: hard

-"twenty-sdk@portal:../../twenty-sdk::locator=hello-world%40workspace%3A.":
-  version: 0.0.0-use.local
-  resolution: "twenty-sdk@portal:../../twenty-sdk::locator=hello-world%40workspace%3A."
+"twenty-sdk@npm:0.8.0-canary.5":
+  version: 0.8.0-canary.5
+  resolution: "twenty-sdk@npm:0.8.0-canary.5"
  dependencies:
    "@chakra-ui/react": "npm:^3.33.0"
    "@emotion/react": "npm:^11.14.0"
@@ -5782,13 +5794,14 @@ __metadata:
    esbuild: "npm:^0.25.0"
    graphql: "npm:^16.8.1"
    graphql-sse: "npm:^2.5.4"
-    ink: "npm:^5.1.1"
+    ink: "npm:^6.8.0"
    inquirer: "npm:^10.0.0"
    jsonc-parser: "npm:^3.2.0"
    preact: "npm:^10.28.3"
-    react: "npm:^18.2.0"
-    react-dom: "npm:^18.2.0"
+    react: "npm:^19.0.0"
+    react-dom: "npm:^19.0.0"
    tinyglobby: "npm:^0.2.15"
+    twenty-client-sdk: "npm:0.8.0-canary.5"
    typescript: "npm:^5.9.2"
    uuid: "npm:^13.0.0"
    vite: "npm:^7.0.0"
@@ -5796,8 +5809,9 @@ __metadata:
    zod: "npm:^4.1.11"
  bin:
    twenty: dist/cli.cjs
+  checksum: 10c0/47d0970c88f59c092e8eca34dca38bf88d9d52678997349068ca8a8e5cebed2ea71dbd4e8b7299f40b99b5419d4cecd53b31f821b65959267e8d97eb91d2ddde
  languageName: node
-  linkType: soft
+  linkType: hard

 "type-fest@npm:^0.21.3":
  version: 0.21.3
@@ -5806,10 +5820,12 @@ __metadata:
  languageName: node
  linkType: hard

-"type-fest@npm:^4.27.0":
-  version: 4.41.0
-  resolution: "type-fest@npm:4.41.0"
-  checksum: 10c0/f5ca697797ed5e88d33ac8f1fec21921839871f808dc59345c9cf67345bfb958ce41bd821165dbf3ae591cedec2bf6fe8882098dfdd8dc54320b859711a2c1e4
+"type-fest@npm:^5.4.1":
+  version: 5.5.0
+  resolution: "type-fest@npm:5.5.0"
+  dependencies:
+    tagged-tag: "npm:^1.0.0"
+  checksum: 10c0/60bf79a8df45abf99490e3204eceb5cf7f915413f8a69fb578c75cab37ddcb7d29ee21f185f0e1617323ac0b2a441e001b8dc691e220d0b087e9c29ea205538c
  languageName: node
  linkType: hard

@@ -6123,12 +6139,12 @@ __metadata:
  languageName: node
  linkType: hard

-"widest-line@npm:^5.0.0":
-  version: 5.0.0
-  resolution: "widest-line@npm:5.0.0"
+"widest-line@npm:^6.0.0":
+  version: 6.0.0
+  resolution: "widest-line@npm:6.0.0"
  dependencies:
-    string-width: "npm:^7.0.0"
-  checksum: 10c0/6bd6cca8cda502ef50e05353fd25de0df8c704ffc43ada7e0a9cf9a5d4f4e12520485d80e0b77cec8a21f6c3909042fcf732aa9281e5dbb98cc9384a138b2578
+    string-width: "npm:^8.1.0"
+  checksum: 10c0/735f1fdcd97fe765a07bb8b5e73c020bed8e53ab34e83ce0ef01693ba3c914d9e7977fe5f5facf0d0b670297a82dd5e376d3efa0896860dfcdaf7cd6924c0fb7
  languageName: node
  linkType: hard

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+env:
+  TWENTY_VERSION: latest
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Spawn Twenty instance
+        id: twenty
+        uses: twentyhq/twenty/.github/actions/spawn-twenty-docker-image@main
+        with:
+          twenty-version: ${{ env.TWENTY_VERSION }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Run integration tests
+        run: yarn test
+        env:
+          TWENTY_API_URL: ${{ steps.twenty.outputs.server-url }}
+          TWENTY_API_KEY: ${{ steps.twenty.outputs.access-token }}
@@ -0,0 +1,38 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn
+
+# codegen
+generated
+
+# testing
+/coverage
+
+# dev
+/dist/
+
+.twenty
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# typescript
+*.tsbuildinfo
+*.d.ts
@@ -0,0 +1 @@
+24.5.0
@@ -0,0 +1,19 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript"],
+  "categories": {
+    "correctness": "off"
+  },
+  "ignorePatterns": ["node_modules", "dist"],
+  "rules": {
+    "no-unused-vars": "off",
+
+    "typescript/no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_"
+      }
+    ],
+    "typescript/no-explicit-any": "off"
+  }
+}
@@ -0,0 +1 @@
+nodeLinker: node-modules
@@ -0,0 +1,14 @@
+## Base documentation
+
+- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
+
+## UUID requirement
+
+- All generated UUIDs must be valid UUID v4.
+
+## Common Pitfalls
+
+- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
+- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
+- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -0,0 +1,14 @@
+## Base documentation
+
+- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
+
+## UUID requirement
+
+- All generated UUIDs must be valid UUID v4.
+
+## Common Pitfalls
+
+- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
+- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
+- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -0,0 +1,14 @@
+## Base documentation
+
+- Documentation: https://docs.twenty.com/developers/extend/apps/getting-started
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/fixtures/rich-app
+
+## UUID requirement
+
+- All generated UUIDs must be valid UUID v4.
+
+## Common Pitfalls
+
+- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
+- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
+- Creating a front-end component that has a scroll instead of being responsive to its fixed widget height and width, unless it is specifically meant to be used in a canvas tab.
@@ -0,0 +1,42 @@
+# Postcard App — Twenty App Example
+
+A rich example app showcasing all Twenty app entity types. Use this as a reference when building your own apps.
+
+## What's included
+
+This app demonstrates every entity type available in the Twenty SDK:
+
+| Entity | Files | What it shows |
+|--------|-------|---------------|
+| **Application** | `src/application.config.ts` | App metadata, application variables, server variables |
+| **Objects** | `src/objects/` | Custom objects with inline fields, junction tables |
+| **Fields** | `src/fields/` | Standalone fields, relations (ONE_TO_MANY, MANY_TO_ONE), extending standard objects |
+| **Logic Functions** | `src/logic-functions/` | HTTP routes, database event triggers, cron schedules, tool functions, install hooks |
+| **Front Components** | `src/components/` | React components rendered inside Twenty's UI |
+| **Roles** | `src/roles/` | Permission roles with object and field-level access control |
+| **Views** | `src/views/` | Saved table views with column configuration |
+| **Navigation** | `src/navigation-menu-items/` | Sidebar links targeting views |
+| **Skills** | `src/skills/` | AI skill providing context to agents |
+| **Agents** | `src/agents/` | AI agent with a system prompt |
+| **Page Layouts** | `src/page-layouts/` | Custom record page with a front component widget |
+
+## Getting started
+
+```bash
+# From this directory
+yarn install
+yarn twenty dev
+```
+
+Or use it as a template via create-twenty-app:
+
+```bash
+npx create-twenty-app@latest my-app --example postcard
+```
+
+## Learn more
+
+- [Getting Started](https://docs.twenty.com/developers/extend/apps/getting-started)
+- [Building Apps](https://docs.twenty.com/developers/extend/apps/building)
+- [Publishing](https://docs.twenty.com/developers/extend/apps/publishing)
+- [Discord](https://discord.gg/cx5n4Jzs57)
@@ -0,0 +1,35 @@
+{
+  "name": "postcard",
+  "version": "0.1.0",
+  "license": "MIT",
+  "engines": {
+    "node": "^24.5.0",
+    "npm": "please-use-yarn",
+    "yarn": ">=4.0.2"
+  },
+  "keywords": [
+    "twenty-app"
+  ],
+  "packageManager": "yarn@4.9.2",
+  "scripts": {
+    "twenty": "twenty",
+    "lint": "oxlint -c .oxlintrc.json .",
+    "lint:fix": "oxlint --fix -c .oxlintrc.json .",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "twenty-client-sdk": "0.8.0-canary.8",
+    "twenty-sdk": "0.8.0-canary.8"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "@types/react": "^19.0.0",
+    "oxlint": "^0.16.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^4.2.1",
+    "vitest": "^3.1.1"
+  }
+}
@@ -0,0 +1,70 @@
+import { APPLICATION_UNIVERSAL_IDENTIFIER } from 'src/application.config';
+import { appBuild, appDeploy, appInstall, appUninstall } from 'twenty-sdk/cli';
+import { MetadataApiClient } from 'twenty-client-sdk/metadata';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+
+const APP_PATH = process.cwd();
+
+describe('App installation', () => {
+  beforeAll(async () => {
+    const buildResult = await appBuild({
+      appPath: APP_PATH,
+      tarball: true,
+      onProgress: (message: string) => console.log(`[build] ${message}`),
+    });
+
+    if (!buildResult.success) {
+      throw new Error(
+        `Build failed: ${buildResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+
+    const deployResult = await appDeploy({
+      tarballPath: buildResult.data.tarballPath!,
+      onProgress: (message: string) => console.log(`[deploy] ${message}`),
+    });
+
+    if (!deployResult.success) {
+      throw new Error(
+        `Deploy failed: ${deployResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+
+    const installResult = await appInstall({ appPath: APP_PATH });
+
+    if (!installResult.success) {
+      throw new Error(
+        `Install failed: ${installResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+  });
+
+  afterAll(async () => {
+    const uninstallResult = await appUninstall({ appPath: APP_PATH });
+
+    if (!uninstallResult.success) {
+      console.warn(
+        `App uninstall failed: ${uninstallResult.error?.message ?? 'Unknown error'}`,
+      );
+    }
+  });
+
+  it('should find the installed app in the applications list', async () => {
+    const metadataClient = new MetadataApiClient();
+
+    const result = await metadataClient.query({
+      findManyApplications: {
+        id: true,
+        name: true,
+        universalIdentifier: true,
+      },
+    });
+
+    const installedApp = result.findManyApplications.find(
+      (application: { universalIdentifier: string }) =>
+        application.universalIdentifier === APPLICATION_UNIVERSAL_IDENTIFIER,
+    );
+
+    expect(installedApp).toBeDefined();
+  });
+});
@@ -0,0 +1,45 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { beforeAll } from 'vitest';
+
+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';
+const TEST_CONFIG_DIR = path.join(os.tmpdir(), '.twenty-sdk-test');
+
+const assertServerIsReachable = async () => {
+  let response: Response;
+
+  try {
+    response = await fetch(`${TWENTY_API_URL}/healthz`);
+  } catch {
+    throw new Error(
+      `Twenty server is not reachable at ${TWENTY_API_URL}. ` +
+        'Make sure the server is running before executing integration tests.',
+    );
+  }
+
+  if (!response.ok) {
+    throw new Error(`Server at ${TWENTY_API_URL} returned ${response.status}`);
+  }
+};
+
+beforeAll(async () => {
+  await assertServerIsReachable();
+
+  fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });
+
+  const configFile = {
+    remotes: {
+      local: {
+        apiUrl: process.env.TWENTY_API_URL,
+        apiKey: process.env.TWENTY_API_KEY,
+      },
+    },
+    defaultRemote: 'local',
+  };
+
+  fs.writeFileSync(
+    path.join(TEST_CONFIG_DIR, 'config.json'),
+    JSON.stringify(configFile, null, 2),
+  );
+});
@@ -0,0 +1,13 @@
+import { defineAgent } from 'twenty-sdk';
+
+export default defineAgent({
+  universalIdentifier: 'b8d4f2a3-9c5e-4f7b-a012-3e4d5c6b7a8f',
+  name: 'postcard-drafter',
+  label: 'Postcard Drafter',
+  icon: 'IconRobot',
+  description: 'Helps draft postcard messages',
+  prompt:
+    'You are a postcard writing assistant. Help users draft concise, warm ' +
+    'postcard messages. Follow the postcard writing guidelines. Ask for the ' +
+    'recipient name and the occasion if not provided.',
+});
@@ -0,0 +1,33 @@
+import { defineApplication } from 'twenty-sdk';
+import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from './roles/default-function.role';
+
+export const APPLICATION_UNIVERSAL_IDENTIFIER =
+  '8b2df3cc-23ad-4e1b-87fd-f880d4cefd58';
+
+export default defineApplication({
+  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
+  displayName: 'Postcard App',
+  description: 'Send postcards easily with Twenty',
+  icon: 'IconWorld',
+  applicationVariables: {
+    DEFAULT_RECIPIENT_NAME: {
+      universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',
+      description: 'Default recipient name for postcards',
+      value: 'Alex Karp',
+      isSecret: false,
+    },
+  },
+  serverVariables: {
+    POSTCARD_API_KEY: {
+      description: 'API key for the postcard printing service',
+      isSecret: true,
+      isRequired: true,
+    },
+    POSTCARD_SENDER_NAME: {
+      description: 'Default sender name on postcards',
+      isSecret: false,
+      isRequired: false,
+    },
+  },
+  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+});
@@ -0,0 +1,189 @@
+import { useCallback, useEffect, useState } from 'react';
+import { defineFrontComponent, useRecordId } from 'twenty-sdk';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+import { isDefined } from 'twenty-shared/utils';
+
+export const CARD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER =
+  '88c15ae2-5f87-4a6b-b48f-1974bbe62eb7';
+
+type PostCardRecord = {
+  name: string;
+  content: string;
+  status: string;
+};
+
+const STATUS_COLORS: Record<string, string> = {
+  DRAFT: '#999',
+  SENT: '#e88c30',
+  DELIVERED: '#4caf50',
+  RETURNED: '#e05252',
+};
+
+const CardDisplay = ({
+  name,
+  content,
+  status,
+}: {
+  name: string;
+  content: string;
+  status: string;
+}) => {
+  return (
+    <div style={{ padding: '24px', fontFamily: 'sans-serif' }}>
+      <div
+        style={{
+          display: 'flex',
+          alignItems: 'center',
+          gap: '8px',
+          marginBottom: '16px',
+        }}
+      >
+        <span style={{ fontSize: '15px', fontWeight: 600, color: '#333' }}>
+          {name || 'Untitled'}
+        </span>
+        <span
+          style={{
+            fontSize: '11px',
+            fontWeight: 600,
+            padding: '2px 8px',
+            borderRadius: '4px',
+            color: '#fff',
+            backgroundColor: STATUS_COLORS[status] ?? '#999',
+          }}
+        >
+          {status}
+        </span>
+      </div>
+
+      <p
+        style={{
+          fontSize: '14px',
+          lineHeight: '1.6',
+          color: '#555',
+          margin: 0,
+          whiteSpace: 'pre-line',
+        }}
+      >
+        {content || 'No content yet...'}
+      </p>
+    </div>
+  );
+};
+
+const PostCardPreview = () => {
+  const recordId = useRecordId();
+  const [postCard, setPostCard] = useState<PostCardRecord | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchPostCard = useCallback(async () => {
+    if (!isDefined(recordId)) {
+      setLoading(false);
+      setError('No record ID');
+      return;
+    }
+
+    try {
+      setError(null);
+      const client = new CoreApiClient();
+
+      const result = await client.query({
+        postCard: {
+          __args: {
+            filter: { id: { eq: recordId } },
+          },
+          name: true,
+          content: true,
+          status: true,
+        },
+      });
+
+      const record = result?.postCard;
+
+      if (!isDefined(record)) {
+        setError('Record not found');
+        setPostCard(null);
+      } else {
+        setPostCard({
+          name: record.name ?? '',
+          content: record.content ?? '',
+          status: record.status ?? 'DRAFT',
+        });
+      }
+    } catch (fetchError) {
+      setError(
+        fetchError instanceof Error ? fetchError.message : String(fetchError),
+      );
+      setPostCard(null);
+    }
+    setLoading(false);
+  }, [recordId]);
+
+  useEffect(() => {
+    fetchPostCard();
+
+    const interval = setInterval(fetchPostCard, 3000);
+
+    return () => {
+      clearInterval(interval);
+      setPostCard(null);
+      setLoading(false);
+      setError(null);
+    };
+  }, [fetchPostCard]);
+
+  if (loading) {
+    return (
+      <div
+        style={{
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          height: '100%',
+          color: '#b0a89a',
+          fontFamily: 'Georgia, serif',
+          fontSize: '14px',
+        }}
+      >
+        Loading postcard...
+      </div>
+    );
+  }
+
+  if (!isDefined(postCard)) {
+    return (
+      <div
+        style={{
+          padding: '16px',
+          color: '#b0a89a',
+          fontFamily: 'sans-serif',
+          fontSize: '13px',
+        }}
+      >
+        <div>{error ?? 'No postcard data'}</div>
+        <div style={{ marginTop: '8px', fontSize: '11px', color: '#ccc' }}>
+          recordId: {recordId ?? 'null'} | apiUrl:{' '}
+          {process.env.TWENTY_API_URL ? 'set' : 'missing'} | token:{' '}
+          {process.env.TWENTY_APP_ACCESS_TOKEN ?? process.env.TWENTY_API_KEY
+            ? 'set'
+            : 'missing'}
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <CardDisplay
+      name={postCard.name}
+      content={postCard.content}
+      status={postCard.status}
+    />
+  );
+};
+
+export default defineFrontComponent({
+  universalIdentifier: CARD_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,
+  name: 'card-component',
+  description: 'A component using an external component file',
+  component: PostCardPreview,
+});
@@ -0,0 +1,125 @@
+import { useEffect } from 'react';
+import {
+  defineFrontComponent,
+  useRecordId,
+  updateProgress,
+  enqueueSnackbar,
+  unmountFrontComponent,
+} from 'twenty-sdk';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+import { isDefined } from 'twenty-shared/utils';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+
+const SYSTEM_PROMPT =
+  'You are a postcard writing assistant. Write a short, warm postcard message ' +
+  'under 150 words. Use a personal tone. Output ONLY the postcard message ' +
+  'text, nothing else — no greeting label, no sign-off label, just the message.';
+
+const GeneratePostCardEffect = () => {
+  const recordId = useRecordId();
+
+  useEffect(() => {
+    if (!isDefined(recordId)) {
+      enqueueSnackbar({
+        message: 'No record selected',
+        variant: 'error',
+      });
+      unmountFrontComponent();
+      return;
+    }
+
+    const generate = async () => {
+      try {
+        const client = new CoreApiClient();
+
+        const userPrompt = 'Write a postcard message for a friend.';
+
+        const apiBaseUrl = process.env.TWENTY_API_URL;
+        const token =
+          process.env.TWENTY_APP_ACCESS_TOKEN ?? process.env.TWENTY_API_KEY;
+
+        if (!apiBaseUrl || !token) {
+          throw new Error('API configuration missing');
+        }
+
+        const response = await fetch(`${apiBaseUrl}/rest/ai/generate-text`, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+          },
+          body: JSON.stringify({
+            systemPrompt: SYSTEM_PROMPT,
+            userPrompt,
+          }),
+        });
+
+        if (!response.ok) {
+          const errorBody = await response.text();
+
+          if (errorBody.includes('No AI models are available')) {
+            throw new Error(
+              'No AI models configured. Go to Settings > Admin Panel > AI to add a provider API key.',
+            );
+          }
+
+          throw new Error(`AI request failed with status ${response.status}`);
+        }
+
+        const data = (await response.json()) as { text?: string };
+        const generatedContent = data.text ?? '';
+
+        await updateProgress(0.7);
+
+        await client.mutation({
+          updatePostCard: {
+            __args: {
+              id: recordId,
+              data: { content: generatedContent },
+            },
+            id: true,
+          },
+        });
+
+        await updateProgress(1);
+
+        await enqueueSnackbar({
+          message: 'Post card content generated!',
+          variant: 'success',
+        });
+
+        await unmountFrontComponent();
+      } catch (error) {
+        await enqueueSnackbar({
+          message:
+            error instanceof Error
+              ? error.message
+              : 'Failed to generate content',
+          variant: 'error',
+        });
+        await unmountFrontComponent();
+      }
+    };
+
+    generate();
+  }, [recordId]);
+
+  return null;
+};
+
+export default defineFrontComponent({
+  universalIdentifier: 'bd7649c0-7540-4267-ac4b-f062fbd635a3',
+  name: 'Generate Post Card',
+  description: 'Generates postcard content using AI',
+  isHeadless: true,
+  component: GeneratePostCardEffect,
+  command: {
+    universalIdentifier: '0f795c1c-8e25-44da-8962-80bef9602ee2',
+    label: 'Generate post card content',
+    shortLabel: 'Generate content',
+    icon: 'IconSparkles',
+    isPinned: true,
+    availabilityType: 'RECORD_SELECTION',
+    availabilityObjectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+  },
+});
@@ -0,0 +1,102 @@
+import { useEffect } from 'react';
+import {
+  defineFrontComponent,
+  useRecordId,
+  updateProgress,
+  enqueueSnackbar,
+  unmountFrontComponent,
+} from 'twenty-sdk';
+import { CoreApiClient } from 'twenty-client-sdk/core';
+import { isDefined } from 'twenty-shared/utils';
+import { POST_CARD_UNIVERSAL_IDENTIFIER } from '../objects/post-card.object';
+
+const SendPostCardsEffect = () => {
+  const recordId = useRecordId();
+
+  useEffect(() => {
+    const send = async () => {
+      try {
+        await updateProgress(0.1);
+        const client = new CoreApiClient();
+
+        let idsToSend: string[] = [];
+
+        if (isDefined(recordId)) {
+          idsToSend = [recordId];
+        } else {
+          const { postCards } = await client.query({
+            postCards: {
+              __args: {
+                filter: { status: { eq: 'DRAFT' } },
+              },
+              edges: { node: { id: true } },
+            },
+          });
+
+          idsToSend =
+            postCards?.edges?.map(
+              (edge: { node: { id: string; status: true } }) => edge.node.id,
+            ) ?? [];
+        }
+
+        if (idsToSend.length === 0) {
+          await updateProgress(1);
+          await unmountFrontComponent();
+          return;
+        }
+
+        await updateProgress(0.3);
+
+        for (let i = 0; i < idsToSend.length; i++) {
+          await client.mutation({
+            updatePostCard: {
+              __args: {
+                id: idsToSend[i],
+                data: { status: 'SENT' },
+              },
+              id: true,
+            },
+          });
+
+          await updateProgress(0.3 + (0.7 * (i + 1)) / idsToSend.length);
+        }
+
+        const count = idsToSend.length;
+
+        await enqueueSnackbar({
+          message: `${count} postcard${count > 1 ? 's' : ''} sent`,
+          variant: 'success',
+        });
+
+        await unmountFrontComponent();
+      } catch (error) {
+        const message =
+          error instanceof Error ? error.message : 'Failed to send postcards';
+
+        await enqueueSnackbar({ message, variant: 'error' });
+        await unmountFrontComponent();
+      }
+    };
+
+    send();
+  }, [recordId]);
+
+  return null;
+};
+
+export default defineFrontComponent({
+  universalIdentifier: 'a3b7c2d1-4e5f-4a8b-9c0d-1e2f3a4b5c6d',
+  name: 'Send Post Cards',
+  description: 'Sets postcard status to Sent',
+  isHeadless: true,
+  component: SendPostCardsEffect,
+  command: {
+    universalIdentifier: 'bd75de13-87a1-4f7a-94e2-92e19e97523c',
+    label: 'Send post cards',
+    shortLabel: 'Send',
+    icon: 'IconSend',
+    isPinned: true,
+    availabilityType: 'RECORD_SELECTION',
+    availabilityObjectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
+  },
+});
--- a/Show More
+++ b/Show More