fix(billing): gate AI credit-cap at entry points instead of workflow executor

Restores the credit-cap enforcement that was lifted in #19904 (which had
correctly identified that gating per-workflow-step was too coarse), but
moves it to the AI entry points where the actual cost lives.

- agent-async-executor.service: gate executeAgent.
- ai-generate-text.controller: gate the REST handler.
- agent-title-generation.service: gate generateThreadTitle.
- workflow-executor.workspace-service: replace #19904's TODO with an
  absolute-behavior comment documenting why the gate is not here.

Chat resolver was already gated; no change there. Repair-tool-call util
is a sub-call inside an already-gated flow and is left ungated.

Net effect: a workspace that exhausts credits via chat or AI agent stops
making AI calls, but its non-AI workflows (DB CRUD, branching, action
steps) continue running normally.

Addresses the root cause of the 2026-04-26 token-usage incident.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.claude-pr/.mcp.json

@@ -0,0 +1,22 @@
+{
+  "mcpServers": {
+    "postgres": {
+      "type": "stdio",
+      "command": "bash",
+      "args": ["-c", "source packages/twenty-server/.env && npx -y @modelcontextprotocol/server-postgres \"$PG_DATABASE_URL\""],
+      "env": {}
+    },
+    "playwright": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@playwright/mcp@latest", "--no-sandbox", "--headless"],
+      "env": {}
+    },
+    "context7": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"],
+      "env": {}
+    }
+  }
+}

.claude-pr/CLAUDE.md

@@ -0,0 +1,223 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Twenty is an open-source CRM built with modern technologies in a monorepo structure. The codebase is organized as an Nx workspace with multiple packages.
+
+## Key Commands
+
+### Development
+```bash
+# Start development environment (frontend + backend + worker)
+yarn start
+
+# Individual package development
+npx nx start twenty-front     # Start frontend dev server
+npx nx start twenty-server    # Start backend server
+npx nx run twenty-server:worker  # Start background worker
+```
+
+### Testing
+```bash
+# Preferred: run a single test file (fast)
+npx jest path/to/test.test.ts --config=packages/PROJECT/jest.config.mjs
+
+# Run all tests for a package
+npx nx test twenty-front      # Frontend unit tests
+npx nx test twenty-server     # Backend unit tests
+npx nx run twenty-server:test:integration:with-db-reset  # Integration tests with DB reset
+# To run an indivual test or a pattern of tests, use the following command:
+cd packages/{workspace} && npx jest "pattern or filename"
+
+# Storybook
+npx nx storybook:build twenty-front
+npx nx storybook:test twenty-front
+
+# When testing the UI end to end, click on "Continue with Email" and use the prefilled credentials.
+```
+
+### Code Quality
+```bash
+# Linting (diff with main - fastest, always prefer this)
+npx nx lint:diff-with-main twenty-front
+npx nx lint:diff-with-main twenty-server
+npx nx lint:diff-with-main twenty-front --configuration=fix  # Auto-fix
+
+# Linting (full project - slower, use only when needed)
+npx nx lint twenty-front
+npx nx lint twenty-server
+
+# Type checking
+npx nx typecheck twenty-front
+npx nx typecheck twenty-server
+
+# Format code
+npx nx fmt twenty-front
+npx nx fmt twenty-server
+```
+
+### Build
+```bash
+# Build packages (twenty-shared must be built first)
+npx nx build twenty-shared
+npx nx build twenty-front
+npx nx build twenty-server
+```
+
+### Database Operations
+```bash
+# Database management
+npx nx database:reset twenty-server         # Reset database
+npx nx run twenty-server:database:init:prod # Initialize database
+npx nx run twenty-server:database:migrate:prod # Run instance commands (fast only)
+
+# Generate an instance command (fast or slow)
+npx nx run twenty-server:database:migrate:generate --name <name> --type <fast|slow>
+```
+
+### Database Inspection (Postgres MCP)
+
+A read-only Postgres MCP server is configured in `.mcp.json`. Use it to:
+- Inspect workspace data, metadata, and object definitions while developing
+- Verify migration results (columns, types, constraints) after running migrations
+- Explore the multi-tenant schema structure (core, metadata, workspace-specific schemas)
+- Debug issues by querying raw data to confirm whether a bug is frontend, backend, or data-level
+- Inspect metadata tables to debug GraphQL schema generation issues
+
+This server is read-only — for write operations (reset, migrations, sync), use the CLI commands above.
+
+### GraphQL
+```bash
+# Generate GraphQL types (run after schema changes)
+npx nx run twenty-front:graphql:generate
+npx nx run twenty-front:graphql:generate --configuration=metadata
+```
+
+## Architecture Overview
+
+### Tech Stack
+- **Frontend**: React 18, TypeScript, Jotai (state management), Linaria (styling), Vite
+- **Backend**: NestJS, TypeORM, PostgreSQL, Redis, GraphQL (with GraphQL Yoga)
+- **Monorepo**: Nx workspace managed with Yarn 4
+
+### Package Structure
+```
+packages/
+├── twenty-front/          # React frontend application
+├── twenty-server/         # NestJS backend API
+├── twenty-ui/             # Shared UI components library
+├── twenty-shared/         # Common types and utilities
+├── twenty-emails/         # Email templates with React Email
+├── twenty-website/        # Next.js documentation website
+├── twenty-zapier/         # Zapier integration
+└── twenty-e2e-testing/    # Playwright E2E tests
+```
+
+### Key Development Principles
+- **Functional components only** (no class components)
+- **Named exports only** (no default exports)
+- **Types over interfaces** (except when extending third-party interfaces)
+- **String literals over enums** (except for GraphQL enums)
+- **No 'any' type allowed** — strict TypeScript enforced
+- **Event handlers preferred over useEffect** for state updates
+- **Props down, events up** — unidirectional data flow
+- **Composition over inheritance**
+- **No abbreviations** in variable names (`user` not `u`, `fieldMetadata` not `fm`)
+
+### Naming Conventions
+- **Variables/functions**: camelCase
+- **Constants**: SCREAMING_SNAKE_CASE
+- **Types/Classes**: PascalCase (suffix component props with `Props`, e.g. `ButtonProps`)
+- **Files/directories**: kebab-case with descriptive suffixes (`.component.tsx`, `.service.ts`, `.entity.ts`, `.dto.ts`, `.module.ts`)
+- **TypeScript generics**: descriptive names (`TData` not `T`)
+
+### File Structure
+- Components under 300 lines, services under 500 lines
+- Components in their own directories with tests and stories
+- Use `index.ts` barrel exports for clean imports
+- Import order: external libraries first, then internal (`@/`), then relative
+
+### Comments
+- Use short-form comments (`//`), not JSDoc blocks
+- Explain WHY (business logic), not WHAT
+- Do not comment obvious code
+- Multi-line comments use multiple `//` lines, not `/** */`
+
+### State Management
+- **Jotai** for global state: atoms for primitive state, selectors for derived state, atom families for dynamic collections
+- Component-specific state with React hooks (`useState`, `useReducer` for complex logic)
+- GraphQL cache managed by Apollo Client
+- Use functional state updates: `setState(prev => prev + 1)`
+
+### Backend Architecture
+- **NestJS modules** for feature organization
+- **TypeORM** for database ORM with PostgreSQL
+- **GraphQL** API with code-first approach
+- **Redis** for caching and session management
+- **BullMQ** for background job processing
+
+### Database & Upgrade Commands
+- **PostgreSQL** as primary database
+- **Redis** for caching and sessions
+- **ClickHouse** for analytics (when enabled)
+- When changing entity files, generate an **instance command** (`database:migrate:generate --name <name> --type <fast|slow>`)
+- **Fast** instance commands handle schema changes; **slow** ones add a `runDataMigration` step for data backfills
+- **Workspace commands** iterate over all active/suspended workspaces for per-workspace upgrades
+- Commands use `@RegisteredInstanceCommand` and `@RegisteredWorkspaceCommand` decorators for automatic discovery
+- Include both `up` and `down` logic in instance commands
+- Never delete or rewrite committed instance command `up`/`down` logic
+- See `packages/twenty-server/docs/UPGRADE_COMMANDS.md` for full documentation
+
+### Utility Helpers
+Use existing helpers from `twenty-shared` instead of manual type guards:
+- `isDefined()`, `isNonEmptyString()`, `isNonEmptyArray()`
+
+## Development Workflow
+
+IMPORTANT: Use Context7 for code generation, setup or configuration steps, or library/API documentation. Automatically use the Context7 MCP tools to resolve library IDs and get library docs without waiting for explicit requests.
+
+### Before Making Changes
+1. Always run linting (`lint:diff-with-main`) and type checking after code changes
+2. Test changes with relevant test suites (prefer single-file test runs)
+3. Ensure instance commands are generated for entity changes (`database:migrate:generate`)
+4. Check that GraphQL schema changes are backward compatible
+5. Run `graphql:generate` after any GraphQL schema changes
+
+### Code Style Notes
+- Use **Linaria** for styling with zero-runtime CSS-in-JS (styled-components pattern)
+- Follow **Nx** workspace conventions for imports
+- Use **Lingui** for internationalization
+- Apply security first, then formatting (sanitize before format)
+
+### Testing Strategy
+- **Test behavior, not implementation** — focus on user perspective
+- **Test pyramid**: 70% unit, 20% integration, 10% E2E
+- Query by user-visible elements (text, roles, labels) over test IDs
+- Use `@testing-library/user-event` for realistic interactions
+- Descriptive test names: "should [behavior] when [condition]"
+- Clear mocks between tests with `jest.clearAllMocks()`
+
+## Dev Environment Setup
+
+All dev environments (Claude Code web, Cursor, local) use one script:
+
+```bash
+bash packages/twenty-utils/setup-dev-env.sh
+```
+
+This handles everything: starts Postgres + Redis (auto-detects local services vs Docker), creates databases, and copies `.env` files. Idempotent — safe to run multiple times.
+
+- `--docker` — force Docker mode (uses `packages/twenty-docker/docker-compose.dev.yml`)
+- `--down` — stop services
+- `--reset` — wipe data and restart fresh
+- **Skip the setup script** for tasks that only read code — architecture questions, code review, documentation, etc.
+
+**Note:** CI workflows (GitHub Actions) manage services via Actions service containers and run setup steps individually — they don't use this script.
+
+## Important Files
+- `nx.json` - Nx workspace configuration with task definitions
+- `tsconfig.base.json` - Base TypeScript configuration
+- `package.json` - Root package with workspace definitions
+- `.cursor/rules/` - Detailed development guidelines and best practices

.cursor/rules/changelog-process.mdc

@@ -106,35 +106,34 @@ Replace `{VERSION}` with the actual version number (e.g., `1.9.0`)
 ### 2. Create File Structure
 
 **Create changelog file:**
-- Path: `packages/twenty-website-new/src/content/releases/{VERSION}.mdx`
-- Example: `packages/twenty-website-new/src/content/releases/1.9.0.mdx`
+- Path: `packages/twenty-website/src/content/releases/{VERSION}.mdx`
+- Example: `packages/twenty-website/src/content/releases/1.9.0.mdx`
 
 **Create image folder:**
-- Path: `packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/`
-- Example for version 1.9.0: `packages/twenty-website-new/public/images/releases/1.9/`
-- Example for version 2.0.0: `packages/twenty-website-new/public/images/releases/2.0/`
+- Path: `packages/twenty-website/public/images/releases/{MINOR_VERSION}/`
+- Example for version 1.9.0: `packages/twenty-website/public/images/releases/1.9/`
+- Example for version 2.0.0: `packages/twenty-website/public/images/releases/2.0/`
 
 ```bash
 # Create the image folder
-mkdir -p packages/twenty-website-new/public/images/releases/{MINOR_VERSION}
+mkdir -p packages/twenty-website/public/images/releases/{MINOR_VERSION}
 ```
 
 ### 3. Move Illustration Files
 
 **Source:** `/Users/thomascolasdesfrancs/Downloads/🆕`
 
-**Destination:** `packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/`
+**Destination:** `packages/twenty-website/public/images/releases/{MINOR_VERSION}/`
 
-**Naming Convention:** `{VERSION}-descriptive-name.webp`
+**Naming Convention:** `{VERSION}-descriptive-name.png`
 
 Examples:
-- `1.9.0-feature-name.webp`
-- `1.9.0-another-feature.webp`
+- `1.9.0-feature-name.png`
+- `1.9.0-another-feature.png`
 
 ```bash
-# Move and rename source files, then convert to webp if needed
-cp ~/Downloads/🆕/source-file.png packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-name.png
-cd packages/twenty-website-new && node scripts/convert-png-to-webp.mjs
+# Move and rename files
+cp ~/Downloads/🆕/source-file.png packages/twenty-website/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-name.png
 ```
 
 ### 4. Research Features (if needed)
@@ -159,19 +158,19 @@ Date: {YYYY-MM-DD}
 
 Short description explaining what the feature does and why it's useful. Keep it user-focused and concise (1-2 sentences).
 
-![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-1.webp)
+![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-1.png)
 
 # Feature 2 Name
 
 Another short description of the second feature.
 
-![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-2.webp)
+![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-2.png)
 
 # Feature 3 Name
 
 Description of the third feature.
 
-![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-3.webp)
+![](/images/releases/{MINOR_VERSION}/{VERSION}-feature-3.png)
 ```
 
 **Style Guidelines:**
@@ -183,7 +182,7 @@ Description of the third feature.
 - **NEVER mention the brand name "Twenty"** in changelog text - use "your workspace", "the platform", or similar neutral references instead
 
 **Reference Previous Changelogs:**
-- Check `packages/twenty-website-new/src/content/releases/` for examples
+- Check `packages/twenty-website/src/content/releases/` for examples
 - Recent releases: 1.7.0.mdx, 1.6.0.mdx, 1.5.0.mdx
 
 ### 6. Review
@@ -191,10 +190,10 @@ Description of the third feature.
 Open the changelog file for review:
 ```bash
 # Open in Cursor
-cursor packages/twenty-website-new/src/content/releases/{VERSION}.mdx
+cursor packages/twenty-website/src/content/releases/{VERSION}.mdx
 
 # Open image folder to verify illustrations
-open packages/twenty-website-new/public/images/releases/{MINOR_VERSION}
+open packages/twenty-website/public/images/releases/{MINOR_VERSION}
 ```
 
 Review checklist:
@@ -222,8 +221,8 @@ I've created the changelog for version {VERSION}. Here's the content for your re
 [Show full MDX content]
 
 Images moved to:
-- packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-1.webp
-- packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-2.webp
+- packages/twenty-website/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-1.png
+- packages/twenty-website/public/images/releases/{MINOR_VERSION}/{VERSION}-feature-2.png
 
 Please review the content. Once you approve, I'll commit the changes and create the pull request.
 ```
@@ -242,8 +241,8 @@ Possible user responses:
 git status
 
 # Add files
-git add packages/twenty-website-new/src/content/releases/{VERSION}.mdx
-git add packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/
+git add packages/twenty-website/src/content/releases/{VERSION}.mdx
+git add packages/twenty-website/public/images/releases/{MINOR_VERSION}/
 
 # Commit
 git commit -m "Add {VERSION} release changelog"
@@ -266,7 +265,7 @@ This release includes:
 - Feature 2
 - Feature 3
 
-Changelog file: \`packages/twenty-website-new/src/content/releases/{VERSION}.mdx\`
+Changelog file: \`packages/twenty-website/src/content/releases/{VERSION}.mdx\`
 Release date: {DATE}" \
   --base main \
   --head {VERSION}
@@ -280,21 +279,21 @@ Or visit: `https://github.com/twentyhq/twenty/pull/new/{VERSION}`
 - **Format**: `{MAJOR}.{MINOR}.{PATCH}.mdx`
 - **Convention**: One file per complete version
 - **Examples**: `1.6.0.mdx`, `1.7.0.mdx`, `2.0.0.mdx`
-- **Location**: `packages/twenty-website-new/src/content/releases/`
+- **Location**: `packages/twenty-website/src/content/releases/`
 
 ### Image Folders
 - **Format**: `{MAJOR}.{MINOR}/`
 - **Convention**: One folder per minor version (shared across patches)
 - **Examples**: `1.6/`, `1.7/`, `2.0/`
-- **Location**: `packages/twenty-website-new/public/images/releases/`
+- **Location**: `packages/twenty-website/public/images/releases/`
 
 ### Image Files
-- **Format**: `{VERSION}-descriptive-name.webp`
+- **Format**: `{VERSION}-descriptive-name.png`
 - **Convention**: Kebab-case descriptive names
 - **Examples**: 
-  - `1.8.0-workflow-iterator.webp`
-  - `1.8.0-bulk-select.webp`
-  - `1.9.0-new-feature.webp`
+  - `1.8.0-workflow-iterator.png`
+  - `1.8.0-bulk-select.png`
+  - `1.9.0-new-feature.png`
 
 ## Quick Reference Template
 
@@ -311,8 +310,8 @@ Features to document:
 3. ___________________________
 
 Branch name: {VERSION}
-Changelog path: packages/twenty-website-new/src/content/releases/{VERSION}.mdx
-Images path: packages/twenty-website-new/public/images/releases/{MINOR_VERSION}/
+Changelog path: packages/twenty-website/src/content/releases/{VERSION}.mdx
+Images path: packages/twenty-website/public/images/releases/{MINOR_VERSION}/
 ```
 
 ## Tips

.github/actions/yarn-install/action.yaml

@@ -7,17 +7,6 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - name: Free disk space for install
-      if: runner.os == 'Linux'
-      shell: bash
-      run: |
-        # Default GitHub images ship large SDKs this repo does not use; removing
-        # them avoids ENOSPC when restoring or linking a full Yarn node_modules.
-        sudo rm -rf /usr/share/dotnet
-        sudo rm -rf /usr/local/lib/android
-        sudo rm -rf /opt/ghc
-        sudo rm -rf /opt/hostedtoolcache/CodeQL
-        df -h
     - name: Cache primary key builder
       id: globals
       shell: bash

.github/crowdin-app.yml

@@ -4,19 +4,20 @@
 # See https://crowdin.github.io/crowdin-cli/configuration for more information
 #
 
-preserve_hierarchy: true
-base_path: ..
+"preserve_hierarchy": true
+"base_path": ".."
+
+files: [
+  {
+    #
+    # Source files filter - PO files for Lingui
+    #
+    "source": "**/en.po",
 
-files:
-  #
-  # Source files filter - PO files for Lingui
-  #
-  - source: packages/twenty-front/src/locales/en.po
     #
     # Translation files path
     #
-    translation: '%original_path%/%locale%.po'
-  - source: packages/twenty-server/src/engine/core-modules/i18n/locales/en.po
-    translation: '%original_path%/%locale%.po'
-  - source: packages/twenty-emails/src/locales/en.po
-    translation: '%original_path%/%locale%.po'
+    "translation": "%original_path%/%locale%.po",
+  }
+]
+

.github/crowdin-website.yml

@@ -1,23 +0,0 @@
-#
-# Crowdin CLI configuration for Website translations (twenty-website-new)
-# Project ID: 4
-# See https://crowdin.github.io/crowdin-cli/configuration for more information
-#
-
-project_id: 4
-preserve_hierarchy: true
-base_url: 'https://twenty.api.crowdin.com'
-base_path: ..
-languages_mapping:
-  locale:
-    fr: fr-FR
-
-files:
-  #
-  # Source file - PO file for Lingui
-  #
-  - source: packages/twenty-website-new/src/locales/en.po
-    #
-    # Translation files path
-    #
-    translation: '%original_path%/%locale%.po'

.github/workflows/ci-server.yaml

@@ -78,83 +78,6 @@ jobs:
           tag: scope:backend
           tasks: lint,typecheck
 
-  server-previous-version-upgrade-mutation-guard:
-    timeout-minutes: 5
-    runs-on: ubuntu-latest
-    steps:
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 10
-      - name: Get changed upgrade-version-command files
-        id: changed-files
-        uses: tj-actions/changed-files@v45
-        with:
-          files: |
-            packages/twenty-server/src/database/commands/upgrade-version-command/**
-      - name: Check upgrade version commands are in current version only
-        if: >
-          steps.changed-files.outputs.any_changed == 'true' &&
-          !contains(github.event.pull_request.labels.*.name, 'ci:allow-previous-version-upgrade-mutation')
-        run: |
-          VERSION_CONSTANT_FILE="packages/twenty-server/src/engine/core-modules/upgrade/constants/twenty-current-version.constant.ts"
-
-          CURRENT_VERSION=$(sed -n "s/.*TWENTY_CURRENT_VERSION = '\([0-9.]*\)'.*/\1/p" "$VERSION_CONSTANT_FILE")
-
-          if [ -z "$CURRENT_VERSION" ]; then
-            echo "::error::Could not extract TWENTY_CURRENT_VERSION from $VERSION_CONSTANT_FILE"
-            exit 1
-          fi
-
-          CURRENT_DIR=$(echo "$CURRENT_VERSION" | sed -E 's/^([0-9]+)\.([0-9]+)\..*/\1-\2/')
-
-          echo "Current version: $CURRENT_VERSION (directory: $CURRENT_DIR)"
-
-          ADDED_OFFENDERS=""
-          MODIFIED_OFFENDERS=""
-
-          check_files() {
-            local category="$1"
-            shift
-            for file in "$@"; do
-              VERSION_DIR=$(echo "$file" | sed -n 's|.*upgrade-version-command/\([0-9]*-[0-9]*\)/.*|\1|p')
-
-              if [ -n "$VERSION_DIR" ] && [ "$VERSION_DIR" != "$CURRENT_DIR" ]; then
-                if [ "$category" = "added" ]; then
-                  ADDED_OFFENDERS="$ADDED_OFFENDERS\n  - $file (version directory: $VERSION_DIR)"
-                else
-                  MODIFIED_OFFENDERS="$MODIFIED_OFFENDERS\n  - $file (version directory: $VERSION_DIR)"
-                fi
-              fi
-            done
-          }
-
-          check_files "added" ${{ steps.changed-files.outputs.added_files }}
-          check_files "modified" ${{ steps.changed-files.outputs.modified_files }}
-
-          if [ -n "$ADDED_OFFENDERS" ] || [ -n "$MODIFIED_OFFENDERS" ]; then
-            echo "This PR touches upgrade command files outside the current version directory ($CURRENT_DIR / $CURRENT_VERSION)."
-
-            if [ -n "$ADDED_OFFENDERS" ]; then
-              echo ""
-              echo "New files added to non-current version directories:"
-              echo -e "$ADDED_OFFENDERS"
-            fi
-
-            if [ -n "$MODIFIED_OFFENDERS" ]; then
-              echo ""
-              echo "Existing files modified in non-current version directories:"
-              echo -e "$MODIFIED_OFFENDERS"
-            fi
-
-            echo ""
-            echo "If this is intentional, add the label 'ci:allow-previous-version-upgrade-mutation' to this PR and re-run CI."
-            echo "Otherwise, please move your changes to the current version directory ($CURRENT_DIR)."
-
-            echo "::error::Upgrade commands were added or modified in non-current version directories."
-            exit 1
-          fi
-
   server-validation:
     needs: server-build
     timeout-minutes: 30
@@ -388,7 +311,6 @@ jobs:
         changed-files-check,
         server-build,
         server-lint-typecheck,
-        server-previous-version-upgrade-mutation-guard,
         server-validation,
         server-test,
         server-integration-test,

.github/workflows/ci-website.yaml

@@ -1,12 +1,12 @@
 name: CI Website
 
+permissions:
+  contents: read
+
 on:
   pull_request:
   merge_group:
 
-permissions:
-  contents: read
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
@@ -18,40 +18,53 @@ jobs:
     with:
       files: |
         package.json
-        yarn.lock
-        packages/twenty-website-new/**
-        packages/twenty-shared/**
-  website-task:
+        packages/twenty-website/**
+  website-build:
     needs: changed-files-check
     if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
+    timeout-minutes: 10
     runs-on: ubuntu-latest
-    env:
-      NODE_OPTIONS: '--max-old-space-size=6144'
-    strategy:
-      matrix:
-        task: [lint, typecheck, test]
+    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
     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
+      - uses: actions/checkout@v4
         with:
           fetch-depth: 10
+
       - name: Install dependencies
         uses: ./.github/actions/yarn-install
-      - name: Run ${{ matrix.task }} task
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:website
-          tasks: ${{ matrix.task }}
+
+      - name: Server / Create DB
+        run: PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d postgres -c 'CREATE DATABASE "default";'
+
+      - name: Website / Run migrations
+        run: npx nx database:migrate twenty-website
+        env:
+          DATABASE_PG_URL: postgres://postgres:postgres@localhost:5432/default
+      - name: Website / Build Website
+        run: npx nx build twenty-website
+        env:
+          DATABASE_PG_URL: postgres://postgres:postgres@localhost:5432/default
+          KEYSTATIC_GITHUB_CLIENT_ID: xxx
+          KEYSTATIC_GITHUB_CLIENT_SECRET: xxx
+          KEYSTATIC_SECRET: xxx
+          NEXT_PUBLIC_KEYSTATIC_GITHUB_APP_SLUG: xxx
   ci-website-status-check:
     if: always() && !cancelled()
     timeout-minutes: 5
     runs-on: ubuntu-latest
-    needs: [changed-files-check, website-task]
+    needs: [changed-files-check, website-build]
     steps:
       - name: Fail job if any needs failed
         if: contains(needs.*.result, 'failure')

.github/workflows/i18n-pull.yaml

@@ -74,6 +74,8 @@ jobs:
           upload_sources: false
           upload_translations: false
           download_translations: true
+          source: '**/en.po'
+          translation: '%original_path%/%locale%.po'
           export_only_approved: false
           localization_branch_name: i18n
           base_url: 'https://twenty.api.crowdin.com'

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

@@ -1,135 +0,0 @@
-# Pull down website translations from Crowdin every two hours or when triggered manually.
-# When force_pull input is true, translations will be pulled regardless of compilation status.
-
-name: 'Pull website translations from Crowdin'
-
-permissions:
-  contents: write
-  pull-requests: write
-
-on:
-  schedule:
-    - cron: '0 */2 * * *' # Every two hours.
-  workflow_dispatch:
-    inputs:
-      force_pull:
-        description: 'Force pull translations regardless of compilation status'
-        required: false
-        type: boolean
-        default: false
-  workflow_call:
-    inputs:
-      force_pull:
-        description: 'Force pull translations regardless of compilation status'
-        required: false
-        type: boolean
-        default: false
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  pull_website_translations:
-    name: Pull website translations
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          token: ${{ github.token }}
-          ref: ${{ github.head_ref || github.ref_name }}
-
-      - name: Setup website i18n branch
-        run: |
-          git fetch origin i18n-website || true
-          git checkout -B i18n-website origin/i18n-website || git checkout -b i18n-website
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Build twenty-shared
-        run: npx nx build twenty-shared
-
-      # Strict mode fails if there are missing website translations.
-      - name: Compile website translations
-        id: compile_translations_strict
-        run: npx nx run twenty-website-new:lingui:compile --strict
-        continue-on-error: true
-
-      - name: Stash any changes before pulling translations
-        run: |
-          git config --global user.name 'github-actions'
-          git config --global user.email 'github-actions@twenty.com'
-          git add .
-          git stash
-
-      - name: Pull website translations from Crowdin
-        if: inputs.force_pull || steps.compile_translations_strict.outcome == 'failure'
-        uses: crowdin/github-action@v2
-        with:
-          upload_sources: false
-          upload_translations: false
-          download_translations: true
-          source: 'packages/twenty-website-new/src/locales/en.po'
-          translation: 'packages/twenty-website-new/src/locales/%locale%.po'
-          export_only_approved: false
-          localization_branch_name: i18n-website
-          base_url: 'https://twenty.api.crowdin.com'
-          auto_approve_imported: false
-          import_eq_suggestions: false
-          download_sources: false
-          push_sources: false
-          skip_untranslated_strings: false
-          skip_untranslated_files: false
-          push_translations: false
-          create_pull_request: false
-          skip_ref_checkout: true
-          dryrun_action: false
-          config: '.github/crowdin-website.yml'
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-          # Website translations project
-          CROWDIN_PROJECT_ID: '4'
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-
-      # As the files are extracted from a Docker container, they belong to root:root.
-      # We need to fix this before the next steps.
-      - name: Fix file permissions
-        run: sudo chown -R runner:docker .
-
-      - name: Compile website translations
-        id: compile_translations
-        run: |
-          npx nx run twenty-website-new:lingui:compile
-          git status
-          git add packages/twenty-website-new/src/locales
-          if ! git diff --staged --quiet --exit-code; then
-            git commit -m "chore: compile website translations"
-            echo "changes_detected=true" >> $GITHUB_OUTPUT
-          else
-            echo "changes_detected=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Push changes
-        if: steps.compile_translations.outputs.changes_detected == 'true'
-        run: git push origin HEAD:i18n-website
-
-      - name: Create pull request
-        if: steps.compile_translations.outputs.changes_detected == 'true'
-        run: |
-          if git diff --name-only origin/main..HEAD | grep -q .; then
-            gh pr create -B main -H i18n-website --title 'i18n - website translations' --body 'Created by Github action' || true
-          else
-            echo "No file differences between branches, skipping PR creation"
-          fi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Trigger i18n automerge
-        if: steps.compile_translations.outputs.changes_detected == 'true'
-        uses: peter-evans/repository-dispatch@v2
-        with:
-          token: ${{ secrets.TWENTY_INFRA_TOKEN }}
-          repository: twentyhq/twenty-infra
-          event-type: i18n-pr-ready

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

@@ -1,111 +0,0 @@
-name: 'Push website translations to Crowdin'
-
-permissions:
-  contents: write
-  pull-requests: write
-
-on:
-  workflow_dispatch:
-  workflow_call:
-  push:
-    branches: ['main']
-    paths:
-      - 'packages/twenty-website-new/**'
-      - '.github/crowdin-website.yml'
-      - '.github/workflows/website-i18n-push.yaml'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  extract_website_translations:
-    name: Extract and upload website translations
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          token: ${{ github.token }}
-          ref: main
-
-      - name: Setup website i18n branch
-        run: |
-          git fetch origin i18n-website || true
-          git checkout -B i18n-website origin/i18n-website || git checkout -b i18n-website
-
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-
-      - name: Build dependencies
-        run: npx nx build twenty-shared
-
-      - name: Extract website translations
-        run: npx nx run twenty-website-new:lingui:extract
-
-      - name: Check and commit extracted files
-        id: check_extract_changes
-        run: |
-          git config --global user.name 'github-actions'
-          git config --global user.email 'github-actions@twenty.com'
-          git add packages/twenty-website-new/src/locales
-          if ! git diff --staged --quiet --exit-code; then
-            git commit -m "chore: extract website translations"
-            echo "changes_detected=true" >> $GITHUB_OUTPUT
-          else
-            echo "changes_detected=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Compile website translations
-        run: npx nx run twenty-website-new:lingui:compile
-
-      - name: Check and commit compiled files
-        id: check_compile_changes
-        run: |
-          git config --global user.name 'github-actions'
-          git config --global user.email 'github-actions@twenty.com'
-          git add packages/twenty-website-new/src/locales/generated
-          if ! git diff --staged --quiet --exit-code; then
-            git commit -m "chore: compile website translations"
-            echo "changes_detected=true" >> $GITHUB_OUTPUT
-          else
-            echo "changes_detected=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Push changes and create remote branch if needed
-        if: steps.check_extract_changes.outputs.changes_detected == 'true' || steps.check_compile_changes.outputs.changes_detected == 'true'
-        run: git push origin HEAD:i18n-website
-
-      - name: Upload missing website translations
-        if: steps.check_extract_changes.outputs.changes_detected == 'true'
-        uses: crowdin/github-action@v2
-        with:
-          upload_sources: true
-          upload_translations: true
-          download_translations: false
-          localization_branch_name: i18n-website
-          base_url: 'https://twenty.api.crowdin.com'
-          config: '.github/crowdin-website.yml'
-        env:
-          # Website translations project
-          CROWDIN_PROJECT_ID: '4'
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
-
-      - name: Create a pull request
-        if: steps.check_extract_changes.outputs.changes_detected == 'true' || steps.check_compile_changes.outputs.changes_detected == 'true'
-        run: |
-          if git diff --name-only origin/main..HEAD | grep -q .; then
-            gh pr create -B main -H i18n-website --title 'i18n - website translations' --body 'Created by Github action' || true
-          else
-            echo "No file differences between branches, skipping PR creation"
-          fi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Trigger i18n automerge
-        if: steps.check_extract_changes.outputs.changes_detected == 'true' || steps.check_compile_changes.outputs.changes_detected == 'true'
-        uses: peter-evans/repository-dispatch@v2
-        with:
-          token: ${{ secrets.TWENTY_INFRA_TOKEN }}
-          repository: twentyhq/twenty-infra
-          event-type: i18n-pr-ready

CLAUDE.md

@@ -110,8 +110,7 @@ packages/
 ├── twenty-ui/             # Shared UI components library
 ├── twenty-shared/         # Common types and utilities
 ├── twenty-emails/         # Email templates with React Email
-├── twenty-website-new/    # Next.js marketing website
-├── twenty-docs/           # Documentation website
+├── twenty-website/        # Next.js documentation website
 ├── twenty-zapier/         # Zapier integration
 └── twenty-e2e-testing/    # Playwright E2E tests
 ```

README.md

@@ -1,19 +1,19 @@
 <p align="center">
   <a href="https://www.twenty.com">
-    <img src="./packages/twenty-website-new/public/images/core/logo.svg" width="100px" alt="Twenty logo" />
+    <img src="./packages/twenty-website/public/images/core/logo.svg" width="100px" alt="Twenty logo" />
   </a>
 </p>
 
 <h2 align="center" >The #1 Open-Source CRM</h2>
 
-<p align="center"><a href="https://twenty.com"><img src="./packages/twenty-website-new/public/images/readme/globe-icon.svg" width="12" height="12"/> Website</a> · <a href="https://docs.twenty.com"><img src="./packages/twenty-website-new/public/images/readme/book-icon.svg" width="12" height="12"/> Documentation</a> · <a href="https://github.com/orgs/twentyhq/projects/1"><img src="./packages/twenty-website-new/public/images/readme/map-icon.svg" width="12" height="12"/> Roadmap </a> · <a href="https://discord.gg/cx5n4Jzs57"><img src="./packages/twenty-website-new/public/images/readme/discord-icon.svg" width="12" height="12"/> Discord</a> · <a href="https://www.figma.com/file/xt8O9mFeLl46C5InWwoMrN/Twenty"><img src="./packages/twenty-website-new/public/images/readme/figma-icon.png"  width="12" height="12"/>  Figma</a></p>
+<p align="center"><a href="https://twenty.com"><img src="./packages/twenty-website/public/images/readme/globe-icon.svg" width="12" height="12"/> Website</a> · <a href="https://docs.twenty.com"><img src="./packages/twenty-website/public/images/readme/book-icon.svg" width="12" height="12"/> Documentation</a> · <a href="https://github.com/orgs/twentyhq/projects/1"><img src="./packages/twenty-website/public/images/readme/map-icon.svg" width="12" height="12"/> Roadmap </a> · <a href="https://discord.gg/cx5n4Jzs57"><img src="./packages/twenty-website/public/images/readme/discord-icon.svg" width="12" height="12"/> Discord</a> · <a href="https://www.figma.com/file/xt8O9mFeLl46C5InWwoMrN/Twenty"><img src="./packages/twenty-website/public/images/readme/figma-icon.png"  width="12" height="12"/>  Figma</a></p>
 
 <p align="center">
   <a href="https://www.twenty.com">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/github-cover-dark.png" />
-      <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/github-cover-light.png" />
-      <img src="./packages/twenty-website-new/public/images/readme/github-cover-light.png" alt="Twenty banner" />
+      <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/github-cover-dark.png" />
+      <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/github-cover-light.png" />
+      <img src="./packages/twenty-website/public/images/readme/github-cover-light.png" alt="Twenty banner" />
     </picture>
   </a>
 </p>
@@ -24,17 +24,17 @@
 
 Twenty gives technical teams the building blocks for a custom CRM that meets complex business needs and quickly adapts as the business evolves. Twenty is the CRM you build, ship, and version like the rest of your stack.
 
-<a href="https://twenty.com/why-twenty"><img src="./packages/twenty-website-new/public/images/readme/star-icon.svg" width="14" height="14"/> Learn more about why we built Twenty</a>
+<a href="https://twenty.com/why-twenty"><img src="./packages/twenty-website/public/images/readme/star-icon.svg" width="14" height="14"/> Learn more about why we built Twenty</a>
 
 <br />
 
 # Installation
 
-### <img src="./packages/twenty-website-new/public/images/readme/globe-icon.svg" width="14" height="14"/> Cloud
+### <img src="./packages/twenty-website/public/images/readme/globe-icon.svg" width="14" height="14"/> Cloud
 
 The fastest way to get started. Sign up at [twenty.com](https://twenty.com) and spin up a workspace in under a minute, with no infrastructure to manage and always up to date.
 
-### <img src="./packages/twenty-website-new/public/images/readme/book-icon.svg" width="14" height="14"/> Build an app
+### <img src="./packages/twenty-website/public/images/readme/book-icon.svg" width="14" height="14"/> Build an app
 
 Scaffold a new app with the Twenty CLI:
 
@@ -68,7 +68,7 @@ npx twenty deploy
 
 See the [app development guide](https://docs.twenty.com/developers/extend/apps/getting-started) for objects, views, agents, and logic functions.
 
-### <img src="./packages/twenty-website-new/public/images/readme/rocket-icon.svg" width="14" height="14"/> Self-hosting
+### <img src="./packages/twenty-website/public/images/readme/rocket-icon.svg" width="14" height="14"/> Self-hosting
 
 Run Twenty on your own infrastructure with [Docker Compose](https://docs.twenty.com/developers/self-host/capabilities/docker-compose), or contribute locally via the [local setup guide](https://docs.twenty.com/developers/contribute/capabilities/local-setup).
 
@@ -79,61 +79,61 @@ Run Twenty on your own infrastructure with [Docker Compose](https://docs.twenty.
 
 Twenty gives you the building blocks of a modern CRM (objects, views, workflows, and agents) and lets you extend them as code. Here's a tour of what's in the box.
 
-Want to go deeper? Read the <a href="https://docs.twenty.com/user-guide/introduction"><img src="./packages/twenty-website-new/public/images/readme/planner-icon.svg" width="14" height="14"/> User Guide</a> for product walkthroughs, or the <a href="https://docs.twenty.com"><img src="./packages/twenty-website-new/public/images/readme/book-icon.svg" width="14" height="14"/> Documentation</a> for developer reference.
+Want to go deeper? Read the <a href="https://docs.twenty.com/user-guide/introduction"><img src="./packages/twenty-website/public/images/readme/planner-icon.svg" width="14" height="14"/> User Guide</a> for product walkthroughs, or the <a href="https://docs.twenty.com"><img src="./packages/twenty-website/public/images/readme/book-icon.svg" width="14" height="14"/> Documentation</a> for developer reference.
 
 <table align="center">
   <tr>
     <td width="50%">
       <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/v2-build-apps-dark.png" />
-        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/v2-build-apps-light.png" />
-        <img src="./packages/twenty-website-new/public/images/readme/v2-build-apps-light.png" alt="Create your apps" />
+        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/v2-build-apps-dark.png" />
+        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/v2-build-apps-light.png" />
+        <img src="./packages/twenty-website/public/images/readme/v2-build-apps-light.png" alt="Create your apps" />
       </picture>
-      <p align="center"><a href="https://docs.twenty.com/developers/extend/apps/getting-started"><img src="./packages/twenty-website-new/public/images/readme/code-icon.svg" width="16" height="16"/> Learn more about apps in doc</a></p>
+      <p align="center"><a href="https://docs.twenty.com/developers/extend/apps/getting-started"><img src="./packages/twenty-website/public/images/readme/code-icon.svg" width="16" height="16"/> Learn more about apps in doc</a></p>
     </td>
     <td width="50%">
       <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/v2-version-control-dark.png" />
-        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/v2-version-control-light.png" />
-        <img src="./packages/twenty-website-new/public/images/readme/v2-version-control-light.png" alt="Stay on top with version control" />
+        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/v2-version-control-dark.png" />
+        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/v2-version-control-light.png" />
+        <img src="./packages/twenty-website/public/images/readme/v2-version-control-light.png" alt="Stay on top with version control" />
       </picture>
-      <p align="center"><a href="https://docs.twenty.com/developers/extend/apps/publishing"><img src="./packages/twenty-website-new/public/images/readme/monitor-icon.svg" width="16" height="16"/> Learn more about version control in doc</a></p>
+      <p align="center"><a href="https://docs.twenty.com/developers/extend/apps/publishing"><img src="./packages/twenty-website/public/images/readme/monitor-icon.svg" width="16" height="16"/> Learn more about version control in doc</a></p>
     </td>
   </tr>
   <tr>
     <td width="50%">
       <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/v2-all-tools-dark.png" />
-        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/v2-all-tools-light.png" />
-        <img src="./packages/twenty-website-new/public/images/readme/v2-all-tools-light.png" alt="All the tools you need to build anything" />
+        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/v2-all-tools-dark.png" />
+        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/v2-all-tools-light.png" />
+        <img src="./packages/twenty-website/public/images/readme/v2-all-tools-light.png" alt="All the tools you need to build anything" />
       </picture>
-      <p align="center"><a href="https://docs.twenty.com/developers/extend/apps/building"><img src="./packages/twenty-website-new/public/images/readme/rocket-icon.svg" width="16" height="16"/> Learn more about primitives in doc</a></p>
+      <p align="center"><a href="https://docs.twenty.com/developers/extend/apps/building"><img src="./packages/twenty-website/public/images/readme/rocket-icon.svg" width="16" height="16"/> Learn more about primitives in doc</a></p>
     </td>
     <td width="50%">
       <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/v2-tools-dark.png" />
-        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/v2-tools-light.png" />
-        <img src="./packages/twenty-website-new/public/images/readme/v2-tools-light.png" alt="Customize your layouts" />
+        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/v2-tools-dark.png" />
+        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/v2-tools-light.png" />
+        <img src="./packages/twenty-website/public/images/readme/v2-tools-light.png" alt="Customize your layouts" />
       </picture>
-      <p align="center"><a href="https://docs.twenty.com/user-guide/layout/overview"><img src="./packages/twenty-website-new/public/images/readme/planner-icon.svg" width="16" height="16"/> Learn more about layouts in doc</a></p>
+      <p align="center"><a href="https://docs.twenty.com/user-guide/layout/overview"><img src="./packages/twenty-website/public/images/readme/planner-icon.svg" width="16" height="16"/> Learn more about layouts in doc</a></p>
     </td>
   </tr>
   <tr>
     <td width="50%">
       <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/v2-ai-agents-dark.png" />
-        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/v2-ai-agents-light.png" />
-        <img src="./packages/twenty-website-new/public/images/readme/v2-ai-agents-light.png" alt="AI agents and chats" />
+        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/v2-ai-agents-dark.png" />
+        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/v2-ai-agents-light.png" />
+        <img src="./packages/twenty-website/public/images/readme/v2-ai-agents-light.png" alt="AI agents and chats" />
       </picture>
-      <p align="center"><a href="https://docs.twenty.com/user-guide/ai/overview"><img src="./packages/twenty-website-new/public/images/readme/message-icon.svg" width="16" height="16"/> Learn more about AI in doc</a></p>
+      <p align="center"><a href="https://docs.twenty.com/user-guide/ai/overview"><img src="./packages/twenty-website/public/images/readme/message-icon.svg" width="16" height="16"/> Learn more about AI in doc</a></p>
     </td>
     <td width="50%">
       <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website-new/public/images/readme/v2-crm-tools-dark.png" />
-        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website-new/public/images/readme/v2-crm-tools-light.png" />
-        <img src="./packages/twenty-website-new/public/images/readme/v2-crm-tools-light.png" alt="Plus all the tools of a good CRM" />
+        <source media="(prefers-color-scheme: dark)" srcset="./packages/twenty-website/public/images/readme/v2-crm-tools-dark.png" />
+        <source media="(prefers-color-scheme: light)" srcset="./packages/twenty-website/public/images/readme/v2-crm-tools-light.png" />
+        <img src="./packages/twenty-website/public/images/readme/v2-crm-tools-light.png" alt="Plus all the tools of a good CRM" />
       </picture>
-      <p align="center"><a href="https://docs.twenty.com/user-guide/introduction"><img src="./packages/twenty-website-new/public/images/readme/star-icon.svg" width="16" height="16"/> Learn more about CRM features in doc</a></p>
+      <p align="center"><a href="https://docs.twenty.com/user-guide/introduction"><img src="./packages/twenty-website/public/images/readme/star-icon.svg" width="16" height="16"/> Learn more about CRM features in doc</a></p>
     </td>
   </tr>
 </table>
@@ -142,23 +142,23 @@ Want to go deeper? Read the <a href="https://docs.twenty.com/user-guide/introduc
 
 # Stack
 
-- <a href="https://www.typescriptlang.org/"><img src="./packages/twenty-website-new/public/images/readme/stack-typescript.svg" width="14" height="14"/> TypeScript</a>
-- <a href="https://nx.dev/"><img src="./packages/twenty-website-new/public/images/readme/stack-nx.svg" width="14" height="14"/> Nx</a>
-- <a href="https://nestjs.com/"><img src="./packages/twenty-website-new/public/images/readme/stack-nestjs.svg" width="14" height="14"/> NestJS</a>, with <a href="https://bullmq.io/">BullMQ</a>, <a href="https://www.postgresql.org/"><img src="./packages/twenty-website-new/public/images/readme/stack-postgresql.svg" width="14" height="14"/> PostgreSQL</a>, <a href="https://redis.io/"><img src="./packages/twenty-website-new/public/images/readme/stack-redis.svg" width="14" height="14"/> Redis</a>
-- <a href="https://reactjs.org/"><img src="./packages/twenty-website-new/public/images/readme/stack-react.svg" width="14" height="14"/> React</a>, with <a href="https://jotai.org/">Jotai</a>, <a href="https://linaria.dev/">Linaria</a> and <a href="https://lingui.dev/">Lingui</a>
+- <a href="https://www.typescriptlang.org/"><img src="./packages/twenty-website/public/images/readme/stack-typescript.svg" width="14" height="14"/> TypeScript</a>
+- <a href="https://nx.dev/"><img src="./packages/twenty-website/public/images/readme/stack-nx.svg" width="14" height="14"/> Nx</a>
+- <a href="https://nestjs.com/"><img src="./packages/twenty-website/public/images/readme/stack-nestjs.svg" width="14" height="14"/> NestJS</a>, with <a href="https://bullmq.io/">BullMQ</a>, <a href="https://www.postgresql.org/"><img src="./packages/twenty-website/public/images/readme/stack-postgresql.svg" width="14" height="14"/> PostgreSQL</a>, <a href="https://redis.io/"><img src="./packages/twenty-website/public/images/readme/stack-redis.svg" width="14" height="14"/> Redis</a>
+- <a href="https://reactjs.org/"><img src="./packages/twenty-website/public/images/readme/stack-react.svg" width="14" height="14"/> React</a>, with <a href="https://jotai.org/">Jotai</a>, <a href="https://linaria.dev/">Linaria</a> and <a href="https://lingui.dev/">Lingui</a>
 
 
 
 # Thanks
 
 <p align="center">
-  <a href="https://www.chromatic.com/"><img src="./packages/twenty-website-new/public/images/readme/chromatic.png" height="28" alt="Chromatic" /></a>
+  <a href="https://www.chromatic.com/"><img src="./packages/twenty-website/public/images/readme/chromatic.png" height="28" alt="Chromatic" /></a>
   &nbsp;&nbsp;&nbsp;&nbsp;
-  <a href="https://greptile.com"><img src="./packages/twenty-website-new/public/images/readme/greptile.png" height="28" alt="Greptile" /></a>
+  <a href="https://greptile.com"><img src="./packages/twenty-website/public/images/readme/greptile.png" height="28" alt="Greptile" /></a>
   &nbsp;&nbsp;&nbsp;&nbsp;
-  <a href="https://sentry.io/"><img src="./packages/twenty-website-new/public/images/readme/sentry.png" height="28" alt="Sentry" /></a>
+  <a href="https://sentry.io/"><img src="./packages/twenty-website/public/images/readme/sentry.png" height="28" alt="Sentry" /></a>
   &nbsp;&nbsp;&nbsp;&nbsp;
-  <a href="https://crowdin.com/"><img src="./packages/twenty-website-new/public/images/readme/crowdin.png" height="28" alt="Crowdin" /></a>
+  <a href="https://crowdin.com/"><img src="./packages/twenty-website/public/images/readme/crowdin.png" height="28" alt="Crowdin" /></a>
 </p>
 
   Thanks to these amazing services that we use and recommend for UI testing (Chromatic), code review (Greptile), catching bugs (Sentry) and translating (Crowdin).
@@ -166,4 +166,4 @@ Want to go deeper? Read the <a href="https://docs.twenty.com/user-guide/introduc
 
 # Join the Community
 
-<p><a href="https://github.com/twentyhq/twenty"><img src="./packages/twenty-website-new/public/images/readme/star-icon.svg" width="12" height="12"/> Star the repo</a> · <a href="https://discord.gg/cx5n4Jzs57"><img src="./packages/twenty-website-new/public/images/readme/discord-icon.svg" width="12" height="12"/> Discord</a> · <a href="https://github.com/twentyhq/twenty/discussions"><img src="./packages/twenty-website-new/public/images/readme/message-icon.svg" width="12" height="12"/> Feature requests</a> · <a href="https://github.com/orgs/twentyhq/projects/1/views/35"><img src="./packages/twenty-website-new/public/images/readme/rocket-icon.svg" width="12" height="12"/> Releases</a> · <a href="https://twitter.com/twentycrm"><img src="./packages/twenty-website-new/public/images/readme/x-icon.svg" width="12" height="12"/> X</a> · <a href="https://www.linkedin.com/company/twenty/"><img src="./packages/twenty-website-new/public/images/readme/linkedin-icon.svg" width="12" height="12"/> LinkedIn</a> · <a href="https://twenty.crowdin.com/twenty"><img src="./packages/twenty-website-new/public/images/readme/language-icon.svg" width="12" height="12"/> Crowdin</a> · <a href="https://github.com/twentyhq/twenty/contribute"><img src="./packages/twenty-website-new/public/images/readme/code-icon.svg" width="12" height="12"/> Contribute</a></p>
+<p><a href="https://github.com/twentyhq/twenty"><img src="./packages/twenty-website/public/images/readme/star-icon.svg" width="12" height="12"/> Star the repo</a> · <a href="https://discord.gg/cx5n4Jzs57"><img src="./packages/twenty-website/public/images/readme/discord-icon.svg" width="12" height="12"/> Discord</a> · <a href="https://github.com/twentyhq/twenty/discussions"><img src="./packages/twenty-website/public/images/readme/message-icon.svg" width="12" height="12"/> Feature requests</a> · <a href="https://github.com/orgs/twentyhq/projects/1/views/35"><img src="./packages/twenty-website/public/images/readme/rocket-icon.svg" width="12" height="12"/> Releases</a> · <a href="https://twitter.com/twentycrm"><img src="./packages/twenty-website/public/images/readme/x-icon.svg" width="12" height="12"/> X</a> · <a href="https://www.linkedin.com/company/twenty/"><img src="./packages/twenty-website/public/images/readme/linkedin-icon.svg" width="12" height="12"/> LinkedIn</a> · <a href="https://twenty.crowdin.com/twenty"><img src="./packages/twenty-website/public/images/readme/language-icon.svg" width="12" height="12"/> Crowdin</a> · <a href="https://github.com/twentyhq/twenty/contribute"><img src="./packages/twenty-website/public/images/readme/code-icon.svg" width="12" height="12"/> Contribute</a></p>

package.json

@@ -1,20 +1,172 @@
 {
   "private": true,
+  "dependencies": {
+    "@apollo/client": "^4.0.0",
+    "@floating-ui/react": "^0.24.3",
+    "@linaria/core": "^6.2.0",
+    "@linaria/react": "^6.2.1",
+    "@radix-ui/colors": "^3.0.0",
+    "@sniptt/guards": "^0.2.0",
+    "@tabler/icons-react": "^3.31.0",
+    "@wyw-in-js/babel-preset": "^1.0.6",
+    "@wyw-in-js/vite": "^0.7.0",
+    "archiver": "^7.0.1",
+    "danger-plugin-todos": "^1.3.1",
+    "date-fns": "^2.30.0",
+    "date-fns-tz": "^2.0.0",
+    "deep-equal": "^2.2.2",
+    "file-type": "16.5.4",
+    "framer-motion": "^11.18.0",
+    "fuse.js": "^7.1.0",
+    "googleapis": "105",
+    "hex-rgb": "^5.0.0",
+    "immer": "^10.1.1",
+    "jotai": "^2.17.1",
+    "libphonenumber-js": "^1.10.26",
+    "lodash.camelcase": "^4.3.0",
+    "lodash.chunk": "^4.2.0",
+    "lodash.compact": "^3.0.1",
+    "lodash.escaperegexp": "^4.1.2",
+    "lodash.groupby": "^4.6.0",
+    "lodash.identity": "^3.0.0",
+    "lodash.isempty": "^4.4.0",
+    "lodash.isequal": "^4.5.0",
+    "lodash.isobject": "^3.0.2",
+    "lodash.kebabcase": "^4.1.1",
+    "lodash.mapvalues": "^4.6.0",
+    "lodash.merge": "^4.6.2",
+    "lodash.omit": "^4.5.0",
+    "lodash.pickby": "^4.6.0",
+    "lodash.snakecase": "^4.1.1",
+    "lodash.upperfirst": "^4.3.1",
+    "microdiff": "^1.3.2",
+    "next-with-linaria": "^1.3.0",
+    "planer": "^1.2.0",
+    "pluralize": "^8.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-responsive": "^9.0.2",
+    "react-router-dom": "^6.30.3",
+    "react-tooltip": "^5.13.1",
+    "remark-gfm": "^4.0.1",
+    "rxjs": "^7.2.0",
+    "semver": "^7.5.4",
+    "slash": "^5.1.0",
+    "temporal-polyfill": "^0.3.0",
+    "ts-key-enum": "^2.0.12",
+    "tslib": "^2.8.1",
+    "type-fest": "4.10.1",
+    "typescript": "5.9.2",
+    "uuid": "^9.0.0",
+    "vite-tsconfig-paths": "^4.2.1",
+    "xlsx-ugnis": "^0.19.3",
+    "zod": "^4.1.11"
+  },
   "devDependencies": {
+    "@babel/core": "^7.14.5",
+    "@babel/preset-react": "^7.14.5",
+    "@babel/preset-typescript": "^7.24.6",
+    "@chromatic-com/storybook": "^4.1.3",
+    "@graphql-codegen/cli": "^3.3.1",
+    "@graphql-codegen/client-preset": "^4.1.0",
+    "@graphql-codegen/typescript": "^3.0.4",
+    "@graphql-codegen/typescript-operations": "^3.0.4",
+    "@graphql-codegen/typescript-react-apollo": "^3.3.7",
     "@nx/jest": "22.5.4",
     "@nx/js": "22.5.4",
     "@nx/react": "22.5.4",
     "@nx/storybook": "22.5.4",
     "@nx/vite": "22.5.4",
     "@nx/web": "22.5.4",
+    "@oxlint/plugins": "^1.51.0",
+    "@sentry/types": "^8",
+    "@storybook-community/storybook-addon-cookie": "^5.0.0",
+    "@storybook/addon-coverage": "^3.0.0",
+    "@storybook/addon-docs": "^10.3.3",
+    "@storybook/addon-links": "^10.3.3",
+    "@storybook/addon-vitest": "^10.3.3",
+    "@storybook/icons": "^2.0.1",
+    "@storybook/react-vite": "^10.3.3",
+    "@storybook/test-runner": "^0.24.2",
+    "@swc-node/register": "^1.11.1",
+    "@swc/cli": "^0.7.10",
+    "@swc/core": "^1.15.11",
+    "@swc/helpers": "~0.5.19",
+    "@swc/jest": "^0.2.39",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/addressparser": "^1.0.3",
+    "@types/bcrypt": "^5.0.0",
+    "@types/bytes": "^3.1.1",
+    "@types/chrome": "^0.0.267",
+    "@types/deep-equal": "^1.0.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/graphql-fields": "^1.3.6",
+    "@types/inquirer": "^9.0.9",
+    "@types/jest": "^30.0.0",
+    "@types/lodash.camelcase": "^4.3.7",
+    "@types/lodash.compact": "^3.0.9",
+    "@types/lodash.escaperegexp": "^4.1.9",
+    "@types/lodash.groupby": "^4.6.9",
+    "@types/lodash.identity": "^3.0.9",
+    "@types/lodash.isempty": "^4.4.7",
+    "@types/lodash.isequal": "^4.5.7",
+    "@types/lodash.isobject": "^3.0.7",
+    "@types/lodash.kebabcase": "^4.1.7",
+    "@types/lodash.mapvalues": "^4.6.9",
+    "@types/lodash.omit": "^4.5.9",
+    "@types/lodash.pickby": "^4.6.9",
+    "@types/lodash.snakecase": "^4.1.7",
+    "@types/lodash.upperfirst": "^4.3.7",
+    "@types/ms": "^0.7.31",
+    "@types/node": "^24.0.0",
+    "@types/passport-google-oauth20": "^2.0.11",
+    "@types/passport-jwt": "^3.0.8",
+    "@types/passport-microsoft": "^2.1.0",
+    "@types/pluralize": "^0.0.33",
     "@types/react": "^18.2.39",
+    "@types/react-datepicker": "^6.2.0",
     "@types/react-dom": "^18.2.15",
+    "@types/supertest": "^2.0.11",
+    "@types/uuid": "^9.0.2",
+    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
+    "@vitejs/plugin-react-swc": "4.2.3",
+    "@vitest/browser-playwright": "^4.0.18",
+    "@vitest/coverage-istanbul": "^4.0.18",
+    "@vitest/coverage-v8": "^4.0.18",
     "@yarnpkg/types": "^4.0.0",
+    "chromatic": "^6.18.0",
     "concurrently": "^8.2.2",
+    "danger": "^13.0.4",
+    "dotenv-cli": "^7.4.4",
+    "esbuild": "^0.25.10",
     "http-server": "^14.1.1",
+    "jest": "29.7.0",
+    "jest-environment-jsdom": "30.0.0-beta.3",
+    "jest-environment-node": "^29.4.1",
+    "jest-fetch-mock": "^3.0.3",
+    "jsdom": "~22.1.0",
+    "msw": "^2.12.7",
+    "msw-storybook-addon": "^2.0.6",
     "nx": "22.5.4",
+    "prettier": "^3.1.1",
+    "raw-loader": "^4.0.2",
+    "rimraf": "^5.0.5",
+    "source-map-support": "^0.5.20",
+    "storybook": "^10.3.3",
+    "storybook-addon-mock-date": "2.0.0",
+    "storybook-addon-pseudo-states": "^10.3.3",
+    "supertest": "^6.1.3",
+    "ts-jest": "^29.1.1",
+    "ts-loader": "^9.2.3",
+    "ts-node": "10.9.1",
+    "tsc-alias": "^1.8.16",
+    "tsconfig-paths": "^4.2.0",
     "tsx": "^4.17.0",
-    "verdaccio": "^6.3.1"
+    "verdaccio": "^6.3.1",
+    "vite": "^7.0.0",
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": "^24.5.0",
@@ -33,9 +185,7 @@
     "@lingui/core": "5.1.2",
     "@types/qs": "6.9.16",
     "@wyw-in-js/transform@npm:0.6.0": "patch:@wyw-in-js/transform@npm%3A0.7.0#~/.yarn/patches/@wyw-in-js-transform-npm-0.7.0-ba641dc99f.patch",
-    "@wyw-in-js/transform@npm:0.7.0": "patch:@wyw-in-js/transform@npm%3A0.7.0#~/.yarn/patches/@wyw-in-js-transform-npm-0.7.0-ba641dc99f.patch",
-    "@opentelemetry/api": "1.9.1",
-    "chokidar": "^3.6.0"
+    "@wyw-in-js/transform@npm:0.7.0": "patch:@wyw-in-js/transform@npm%3A0.7.0#~/.yarn/patches/@wyw-in-js-transform-npm-0.7.0-ba641dc99f.patch"
   },
   "version": "0.2.1",
   "nx": {},
@@ -53,6 +203,7 @@
       "packages/twenty-ui",
       "packages/twenty-utils",
       "packages/twenty-zapier",
+      "packages/twenty-website",
       "packages/twenty-website-new",
       "packages/twenty-docs",
       "packages/twenty-e2e-testing",

packages/create-twenty-app/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <a href="https://twenty.com">
     <picture>
-      <img alt="Twenty logo" src="https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-website-new/public/images/core/logo.svg" height="128">
+      <img alt="Twenty logo" src="https://raw.githubusercontent.com/twentyhq/twenty/2f25922f4cd5bd61e1427c57c4f8ea224e1d552c/packages/twenty-website/public/images/core/logo.svg" height="128">
     </picture>
   </a>
   <h1>Create Twenty App</h1>

packages/create-twenty-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-twenty-app",
-  "version": "2.3.0",
+  "version": "2.0.0",
   "description": "Command-line interface to create Twenty application",
   "main": "dist/cli.cjs",
   "bin": "dist/cli.cjs",
@@ -40,17 +40,12 @@
     "uuid": "^13.0.0"
   },
   "devDependencies": {
-    "@swc/core": "^1.15.11",
-    "@swc/jest": "^0.2.39",
     "@types/fs-extra": "^11.0.0",
     "@types/inquirer": "^9.0.0",
-    "@types/jest": "^30.0.0",
     "@types/lodash.camelcase": "^4.3.7",
     "@types/lodash.kebabcase": "^4.1.7",
     "@types/lodash.startcase": "^4",
     "@types/node": "^20.0.0",
-    "jest": "29.7.0",
-    "jest-environment-node": "^29.4.1",
     "twenty-shared": "workspace:*",
     "typescript": "^5.9.2",
     "vite": "^7.0.0",

packages/create-twenty-app/src/cli.ts

@@ -26,7 +26,6 @@ const program = new Command(packageJson.name)
     '--skip-local-instance',
     'Skip the local Twenty instance setup prompt',
   )
-  .option('-y, --yes', 'Auto-confirm prompts (e.g. start existing container)')
   .helpOption('-h, --help', 'Display this help message.')
   .action(
     async (
@@ -37,7 +36,6 @@ const program = new Command(packageJson.name)
         displayName?: string;
         description?: string;
         skipLocalInstance?: boolean;
-        yes?: boolean;
       },
     ) => {
       if (directory && !/^[a-z0-9-]+$/.test(directory)) {
@@ -61,7 +59,6 @@ const program = new Command(packageJson.name)
         displayName: options?.displayName,
         description: options?.description,
         skipLocalInstance: options?.skipLocalInstance,
-        yes: options?.yes,
       });
     },
   );

packages/create-twenty-app/src/create-app.command.ts

@@ -11,9 +11,7 @@ import * as path from 'path';
 import { basename } from 'path';
 import {
   authLoginOAuth,
-  checkDockerRunning,
   ConfigService,
-  containerExists,
   detectLocalServer,
   serverStart,
   type ServerStartResult,
@@ -29,7 +27,6 @@ type CreateAppOptions = {
   displayName?: string;
   description?: string;
   skipLocalInstance?: boolean;
-  yes?: boolean;
 };
 
 export class CreateAppCommand {
@@ -74,7 +71,7 @@ export class CreateAppCommand {
       let serverResult: ServerStartResult | undefined;
 
       if (!options.skipLocalInstance) {
-        const shouldStartServer = await this.shouldStartServer(options.yes);
+        const shouldStartServer = await this.shouldStartServer();
 
         if (shouldStartServer) {
           const startResult = await serverStart({
@@ -226,35 +223,13 @@ export class CreateAppCommand {
     );
   }
 
-  private async shouldStartServer(autoConfirm?: boolean): Promise<boolean> {
+  private async shouldStartServer(): Promise<boolean> {
     const existingServerUrl = await detectLocalServer();
 
     if (existingServerUrl) {
       return true;
     }
 
-    if (checkDockerRunning() && containerExists()) {
-      if (autoConfirm) {
-        return true;
-      }
-
-      const { startExisting } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'startExisting',
-          message:
-            'An existing Twenty server container was found. Would you like to start it?',
-          default: true,
-        },
-      ]);
-
-      return startExisting;
-    }
-
-    if (autoConfirm) {
-      return true;
-    }
-
     const { startDocker } = await inquirer.prompt([
       {
         type: 'confirm',

packages/twenty-apps/community/github-connector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-connector",
-  "version": "0.2.0",
+  "version": "0.1.0",
   "license": "MIT",
   "engines": {
     "node": "^24.5.0",

packages/twenty-apps/community/github-connector/src/__tests__/schema.integration-test.ts

@@ -77,7 +77,6 @@ describe('PullRequestReview object', () => {
     expect(names).toContain('firstSubmittedAt');
     expect(names).toContain('lastSubmittedAt');
     expect(names).toContain('eventCount');
-    expect(names).toContain('isSelfReview');
     expect(names).toContain('reviewer');
     expect(names).toContain('pullRequest');
     expect(names).toContain('reviewEvents');

packages/twenty-apps/community/github-connector/src/__tests__/webhook-signature.integration-test.ts

@@ -82,17 +82,7 @@ describe('verifyGitHubSignature', () => {
 });
 
 describe('getRawBodyForSignature', () => {
-  it('prefers event.rawBody when the runtime forwarded it', () => {
-    const original = '{ "action": "opened", "number": 42 }';
-    expect(
-      getRawBodyForSignature({
-        body: { action: 'opened', number: 42 },
-        rawBody: original,
-      }),
-    ).toBe(original);
-  });
-
-  it('falls back to string body when rawBody is not provided', () => {
+  it('returns the string as-is for string body', () => {
     expect(
       getRawBodyForSignature({ body: '{"a":1}', isBase64Encoded: false }),
     ).toBe('{"a":1}');
@@ -129,22 +119,3 @@ describe('verifyGitHubSignature with parsed body', () => {
     });
   });
 });
-
-describe('end-to-end: server forwards rawBody, signature verifies', () => {
-  it('verifies a signature when rawBody is present alongside parsed body', () => {
-    const original = '{ "action": "opened", "number": 42 }';
-    const event = {
-      body: { action: 'opened', number: 42 },
-      rawBody: original,
-      isBase64Encoded: false,
-    };
-
-    const rawBody = getRawBodyForSignature(event);
-    const result = verifyGitHubSignature({
-      rawBody,
-      signatureHeader: sign(original),
-      secret: SECRET,
-    });
-    expect(result.ok).toBe(true);
-  });
-});

packages/twenty-apps/community/github-connector/src/modules/github/connector/webhook-signature.ts

@@ -7,11 +7,7 @@ export type SignatureVerificationResult =
 export function getRawBodyForSignature(event: {
   body: unknown;
   isBase64Encoded?: boolean;
-  rawBody?: string;
 }): string | null {
-  if (typeof event.rawBody === 'string') {
-    return event.rawBody;
-  }
   const raw = event.body;
   if (raw == null) return '';
   if (typeof raw === 'string') {

packages/twenty-apps/community/github-connector/src/modules/github/contributor/logic-functions/contributor-stats.logic-function.ts

@@ -298,12 +298,7 @@ const handler = async (
       const res = await client.query({
         pullRequestReviews: {
           __args: {
-            filter: {
-              and: [
-                { reviewerId: { eq: contributorId } },
-                { isSelfReview: { eq: false } },
-              ],
-            },
+            filter: { reviewerId: { eq: contributorId } },
             orderBy: [{ firstSubmittedAt: 'DescNullsLast' }],
             first: PAGE_SIZE,
             after: cursor,

packages/twenty-apps/community/github-connector/src/modules/github/contributor/logic-functions/top-contributors.logic-function.ts

@@ -198,7 +198,6 @@ const handler = async (
             const res = await client.query({
               pullRequestReviews: {
                 __args: {
-                  filter: { isSelfReview: { eq: false } },
                   orderBy: [{ firstSubmittedAt: 'DescNullsLast' }],
                   first: PAGE_SIZE,
                   after: cursor,

packages/twenty-apps/community/github-connector/src/modules/github/pull-request-review/graphql/mutations/batch-upsert.ts

@@ -15,6 +15,5 @@ export async function batchUpsertConsolidatedReviews(
     eventCount: true,
     reviewerId: true,
     pullRequestId: true,
-    isSelfReview: true,
   }) as Promise<PullRequestReviewRow[]>;
 }

packages/twenty-apps/community/github-connector/src/modules/github/pull-request-review/logic-functions/recompute-pull-request-reviews.logic-function.ts

@@ -23,10 +23,7 @@ type ReviewEventNode = {
   reviewerId: string | null;
   pullRequestId: string | null;
   reviewer: { ghLogin: string | null } | null;
-  pullRequest: {
-    githubNumber: number | null;
-    authorId: string | null;
-  } | null;
+  pullRequest: { githubNumber: number | null } | null;
 };
 
 type GroupContext = {
@@ -34,7 +31,6 @@ type GroupContext = {
   reviewerId: string | null;
   prNumber: number | null;
   reviewerLogin: string | null;
-  prAuthorId: string | null;
   events: { state: ReviewEventState; submittedAt: string | null }[];
 };
 
@@ -72,7 +68,7 @@ const handler = async (_event: RoutePayload<unknown>) => {
               reviewerId: true,
               pullRequestId: true,
               reviewer: { ghLogin: true },
-              pullRequest: { githubNumber: true, authorId: true },
+              pullRequest: { githubNumber: true },
             },
           },
           pageInfo: { hasNextPage: true, endCursor: true },
@@ -99,7 +95,6 @@ const handler = async (_event: RoutePayload<unknown>) => {
             reviewerId: node.reviewerId,
             prNumber: node.pullRequest?.githubNumber ?? null,
             reviewerLogin: node.reviewer?.ghLogin ?? null,
-            prAuthorId: node.pullRequest?.authorId ?? null,
             events: [],
           };
           groups.set(key, group);
@@ -110,9 +105,6 @@ const handler = async (_event: RoutePayload<unknown>) => {
         if (group.prNumber === null && node.pullRequest?.githubNumber != null) {
           group.prNumber = node.pullRequest.githubNumber;
         }
-        if (group.prAuthorId === null && node.pullRequest?.authorId) {
-          group.prAuthorId = node.pullRequest.authorId;
-        }
         group.events.push({
           state: node.state,
           submittedAt: node.submittedAt,
@@ -131,7 +123,6 @@ const handler = async (_event: RoutePayload<unknown>) => {
         prNumber: group.prNumber,
         reviewerLogin: group.reviewerLogin,
         events: group.events,
-        prAuthorId: group.prAuthorId,
       }),
     );
   }

packages/twenty-apps/community/github-connector/src/modules/github/pull-request-review/objects/pull-request-review.object.ts

@@ -24,9 +24,6 @@ export const REVIEW_EVENT_COUNT_FIELD_UNIVERSAL_IDENTIFIER =
 export const PULL_REQUEST_REVIEW_CREATED_AT_FIELD_UNIVERSAL_IDENTIFIER =
   'b4d61187-1b78-5d6e-9752-79f994ff6d55';
 
-export const REVIEW_IS_SELF_REVIEW_FIELD_UNIVERSAL_IDENTIFIER =
-  'c1f3e8a2-9b5d-4e7f-8a6c-2d4b6f8e1a93';
-
 enum ReviewState {
   APPROVED = 'APPROVED',
   CHANGES_REQUESTED = 'CHANGES_REQUESTED',
@@ -119,15 +116,5 @@ export default defineObject({
       icon: 'IconHash',
       defaultValue: 0,
     },
-    {
-      universalIdentifier: REVIEW_IS_SELF_REVIEW_FIELD_UNIVERSAL_IDENTIFIER,
-      name: 'isSelfReview',
-      type: FieldType.BOOLEAN,
-      label: 'Self review',
-      description:
-        'True when the reviewer is the same contributor as the PR author. Self reviews are excluded from review-count aggregations (top reviewers, contributor stats, etc.) so contributors are credited only for reviews on other people\u2019s PRs.',
-      icon: 'IconUserCheck',
-      defaultValue: false,
-    },
   ],
 });

packages/twenty-apps/community/github-connector/src/modules/github/pull-request-review/types/pull-request-review-row.ts

@@ -8,5 +8,4 @@ export type PullRequestReviewRow = {
   eventCount?: number | null;
   reviewerId?: string | null;
   pullRequestId?: string | null;
-  isSelfReview?: boolean | null;
 };

packages/twenty-apps/community/github-connector/src/modules/github/pull-request-review/utils/build-consolidated-row.ts

@@ -12,7 +12,6 @@ export type ConsolidatedReviewUpsertInput = {
   eventCount: number;
   reviewerId: string | null;
   pullRequestId: string;
-  isSelfReview: boolean;
 };
 
 export type BuildConsolidatedRowParams = {
@@ -21,23 +20,8 @@ export type BuildConsolidatedRowParams = {
   prNumber: number | null;
   reviewerLogin: string | null;
   events: ReviewEventForConsolidation[];
-  /**
-   * Author of the PR being reviewed. When non-null and equal to `reviewerId`
-   * the consolidated row is flagged as a self-review so downstream
-   * aggregations (top reviewers, contributor stats, etc.) can exclude it.
-   */
-  prAuthorId?: string | null;
 };
 
-export const isSelfReview = (
-  reviewerId: string | null,
-  prAuthorId: string | null | undefined,
-): boolean =>
-  reviewerId !== null &&
-  prAuthorId !== null &&
-  prAuthorId !== undefined &&
-  reviewerId === prAuthorId;
-
 export const buildReviewKey = (
   pullRequestId: string,
   reviewerId: string | null,
@@ -65,6 +49,5 @@ export const buildConsolidatedRow = (
     eventCount: verdict.eventCount,
     reviewerId: params.reviewerId,
     pullRequestId: params.pullRequestId,
-    isSelfReview: isSelfReview(params.reviewerId, params.prAuthorId ?? null),
   };
 };

packages/twenty-apps/community/github-connector/src/modules/github/pull-request-review/utils/consolidate-reviews.integration-test.ts

@@ -8,7 +8,6 @@ import {
   buildConsolidatedRow,
   buildReviewKey,
   buildConsolidatedTitle,
-  isSelfReview,
 } from 'src/modules/github/pull-request-review/utils/build-consolidated-row';
 
 const evt = (
@@ -141,71 +140,6 @@ describe('buildConsolidatedRow', () => {
       eventCount: 3,
       reviewerId: 'rev-2',
       pullRequestId: 'pr-1',
-      isSelfReview: false,
     });
   });
-
-  it('flags isSelfReview when prAuthorId equals reviewerId', () => {
-    const row = buildConsolidatedRow({
-      pullRequestId: 'pr-1',
-      reviewerId: 'alice',
-      prNumber: 7,
-      reviewerLogin: 'alice',
-      prAuthorId: 'alice',
-      events: [evt('COMMENTED', '2025-04-01T10:00:00Z')],
-    });
-    expect(row.isSelfReview).toBe(true);
-  });
-
-  it('does not flag isSelfReview when prAuthorId differs from reviewerId', () => {
-    const row = buildConsolidatedRow({
-      pullRequestId: 'pr-1',
-      reviewerId: 'alice',
-      prNumber: 7,
-      reviewerLogin: 'alice',
-      prAuthorId: 'bob',
-      events: [evt('APPROVED', '2025-04-01T10:00:00Z')],
-    });
-    expect(row.isSelfReview).toBe(false);
-  });
-
-  it('does not flag isSelfReview when prAuthorId is missing', () => {
-    const row = buildConsolidatedRow({
-      pullRequestId: 'pr-1',
-      reviewerId: 'alice',
-      prNumber: 7,
-      reviewerLogin: 'alice',
-      events: [evt('APPROVED', '2025-04-01T10:00:00Z')],
-    });
-    expect(row.isSelfReview).toBe(false);
-  });
-
-  it('does not flag isSelfReview when reviewerId is null (ghost reviewer)', () => {
-    const row = buildConsolidatedRow({
-      pullRequestId: 'pr-1',
-      reviewerId: null,
-      prNumber: 7,
-      reviewerLogin: null,
-      prAuthorId: null,
-      events: [evt('COMMENTED', '2025-04-01T10:00:00Z')],
-    });
-    expect(row.isSelfReview).toBe(false);
-  });
-});
-
-describe('isSelfReview', () => {
-  it('returns true only when both ids are present and equal', () => {
-    expect(isSelfReview('a', 'a')).toBe(true);
-  });
-
-  it('returns false when ids differ', () => {
-    expect(isSelfReview('a', 'b')).toBe(false);
-  });
-
-  it('returns false when either side is null/undefined', () => {
-    expect(isSelfReview(null, 'a')).toBe(false);
-    expect(isSelfReview('a', null)).toBe(false);
-    expect(isSelfReview('a', undefined)).toBe(false);
-    expect(isSelfReview(null, null)).toBe(false);
-  });
 });

packages/twenty-apps/community/github-connector/src/modules/github/pull-request/logic-functions/fetch-prs.logic-function.ts

@@ -110,16 +110,9 @@ const handler = async (event: RoutePayload<FetchPrsPayload>) => {
     reviewerId: string | null;
     prNumber: number;
     reviewerLogin: string | null;
-    prAuthorId: string | null;
     events: { state: ReviewEventState; submittedAt: string | null }[];
   };
 
-  const authorIdByPullRequestId = new Map<string, string | null>();
-  for (const pr of prData) {
-    const id = prIdByNumber.get(pr.githubNumber);
-    if (id) authorIdByPullRequestId.set(id, pr.authorId);
-  }
-
   let skippedReviews = 0;
   const reviewEventData: ReviewEventInput[] = [];
   const groups = new Map<GroupKey, GroupContext>();
@@ -148,7 +141,6 @@ const handler = async (event: RoutePayload<FetchPrsPayload>) => {
           reviewerId,
           prNumber: pr.number,
           reviewerLogin: review.author?.login ?? null,
-          prAuthorId: authorIdByPullRequestId.get(pullRequestId) ?? null,
           events: [],
         };
         groups.set(key, group);
@@ -185,7 +177,6 @@ const handler = async (event: RoutePayload<FetchPrsPayload>) => {
         prNumber: group.prNumber,
         reviewerLogin: group.reviewerLogin,
         events: group.events,
-        prAuthorId: group.prAuthorId,
       }),
     );
     const consolidatedRecords = await timed(

packages/twenty-apps/examples/postcard/package.json

@@ -19,8 +19,8 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "twenty-client-sdk": "2.2.0",
-    "twenty-sdk": "2.2.0"
+    "twenty-client-sdk": "0.9.0",
+    "twenty-sdk": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^24.7.2",

packages/twenty-apps/examples/postcard/src/application.config.ts

@@ -8,6 +8,7 @@ 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',

packages/twenty-apps/examples/postcard/src/components/generate-post-card-component-effect.tsx

@@ -1,12 +1,8 @@
 import { useEffect } from 'react';
 import { defineFrontComponent } from 'twenty-sdk/define';
-import {
-  enqueueSnackbar,
-  unmountFrontComponent,
-  updateProgress,
-  useRecordId,
-} from 'twenty-sdk/front-component';
+import { useRecordId, updateProgress, enqueueSnackbar, unmountFrontComponent } from 'twenty-sdk/front-component';
 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 =
@@ -18,9 +14,9 @@ const GeneratePostCardEffect = () => {
   const recordId = useRecordId();
 
   useEffect(() => {
-    if (recordId === null) {
+    if (!isDefined(recordId)) {
       enqueueSnackbar({
-        message: 'Please select exactly one record',
+        message: 'No record selected',
         variant: 'error',
       });
       unmountFrontComponent();

packages/twenty-apps/examples/postcard/src/components/send-post-cards-component-effect.tsx

@@ -1,12 +1,8 @@
 import { useEffect } from 'react';
 import { defineFrontComponent } from 'twenty-sdk/define';
-import {
-  enqueueSnackbar,
-  unmountFrontComponent,
-  updateProgress,
-  useRecordId,
-} from 'twenty-sdk/front-component';
+import { useRecordId, updateProgress, enqueueSnackbar, unmountFrontComponent } from 'twenty-sdk/front-component';
 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 = () => {
@@ -18,25 +14,55 @@ const SendPostCardsEffect = () => {
         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);
 
-        if (recordId) {
+        for (let i = 0; i < idsToSend.length; i++) {
           await client.mutation({
             updatePostCard: {
               __args: {
-                id: recordId,
+                id: idsToSend[i],
                 data: { status: 'SENT' },
               },
               id: true,
             },
           });
 
-          await enqueueSnackbar({
-            message: `Postcard sent`,
-            variant: 'success',
-          });
+          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 =

packages/twenty-apps/examples/postcard/yarn.lock

@@ -3317,8 +3317,8 @@ __metadata:
     oxlint: "npm:^0.16.0"
     react: "npm:^19.0.0"
     react-dom: "npm:^19.0.0"
-    twenty-client-sdk: "npm:2.2.0"
-    twenty-sdk: "npm:2.2.0"
+    twenty-client-sdk: "npm:0.9.0"
+    twenty-sdk: "npm:0.9.0"
     typescript: "npm:^5.9.3"
     vite-tsconfig-paths: "npm:^4.2.1"
     vitest: "npm:^3.1.1"
@@ -4059,21 +4059,21 @@ __metadata:
   languageName: node
   linkType: hard
 
-"twenty-client-sdk@npm:2.2.0":
-  version: 2.2.0
-  resolution: "twenty-client-sdk@npm:2.2.0"
+"twenty-client-sdk@npm:0.9.0":
+  version: 0.9.0
+  resolution: "twenty-client-sdk@npm:0.9.0"
   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/90122593efa53440ae386960211a2c274b13a410942bf6f9bc35cf952ae55fe83280e29074677fd284fa3c79069fc578980db06a92a143c08e043f865dbbbd3c
+  checksum: 10c0/4b42a6622a9852fc3eca50c1131b116c5602af006ee5f1d3b4f1e97721bbc8ef5c2f3b60d9dee3ca9ca8c3c7ad4b292a7b55007b779b4c042997dbc29940ba54
   languageName: node
   linkType: hard
 
-"twenty-sdk@npm:2.2.0":
-  version: 2.2.0
-  resolution: "twenty-sdk@npm:2.2.0"
+"twenty-sdk@npm:0.9.0":
+  version: 0.9.0
+  resolution: "twenty-sdk@npm:0.9.0"
   dependencies:
     "@genql/cli": "npm:^3.0.3"
     "@genql/runtime": "npm:^2.10.0"
@@ -4093,7 +4093,7 @@ __metadata:
     react: "npm:^19.0.0"
     react-dom: "npm:^19.0.0"
     tinyglobby: "npm:^0.2.15"
-    twenty-client-sdk: "npm:2.2.0"
+    twenty-client-sdk: "npm:0.9.0"
     typescript: "npm:^5.9.2"
     uuid: "npm:^13.0.0"
     vite: "npm:^7.0.0"
@@ -4101,7 +4101,7 @@ __metadata:
     zod: "npm:^4.1.11"
   bin:
     twenty: dist/cli.cjs
-  checksum: 10c0/8978b4b0aa5ea282c8f76799347d9d1812901ec609bc2bd9270261a6bc5589ad361f6102a06900a4511a29a8378cd3811c2c0bad9f01cb8adadabca6d96dfd0b
+  checksum: 10c0/27f93e5edac3265f819abacc853598435718020258a95d55518562e086e42daabae784964b42005d8e4ff30d1d6f13a12a38c656e18c60bad98da3f579a8e1c3
   languageName: node
   linkType: hard
 

packages/twenty-apps/fixtures/minimal-app/application.config.ts

@@ -4,5 +4,6 @@ export default defineApplication({
   universalIdentifier: 'e1e2e3e4-e5e6-4000-8000-000000000001',
   displayName: 'Root App',
   description: 'An app with all entities at root level',
+  icon: 'IconFolder',
   defaultRoleUniversalIdentifier: 'e1e2e3e4-e5e6-4000-8000-000000000002',
 });

packages/twenty-apps/fixtures/rich-app/application.config.ts

@@ -5,6 +5,7 @@ export default defineApplication({
   universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
   displayName: 'Rich App',
   description: 'A simple rich app',
+  icon: 'IconWorld',
   applicationVariables: {
     DEFAULT_RECIPIENT_NAME: {
       universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',

packages/twenty-apps/fixtures/rich-app/src/logic-functions/lookup-recipient.function.ts

@@ -10,13 +10,5 @@ export default defineLogicFunction({
   description: 'Look up a recipient by name to find their details',
   timeoutSeconds: 5,
   handler,
-  toolTriggerSettings: {
-    inputSchema: {
-      type: 'object',
-      properties: {
-        recipientName: { type: 'string' },
-      },
-      required: ['recipientName'],
-    },
-  },
+  isTool: true,
 });

packages/twenty-apps/fixtures/rich-app/src/views/post-cards-by-status.view.ts

@@ -30,31 +30,31 @@ export default defineView({
   ],
   groups: [
     {
-      universalIdentifier: 'e9ed34f1-3c3d-41b1-869b-00aae0033d9c',
+      universalIdentifier: 'bg1a2b3c-0001-4a7b-8c9d-0e1f2a3b4c5d',
       fieldValue: 'DRAFT',
       position: 0,
       isVisible: true,
     },
     {
-      universalIdentifier: '19b1a3c1-53f0-4d32-b072-d645dac98e38',
+      universalIdentifier: 'bg1a2b3c-0002-4a7b-8c9d-0e1f2a3b4c5d',
       fieldValue: 'SENT',
       position: 1,
       isVisible: true,
     },
     {
-      universalIdentifier: 'f545cb5a-370d-423f-9b4e-278a9a465bdf',
+      universalIdentifier: 'bg1a2b3c-0003-4a7b-8c9d-0e1f2a3b4c5d',
       fieldValue: 'DELIVERED',
       position: 2,
       isVisible: true,
     },
     {
-      universalIdentifier: '5d4c6d5f-af53-4cd0-a843-df38915561b2',
+      universalIdentifier: 'bg1a2b3c-0004-4a7b-8c9d-0e1f2a3b4c5d',
       fieldValue: 'RETURNED',
       position: 3,
       isVisible: true,
     },
     {
-      universalIdentifier: '5ebbd7dc-9939-4594-b2a0-519269b4531f',
+      universalIdentifier: 'bg1a2b3c-0005-4a7b-8c9d-0e1f2a3b4c5d',
       fieldValue: 'LOST',
       position: 4,
       isVisible: true,

packages/twenty-apps/internal/exa/src/logic-functions/exa-web-search.ts

@@ -111,8 +111,7 @@ export default defineLogicFunction({
   description:
     'Structured web search powered by Exa. Returns entity-aware results with category filtering (companies, people, research papers, news, and other content types). Prefer this when the query benefits from structured data or a specific category. For general real-time web browsing, prefer the native `web_search` tool when it is available.',
   timeoutSeconds: 30,
-  toolTriggerSettings: {
-    inputSchema: exaWebSearchInputSchema,
-  },
+  isTool: true,
+  toolInputSchema: exaWebSearchInputSchema,
   handler,
 });

packages/twenty-apps/internal/twenty-linear/.oxlintrc.json

@@ -1,19 +0,0 @@
-{
-  "$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"
-  }
-}

packages/twenty-apps/internal/twenty-linear/README.md

@@ -1,79 +0,0 @@
-# Linear for Twenty
-
-Connect your Linear account to Twenty to create issues and look up teams
-straight from your workflows or the AI chat.
-
-## What you can do
-
-Once installed and connected, two tools become available:
-
-- **Create Linear issue** — from the AI chat, ask something like
-  *"create a Linear issue in the Engineering team titled 'Fix login bug'"*
-  and the AI will file it for you. From a workflow, add it as a step
-  with `teamId` + `title` (and optional `description`).
-- **List Linear teams** — discovers the teams in your Linear workspace,
-  useful when you need to pick a `teamId` for the create-issue step.
-
-## Installing
-
-1. Open **Settings → Applications** in your Twenty workspace.
-2. Find **Linear** in the available apps and click **Install**.
-3. Open the app, go to the **Connections** tab, and click **Add connection**.
-4. Choose **Just for me** (your personal Linear account) or
-   **Workspace shared** (a team-managed Linear account anyone in this
-   workspace can act through), then complete the Linear sign-in.
-
-That's it — you can now use the tools above.
-
-> If you see a "Linear OAuth is not yet set up by your server administrator"
-> notice on the Connections tab, ask your Twenty admin to follow the
-> **Self-hosting setup** below — they need to provide the OAuth credentials
-> before connections can be added.
-
----
-
-## Self-hosting setup
-
-This section is for Twenty server admins. If you're on Twenty Cloud, skip
-this — the OAuth credentials are already configured.
-
-### 1. Register an OAuth app in Linear
-
-1. Visit https://linear.app/settings/api/applications/new.
-2. Set the **Redirect URI** to `<SERVER_URL>/apps/oauth/callback` (for
-   local dev: `http://localhost:3000/apps/oauth/callback`).
-3. Copy the generated **Client ID** and **Client Secret**.
-
-### 2. Wire the credentials into Twenty
-
-1. In **Settings → Applications**, find **Linear**, click into it, and go
-   to the **Application registration** tab (admin-only).
-2. Paste your Linear **Client ID** into `LINEAR_CLIENT_ID` and the
-   **Client Secret** into `LINEAR_CLIENT_SECRET`.
-
-Workspace users will now be able to add Linear connections from the
-**Connections** tab as described above.
-
-### 3. (Developers only) Building the app from source
-
-If you're working on this app rather than installing the published version:
-
-```bash
-cd packages/twenty-apps/internal/twenty-linear
-
-# For day-to-day development (publish + install + watch in one):
-yarn twenty dev
-
-# Manual publish flow (deploy registers the app, install activates it):
-yarn twenty deploy
-yarn twenty install
-```
-
-`twenty dev` is recommended for iteration — it publishes, installs, and
-watches for changes in one command. Use `twenty deploy` + `twenty install`
-when you want to control each step separately (e.g. deploying to a
-production server without auto-installing).
-
-This serves as the reference implementation for Twenty's
-`defineConnectionProvider({ type: 'oauth' })` flow — useful as a template
-when adding OAuth integrations for other providers.

packages/twenty-apps/internal/twenty-linear/package.json

@@ -1,32 +0,0 @@
-{
-  "name": "twenty-linear",
-  "version": "0.1.5",
-  "description": "Linear integration for Twenty. Connect a user's Linear account and create issues from logic functions.",
-  "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 --config vitest.unit.config.ts",
-    "test:watch": "vitest --config vitest.unit.config.ts"
-  },
-  "dependencies": {
-    "twenty-sdk": "2.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.7.2",
-    "oxlint": "^0.16.0",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^4.3.2",
-    "vitest": "^3.1.1"
-  }
-}

packages/twenty-apps/internal/twenty-linear/public/linear-logomark.svg

@@ -1 +0,0 @@
-<svg fill="#5E6AD2" role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Linear</title><path d="M2.886 4.18A11.982 11.982 0 0 1 11.99 0C18.624 0 24 5.376 24 12.009c0 3.64-1.62 6.903-4.18 9.105L2.887 4.18ZM1.817 5.626l16.556 16.556c-.524.33-1.075.62-1.65.866L.951 7.277c.247-.575.537-1.126.866-1.65ZM.322 9.163l14.515 14.515c-.71.172-1.443.282-2.195.322L0 11.358a12 12 0 0 1 .322-2.195Zm-.17 4.862 9.823 9.824a12.02 12.02 0 0 1-9.824-9.824Z"/></svg>

packages/twenty-apps/internal/twenty-linear/src/application.config.ts

@@ -1,32 +0,0 @@
-import { defineApplication } from 'twenty-sdk/define';
-
-import {
-  APPLICATION_UNIVERSAL_IDENTIFIER,
-  DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-} from 'src/constants/universal-identifiers';
-
-export default defineApplication({
-  universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,
-  displayName: 'Linear',
-  description:
-    'Connect Linear to Twenty. Each workspace member connects their own Linear account; logic functions can then create issues and read team data on their behalf.',
-  logoUrl: 'public/linear-logomark.svg',
-  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-  // OAuth client_id/secret live at the registration level (one OAuth app per
-  // Twenty server, configured by the server admin) — not per-workspace —
-  // so they're declared as serverVariables, not applicationVariables.
-  serverVariables: {
-    LINEAR_CLIENT_ID: {
-      description:
-        'OAuth client ID from your Linear OAuth application (linear.app/settings/api/applications).',
-      isSecret: false,
-      isRequired: true,
-    },
-    LINEAR_CLIENT_SECRET: {
-      description:
-        'OAuth client secret from your Linear OAuth application. Stored encrypted; never exposed in API responses.',
-      isSecret: true,
-      isRequired: true,
-    },
-  },
-});

packages/twenty-apps/internal/twenty-linear/src/connection-providers/linear-connection.ts

@@ -1,22 +0,0 @@
-import { defineConnectionProvider } from 'twenty-sdk/define';
-
-import { LINEAR_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
-
-export default defineConnectionProvider({
-  universalIdentifier: LINEAR_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER,
-  name: 'linear',
-  displayName: 'Linear',
-  type: 'oauth',
-  oauth: {
-    authorizationEndpoint: 'https://linear.app/oauth/authorize',
-    tokenEndpoint: 'https://api.linear.app/oauth/token',
-    revokeEndpoint: 'https://api.linear.app/oauth/revoke',
-    scopes: ['read', 'write'],
-    clientIdVariable: 'LINEAR_CLIENT_ID',
-    clientSecretVariable: 'LINEAR_CLIENT_SECRET',
-    tokenRequestContentType: 'form-urlencoded',
-    // Linear supports PKCE but doesn't require it for confidential clients.
-    // Disabled to keep the test surface minimal.
-    usePkce: false,
-  },
-});

packages/twenty-apps/internal/twenty-linear/src/constants/universal-identifiers.ts

@@ -1,19 +0,0 @@
-// Group all universal identifiers in a single file. Per the codebase
-// convention (see twenty-for-twenty), closely-related constants live
-// together so the rest of the app's source files can stay at one
-// `export default` per file.
-
-export const APPLICATION_UNIVERSAL_IDENTIFIER =
-  '6f4e7c2a-3d8e-4a91-b2cf-9e0b8d5f4a2e';
-
-export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
-  'b6c33347-e41c-4b90-8a37-7b3c49baa85a';
-
-export const LINEAR_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER =
-  '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f';
-
-export const CREATE_LINEAR_ISSUE_UNIVERSAL_IDENTIFIER =
-  '01f829c9-1661-41fa-9ee1-b67e64716c2e';
-
-export const LIST_LINEAR_TEAMS_UNIVERSAL_IDENTIFIER =
-  '15824bbc-9c64-4f97-b45f-d0a44b402bb8';

packages/twenty-apps/internal/twenty-linear/src/logic-functions/__tests__/create-linear-issue.test.ts

@@ -1,126 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-import { createLinearIssueHandler } from '../handlers/create-linear-issue-handler';
-
-import { buildConnection, stubConnectionsThenLinear } from './test-utils';
-
-const SAVED_ENV = { ...process.env };
-
-describe('createLinearIssueHandler', () => {
-  beforeEach(() => {
-    process.env.TWENTY_API_URL = 'http://api.test';
-    process.env.TWENTY_APP_ACCESS_TOKEN = 'app-token';
-  });
-
-  afterEach(() => {
-    process.env = { ...SAVED_ENV };
-    vi.unstubAllGlobals();
-    vi.restoreAllMocks();
-  });
-
-  it('returns an error when required input fields are missing', async () => {
-    const result = await createLinearIssueHandler({ title: 'no team' });
-
-    expect(result).toMatchObject({
-      success: false,
-      error: expect.stringContaining('teamId'),
-    });
-  });
-
-  it('returns an error when no Linear connection exists', async () => {
-    stubConnectionsThenLinear([], {});
-
-    const result = await createLinearIssueHandler({
-      teamId: 'team_1',
-      title: 'hi',
-    });
-
-    expect(result).toMatchObject({
-      success: false,
-      error: expect.stringContaining('not connected'),
-    });
-  });
-
-  it('calls Linear with the only available connection and returns the issue', async () => {
-    const issue = {
-      id: 'issue_1',
-      identifier: 'TEAM-1',
-      title: 'Hello from Twenty',
-      url: 'https://linear.app/twenty/issue/TEAM-1',
-    };
-
-    const fetchMock = stubConnectionsThenLinear([buildConnection()], {
-      data: { issueCreate: { success: true, issue } },
-    });
-
-    const result = await createLinearIssueHandler({
-      teamId: 'team_1',
-      title: 'Hello from Twenty',
-      description: 'Body',
-    });
-
-    expect(result).toEqual({ success: true, issue });
-
-    const [url, init] = fetchMock.mock.calls[1];
-
-    expect(url).toBe('https://api.linear.app/graphql');
-    expect(init.headers.Authorization).toBe('Bearer lin_test_access_token');
-    expect(JSON.parse(init.body as string).variables.input).toEqual({
-      teamId: 'team_1',
-      title: 'Hello from Twenty',
-      description: 'Body',
-    });
-  });
-
-  it('prefers a workspace-shared connection over a user-visibility one', async () => {
-    const userConnection = buildConnection({
-      id: 'conn_user',
-      accessToken: 'lin_user',
-    });
-    const sharedConnection = buildConnection({
-      id: 'conn_shared',
-      visibility: 'workspace',
-      accessToken: 'lin_shared',
-    });
-
-    const fetchMock = stubConnectionsThenLinear(
-      [userConnection, sharedConnection],
-      {
-        data: {
-          issueCreate: {
-            success: true,
-            issue: {
-              id: 'issue_2',
-              identifier: 'T-2',
-              title: 'Hi',
-              url: 'https://linear.app/x/T-2',
-            },
-          },
-        },
-      },
-    );
-
-    const result = await createLinearIssueHandler({
-      teamId: 'team_1',
-      title: 'Hi',
-    });
-
-    expect(result.success).toBe(true);
-    expect(fetchMock.mock.calls[1][1].headers.Authorization).toBe(
-      'Bearer lin_shared',
-    );
-  });
-
-  it('surfaces Linear GraphQL errors as the handler error', async () => {
-    stubConnectionsThenLinear([buildConnection()], {
-      errors: [{ message: 'Invalid teamId' }],
-    });
-
-    const result = await createLinearIssueHandler({
-      teamId: 'bogus',
-      title: 'hi',
-    });
-
-    expect(result).toEqual({ success: false, error: 'Invalid teamId' });
-  });
-});

packages/twenty-apps/internal/twenty-linear/src/logic-functions/__tests__/list-linear-teams.test.ts

@@ -1,56 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-import { listLinearTeamsHandler } from '../handlers/list-linear-teams-handler';
-
-import { buildConnection, stubConnectionsThenLinear } from './test-utils';
-
-const SAVED_ENV = { ...process.env };
-
-describe('listLinearTeamsHandler', () => {
-  beforeEach(() => {
-    process.env.TWENTY_API_URL = 'http://api.test';
-    process.env.TWENTY_APP_ACCESS_TOKEN = 'app-token';
-  });
-
-  afterEach(() => {
-    process.env = { ...SAVED_ENV };
-    vi.unstubAllGlobals();
-    vi.restoreAllMocks();
-  });
-
-  it('returns the teams when the Linear query succeeds', async () => {
-    const teams = [
-      { id: 'team_1', name: 'Engineering', key: 'ENG' },
-      { id: 'team_2', name: 'Design', key: 'DES' },
-    ];
-
-    const fetchMock = stubConnectionsThenLinear([buildConnection()], {
-      data: { teams: { nodes: teams } },
-    });
-
-    const result = await listLinearTeamsHandler();
-
-    expect(result).toEqual({ success: true, teams });
-    expect(fetchMock.mock.calls[1][1].headers.Authorization).toBe(
-      'Bearer lin_test_access_token',
-    );
-  });
-
-  it('returns success=false when no Linear connection exists', async () => {
-    stubConnectionsThenLinear([], { data: { teams: { nodes: [] } } });
-
-    const result = await listLinearTeamsHandler();
-
-    expect(result.success).toBe(false);
-  });
-
-  it('surfaces Linear errors', async () => {
-    stubConnectionsThenLinear([buildConnection()], {
-      errors: [{ message: 'rate limited' }],
-    });
-
-    const result = await listLinearTeamsHandler();
-
-    expect(result).toEqual({ success: false, error: 'rate limited' });
-  });
-});

packages/twenty-apps/internal/twenty-linear/src/logic-functions/__tests__/test-utils.ts

@@ -1,48 +0,0 @@
-import { vi } from 'vitest';
-
-export const USER_WORKSPACE_ID = '11111111-1111-1111-1111-111111111111';
-
-export const buildConnection = (
-  overrides: Partial<Record<string, unknown>> = {},
-) => ({
-  id: 'conn_1',
-  name: 'octocat@example.com',
-  visibility: 'user' as const,
-  providerName: 'linear',
-  userWorkspaceId: USER_WORKSPACE_ID,
-  accessToken: 'lin_test_access_token',
-  scopes: ['read', 'write'],
-  handle: 'octocat@example.com',
-  lastRefreshedAt: '2024-01-01T00:00:00.000Z',
-  authFailedAt: null,
-  ...overrides,
-});
-
-// Stubs `fetch` to first answer the SDK's `/apps/connections/list` call, then
-// the handler's downstream Linear GraphQL request.
-export const stubConnectionsThenLinear = (
-  connections: ReturnType<typeof buildConnection>[],
-  linearJson: unknown,
-) => {
-  const fetchMock = vi.fn(async (url: string) => {
-    if (url.endsWith('/apps/connections/list')) {
-      return {
-        ok: true,
-        status: 200,
-        json: async () => connections,
-        text: async () => JSON.stringify(connections),
-      };
-    }
-
-    return {
-      ok: true,
-      status: 200,
-      json: async () => linearJson,
-      text: async () => JSON.stringify(linearJson),
-    };
-  });
-
-  vi.stubGlobal('fetch', fetchMock);
-
-  return fetchMock;
-};

packages/twenty-apps/internal/twenty-linear/src/logic-functions/constants/issue-create-mutation.constant.ts

@@ -1,8 +0,0 @@
-export const ISSUE_CREATE_MUTATION = `
-  mutation IssueCreate($input: IssueCreateInput!) {
-    issueCreate(input: $input) {
-      success
-      issue { id identifier title url }
-    }
-  }
-`;

packages/twenty-apps/internal/twenty-linear/src/logic-functions/create-linear-issue.ts

@@ -1,34 +0,0 @@
-import { defineLogicFunction } from 'twenty-sdk/define';
-
-import { CREATE_LINEAR_ISSUE_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
-import { createLinearIssueHandler } from 'src/logic-functions/handlers/create-linear-issue-handler';
-
-export default defineLogicFunction({
-  universalIdentifier: CREATE_LINEAR_ISSUE_UNIVERSAL_IDENTIFIER,
-  name: 'create-linear-issue',
-  description:
-    'Create a Linear issue on behalf of the connected user. Requires a teamId (call list-linear-teams to discover one) and a title.',
-  timeoutSeconds: 30,
-  handler: createLinearIssueHandler,
-  toolTriggerSettings: {
-    inputSchema: {
-      type: 'object',
-      properties: {
-        teamId: {
-          type: 'string',
-          description:
-            'The Linear team ID to create the issue in. Use list-linear-teams to discover available teams.',
-        },
-        title: {
-          type: 'string',
-          description: 'The issue title.',
-        },
-        description: {
-          type: 'string',
-          description: 'Optional issue description (Markdown supported).',
-        },
-      },
-      required: ['teamId', 'title'],
-    },
-  },
-});

packages/twenty-apps/internal/twenty-linear/src/logic-functions/handlers/create-linear-issue-handler.ts

@@ -1,73 +0,0 @@
-import { listConnections } from 'twenty-sdk/logic-function';
-
-import { ISSUE_CREATE_MUTATION } from 'src/logic-functions/constants/issue-create-mutation.constant';
-import { type CreateIssueInput } from 'src/logic-functions/types/create-issue-input.type';
-import { type CreateIssueMutationResult } from 'src/logic-functions/types/create-issue-mutation-result.type';
-import { callLinearGraphQL } from 'src/logic-functions/utils/call-linear-graphql';
-
-type HandlerResult =
-  | {
-      success: true;
-      issue: {
-        id: string;
-        identifier: string;
-        title: string;
-        url: string;
-      };
-    }
-  | { success: false; error: string };
-
-export const createLinearIssueHandler = async (
-  input: CreateIssueInput,
-): Promise<HandlerResult> => {
-  if (!input.teamId || !input.title) {
-    return {
-      success: false,
-      error: 'Both `teamId` and `title` are required.',
-    };
-  }
-
-  const connections = await listConnections({ providerName: 'linear' });
-  // Workspace-shared credentials win when present (a team-managed service
-  // account); otherwise fall back to the first user-scoped connection.
-  const connection =
-    connections.find((c) => c.visibility === 'workspace') ?? connections[0];
-
-  if (!connection) {
-    return {
-      success: false,
-      error:
-        'Linear is not connected. Open the app settings and click "Add connection" first.',
-    };
-  }
-
-  const result = await callLinearGraphQL<CreateIssueMutationResult>({
-    accessToken: connection.accessToken,
-    query: ISSUE_CREATE_MUTATION,
-    variables: {
-      input: {
-        teamId: input.teamId,
-        title: input.title,
-        description: input.description,
-      },
-    },
-  });
-
-  if (result.errors || !result.data) {
-    return {
-      success: false,
-      error: result.errors?.[0]?.message ?? 'Unknown Linear API error',
-    };
-  }
-
-  const { success, issue } = result.data.issueCreate;
-
-  if (!success || !issue) {
-    return {
-      success: false,
-      error: 'Linear reported the mutation as unsuccessful.',
-    };
-  }
-
-  return { success: true, issue };
-};

packages/twenty-apps/internal/twenty-linear/src/logic-functions/handlers/list-linear-teams-handler.ts

@@ -1,49 +0,0 @@
-import { listConnections } from 'twenty-sdk/logic-function';
-
-import { callLinearGraphQL } from 'src/logic-functions/utils/call-linear-graphql';
-
-type LinearTeam = {
-  id: string;
-  name: string;
-  key: string;
-};
-
-type TeamsQueryResult = {
-  teams: { nodes: LinearTeam[] };
-};
-
-type HandlerResult =
-  | { success: true; teams: LinearTeam[] }
-  | { success: false; error: string };
-
-export const listLinearTeamsHandler = async (): Promise<HandlerResult> => {
-  const connections = await listConnections({ providerName: 'linear' });
-  const connection =
-    connections.find((c) => c.visibility === 'workspace') ?? connections[0];
-
-  if (!connection) {
-    return {
-      success: false,
-      error:
-        'Linear is not connected. Open the app settings and click "Add connection" first.',
-    };
-  }
-
-  const result = await callLinearGraphQL<TeamsQueryResult>({
-    accessToken: connection.accessToken,
-    query: `
-      query Teams {
-        teams { nodes { id name key } }
-      }
-    `,
-  });
-
-  if (result.errors || !result.data) {
-    return {
-      success: false,
-      error: result.errors?.[0]?.message ?? 'Unknown Linear API error',
-    };
-  }
-
-  return { success: true, teams: result.data.teams.nodes };
-};

packages/twenty-apps/internal/twenty-linear/src/logic-functions/list-linear-teams.ts

@@ -1,19 +0,0 @@
-import { defineLogicFunction } from 'twenty-sdk/define';
-
-import { LIST_LINEAR_TEAMS_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
-import { listLinearTeamsHandler } from 'src/logic-functions/handlers/list-linear-teams-handler';
-
-export default defineLogicFunction({
-  universalIdentifier: LIST_LINEAR_TEAMS_UNIVERSAL_IDENTIFIER,
-  name: 'list-linear-teams',
-  description:
-    "Returns the connected user's Linear teams. Useful for picking a teamId to pass to create-linear-issue.",
-  timeoutSeconds: 15,
-  handler: listLinearTeamsHandler,
-  toolTriggerSettings: {
-    inputSchema: {
-      type: 'object',
-      properties: {},
-    },
-  },
-});

packages/twenty-apps/internal/twenty-linear/src/logic-functions/types/create-issue-input.type.ts

@@ -1,5 +0,0 @@
-export type CreateIssueInput = {
-  teamId?: string;
-  title?: string;
-  description?: string;
-};

packages/twenty-apps/internal/twenty-linear/src/logic-functions/types/create-issue-mutation-result.type.ts

@@ -1,11 +0,0 @@
-export type CreateIssueMutationResult = {
-  issueCreate: {
-    success: boolean;
-    issue: {
-      id: string;
-      identifier: string;
-      title: string;
-      url: string;
-    } | null;
-  };
-};

packages/twenty-apps/internal/twenty-linear/src/logic-functions/utils/call-linear-graphql.ts

@@ -1,58 +0,0 @@
-import { type LinearGraphQLResult } from 'src/logic-functions/utils/types/linear-graphql-result.type';
-
-const LINEAR_GRAPHQL_ENDPOINT = 'https://api.linear.app/graphql';
-
-export const callLinearGraphQL = async <TData>({
-  accessToken,
-  query,
-  variables,
-}: {
-  accessToken: string;
-  query: string;
-  variables?: Record<string, unknown>;
-}): Promise<LinearGraphQLResult<TData>> => {
-  let response: Response;
-
-  try {
-    response = await fetch(LINEAR_GRAPHQL_ENDPOINT, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${accessToken}`,
-      },
-      body: JSON.stringify({ query, variables }),
-    });
-  } catch (error) {
-    return {
-      errors: [
-        {
-          message: `Linear API request failed: ${(error as Error).message}`,
-        },
-      ],
-    };
-  }
-
-  if (!response.ok) {
-    const text = await response.text().catch(() => '');
-
-    return {
-      errors: [
-        {
-          message: `Linear API responded with ${response.status}: ${text.slice(0, 500)}`,
-        },
-      ],
-    };
-  }
-
-  try {
-    return (await response.json()) as LinearGraphQLResult<TData>;
-  } catch (error) {
-    return {
-      errors: [
-        {
-          message: `Linear API returned a non-JSON response: ${(error as Error).message}`,
-        },
-      ],
-    };
-  }
-};

packages/twenty-apps/internal/twenty-linear/src/logic-functions/utils/types/linear-graphql-result.type.ts

@@ -1,4 +0,0 @@
-export type LinearGraphQLResult<TData> = {
-  data?: TData;
-  errors?: Array<{ message: string }>;
-};

packages/twenty-apps/internal/twenty-linear/src/roles/default-function.role.ts

@@ -1,22 +0,0 @@
-import { defineRole } from 'twenty-sdk/define';
-
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';
-
-// The Linear logic functions never read workspace data — they only call
-// Linear's GraphQL API on behalf of the connected user.
-export default defineRole({
-  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
-  label: 'Linear function role',
-  description: 'No-op role for Linear logic functions',
-  canReadAllObjectRecords: false,
-  canUpdateAllObjectRecords: false,
-  canSoftDeleteAllObjectRecords: false,
-  canDestroyAllObjectRecords: false,
-  canUpdateAllSettings: false,
-  canBeAssignedToAgents: false,
-  canBeAssignedToUsers: false,
-  canBeAssignedToApiKeys: false,
-  objectPermissions: [],
-  fieldPermissions: [],
-  permissionFlags: [],
-});

packages/twenty-apps/internal/twenty-linear/tsconfig.json

@@ -1,30 +0,0 @@
-{
-  "compileOnSave": false,
-  "compilerOptions": {
-    "sourceMap": true,
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": ".",
-    "moduleResolution": "bundler",
-    "allowSyntheticDefaultImports": true,
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "importHelpers": true,
-    "allowUnreachableCode": false,
-    "strict": true,
-    "alwaysStrict": true,
-    "noImplicitAny": true,
-    "strictBindCallApply": false,
-    "target": "es2020",
-    "module": "esnext",
-    "lib": ["es2020"],
-    "skipLibCheck": true,
-    "skipDefaultLibCheck": true,
-    "resolveJsonModule": true,
-    "paths": {
-      "src/*": ["./src/*"],
-      "~/*": ["./*"]
-    }
-  },
-  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
-}

packages/twenty-apps/internal/twenty-linear/tsconfig.spec.json

@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "composite": true,
-    "types": ["vitest/globals", "node"]
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}

packages/twenty-apps/internal/twenty-linear/vitest.unit.config.ts

@@ -1,43 +0,0 @@
-import path from 'node:path';
-
-import tsconfigPaths from 'vite-tsconfig-paths';
-import { defineConfig } from 'vitest/config';
-
-const TWENTY_SDK_SRC = path.resolve(
-  __dirname,
-  '../../../twenty-sdk/src/sdk',
-);
-
-// twenty-sdk's `exports` map points at compiled `./dist/*`. Aliasing the
-// subpaths to source keeps unit tests self-contained — no `yarn build` in
-// twenty-sdk required before running them.
-export default defineConfig({
-  plugins: [
-    tsconfigPaths({
-      projects: ['tsconfig.spec.json'],
-      ignoreConfigErrors: true,
-    }),
-  ],
-  resolve: {
-    alias: [
-      {
-        find: 'twenty-sdk/logic-function',
-        replacement: path.join(TWENTY_SDK_SRC, 'logic-function/index.ts'),
-      },
-      {
-        find: 'twenty-sdk/define',
-        replacement: path.join(TWENTY_SDK_SRC, 'define/index.ts'),
-      },
-      // The SDK source uses `@/*` to refer to its own `src/`. Vitest
-      // doesn't pick up the SDK's tsconfig path mapping when resolving
-      // a different package, so map the alias here.
-      {
-        find: /^@\/(.*)$/,
-        replacement: path.resolve(__dirname, '../../../twenty-sdk/src/$1'),
-      },
-    ],
-  },
-  test: {
-    include: ['src/**/*.test.ts'],
-  },
-});

packages/twenty-client-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twenty-client-sdk",
-  "version": "2.3.0",
+  "version": "2.0.0",
   "sideEffects": false,
   "license": "AGPL-3.0",
   "scripts": {
@@ -46,8 +46,6 @@
     "graphql": "^16.8.1"
   },
   "devDependencies": {
-    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
-    "tsc-alias": "^1.8.16",
     "twenty-shared": "workspace:*",
     "typescript": "^5.9.2",
     "vite": "^7.0.0",

packages/twenty-client-sdk/src/metadata/generated/schema.graphql

@@ -51,7 +51,6 @@ type ApplicationRegistration {
   logoUrl: String
   createdAt: DateTime!
   updatedAt: DateTime!
-  isConfigured: Boolean!
 }
 
 enum ApplicationRegistrationSourceType {
@@ -325,115 +324,6 @@ type FrontComponent {
   applicationTokenPair: ApplicationTokenPair
 }
 
-type CommandMenuItem {
-  id: UUID!
-  workflowVersionId: UUID
-  frontComponentId: UUID
-  frontComponent: FrontComponent
-  engineComponentKey: EngineComponentKey!
-  label: String!
-  icon: String
-  shortLabel: String
-  position: Float!
-  isPinned: Boolean!
-  availabilityType: CommandMenuItemAvailabilityType!
-  payload: CommandMenuItemPayload
-  hotKeys: [String!]
-  conditionalAvailabilityExpression: String
-  availabilityObjectMetadataId: UUID
-  pageLayoutId: UUID
-  universalIdentifier: UUID
-  applicationId: UUID
-  createdAt: DateTime!
-  updatedAt: DateTime!
-}
-
-enum EngineComponentKey {
-  NAVIGATE_TO_NEXT_RECORD
-  NAVIGATE_TO_PREVIOUS_RECORD
-  CREATE_NEW_RECORD
-  DELETE_RECORDS
-  RESTORE_RECORDS
-  DESTROY_RECORDS
-  ADD_TO_FAVORITES
-  REMOVE_FROM_FAVORITES
-  EXPORT_NOTE_TO_PDF
-  EXPORT_RECORDS
-  UPDATE_MULTIPLE_RECORDS
-  MERGE_MULTIPLE_RECORDS
-  IMPORT_RECORDS
-  EXPORT_VIEW
-  SEE_DELETED_RECORDS
-  CREATE_NEW_VIEW
-  HIDE_DELETED_RECORDS
-  EDIT_RECORD_PAGE_LAYOUT
-  EDIT_DASHBOARD_LAYOUT
-  SAVE_DASHBOARD_LAYOUT
-  CANCEL_DASHBOARD_LAYOUT
-  DUPLICATE_DASHBOARD
-  ACTIVATE_WORKFLOW
-  DEACTIVATE_WORKFLOW
-  DISCARD_DRAFT_WORKFLOW
-  TEST_WORKFLOW
-  SEE_ACTIVE_VERSION_WORKFLOW
-  SEE_RUNS_WORKFLOW
-  SEE_VERSIONS_WORKFLOW
-  ADD_NODE_WORKFLOW
-  TIDY_UP_WORKFLOW
-  DUPLICATE_WORKFLOW
-  SEE_VERSION_WORKFLOW_RUN
-  SEE_WORKFLOW_WORKFLOW_RUN
-  STOP_WORKFLOW_RUN
-  SEE_RUNS_WORKFLOW_VERSION
-  SEE_WORKFLOW_WORKFLOW_VERSION
-  USE_AS_DRAFT_WORKFLOW_VERSION
-  SEE_VERSIONS_WORKFLOW_VERSION
-  SEARCH_RECORDS
-  SEARCH_RECORDS_FALLBACK
-  ASK_AI
-  VIEW_PREVIOUS_AI_CHATS
-  NAVIGATION
-  TRIGGER_WORKFLOW_VERSION
-  FRONT_COMPONENT_RENDERER
-  REPLY_TO_EMAIL_THREAD
-  COMPOSE_EMAIL
-  GO_TO_PEOPLE
-  GO_TO_COMPANIES
-  GO_TO_DASHBOARDS
-  GO_TO_OPPORTUNITIES
-  GO_TO_SETTINGS
-  GO_TO_TASKS
-  GO_TO_NOTES
-  GO_TO_WORKFLOWS
-  GO_TO_RUNS
-  DELETE_SINGLE_RECORD
-  DELETE_MULTIPLE_RECORDS
-  RESTORE_SINGLE_RECORD
-  RESTORE_MULTIPLE_RECORDS
-  DESTROY_SINGLE_RECORD
-  DESTROY_MULTIPLE_RECORDS
-  EXPORT_FROM_RECORD_INDEX
-  EXPORT_FROM_RECORD_SHOW
-  EXPORT_MULTIPLE_RECORDS
-}
-
-enum CommandMenuItemAvailabilityType {
-  GLOBAL
-  GLOBAL_OBJECT_CONTEXT
-  RECORD_SELECTION
-  FALLBACK
-}
-
-union CommandMenuItemPayload = PathCommandMenuItemPayload | ObjectMetadataCommandMenuItemPayload
-
-type PathCommandMenuItemPayload {
-  path: String!
-}
-
-type ObjectMetadataCommandMenuItemPayload {
-  objectMetadataItemId: UUID!
-}
-
 type LogicFunction {
   id: UUID!
   name: String!
@@ -442,11 +332,11 @@ type LogicFunction {
   timeoutSeconds: Float!
   sourceHandlerPath: String!
   handlerName: String!
+  toolInputSchema: JSON
+  isTool: Boolean!
   cronTriggerSettings: JSON
   databaseEventTriggerSettings: JSON
   httpRouteTriggerSettings: JSON
-  toolTriggerSettings: JSON
-  workflowActionTriggerSettings: JSON
   applicationId: UUID
   universalIdentifier: UUID
   createdAt: DateTime!
@@ -690,7 +580,6 @@ type Application {
   id: UUID!
   name: String!
   description: String
-  logo: String
   version: String
   universalIdentifier: String!
   packageJsonChecksum: String
@@ -705,7 +594,6 @@ type Application {
   defaultLogicFunctionRole: Role
   agents: [Agent!]!
   frontComponents: [FrontComponent!]!
-  commandMenuItems: [CommandMenuItem!]!
   logicFunctions: [LogicFunction!]!
   objects: [Object!]!
   applicationVariables: [ApplicationVariable!]!
@@ -974,6 +862,7 @@ type User {
   firstName: String!
   lastName: String!
   email: String!
+  defaultAvatarUrl: String
   isEmailVerified: Boolean!
   disabled: Boolean
   canImpersonate: Boolean!
@@ -1403,20 +1292,6 @@ enum PageLayoutType {
   STANDALONE_PAGE
 }
 
-type ApplicationConnectionProviderOAuthConfig {
-  scopes: [String!]!
-  isClientCredentialsConfigured: Boolean!
-}
-
-type ApplicationConnectionProvider {
-  id: UUID!
-  applicationId: String!
-  type: String!
-  name: String!
-  displayName: String!
-  oauth: ApplicationConnectionProviderOAuthConfig
-}
-
 type Analytics {
   """Boolean that confirms query was dispatched"""
   success: Boolean!
@@ -2327,6 +2202,7 @@ type MarketplaceApp {
   id: String!
   name: String!
   description: String!
+  icon: String!
   author: String!
   category: String!
   logo: String
@@ -2435,6 +2311,114 @@ type PostgresCredentials {
   workspaceId: UUID!
 }
 
+type CommandMenuItem {
+  id: UUID!
+  workflowVersionId: UUID
+  frontComponentId: UUID
+  frontComponent: FrontComponent
+  engineComponentKey: EngineComponentKey!
+  label: String!
+  icon: String
+  shortLabel: String
+  position: Float!
+  isPinned: Boolean!
+  availabilityType: CommandMenuItemAvailabilityType!
+  payload: CommandMenuItemPayload
+  hotKeys: [String!]
+  conditionalAvailabilityExpression: String
+  availabilityObjectMetadataId: UUID
+  pageLayoutId: UUID
+  applicationId: UUID
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
+enum EngineComponentKey {
+  NAVIGATE_TO_NEXT_RECORD
+  NAVIGATE_TO_PREVIOUS_RECORD
+  CREATE_NEW_RECORD
+  DELETE_RECORDS
+  RESTORE_RECORDS
+  DESTROY_RECORDS
+  ADD_TO_FAVORITES
+  REMOVE_FROM_FAVORITES
+  EXPORT_NOTE_TO_PDF
+  EXPORT_RECORDS
+  UPDATE_MULTIPLE_RECORDS
+  MERGE_MULTIPLE_RECORDS
+  IMPORT_RECORDS
+  EXPORT_VIEW
+  SEE_DELETED_RECORDS
+  CREATE_NEW_VIEW
+  HIDE_DELETED_RECORDS
+  EDIT_RECORD_PAGE_LAYOUT
+  EDIT_DASHBOARD_LAYOUT
+  SAVE_DASHBOARD_LAYOUT
+  CANCEL_DASHBOARD_LAYOUT
+  DUPLICATE_DASHBOARD
+  ACTIVATE_WORKFLOW
+  DEACTIVATE_WORKFLOW
+  DISCARD_DRAFT_WORKFLOW
+  TEST_WORKFLOW
+  SEE_ACTIVE_VERSION_WORKFLOW
+  SEE_RUNS_WORKFLOW
+  SEE_VERSIONS_WORKFLOW
+  ADD_NODE_WORKFLOW
+  TIDY_UP_WORKFLOW
+  DUPLICATE_WORKFLOW
+  SEE_VERSION_WORKFLOW_RUN
+  SEE_WORKFLOW_WORKFLOW_RUN
+  STOP_WORKFLOW_RUN
+  SEE_RUNS_WORKFLOW_VERSION
+  SEE_WORKFLOW_WORKFLOW_VERSION
+  USE_AS_DRAFT_WORKFLOW_VERSION
+  SEE_VERSIONS_WORKFLOW_VERSION
+  SEARCH_RECORDS
+  SEARCH_RECORDS_FALLBACK
+  ASK_AI
+  VIEW_PREVIOUS_AI_CHATS
+  NAVIGATION
+  TRIGGER_WORKFLOW_VERSION
+  FRONT_COMPONENT_RENDERER
+  REPLY_TO_EMAIL_THREAD
+  COMPOSE_EMAIL
+  GO_TO_PEOPLE
+  GO_TO_COMPANIES
+  GO_TO_DASHBOARDS
+  GO_TO_OPPORTUNITIES
+  GO_TO_SETTINGS
+  GO_TO_TASKS
+  GO_TO_NOTES
+  GO_TO_WORKFLOWS
+  GO_TO_RUNS
+  DELETE_SINGLE_RECORD
+  DELETE_MULTIPLE_RECORDS
+  RESTORE_SINGLE_RECORD
+  RESTORE_MULTIPLE_RECORDS
+  DESTROY_SINGLE_RECORD
+  DESTROY_MULTIPLE_RECORDS
+  EXPORT_FROM_RECORD_INDEX
+  EXPORT_FROM_RECORD_SHOW
+  EXPORT_MULTIPLE_RECORDS
+}
+
+enum CommandMenuItemAvailabilityType {
+  GLOBAL
+  GLOBAL_OBJECT_CONTEXT
+  RECORD_SELECTION
+  FALLBACK
+}
+
+union CommandMenuItemPayload = PathCommandMenuItemPayload | ObjectMetadataCommandMenuItemPayload
+
+type PathCommandMenuItemPayload {
+  path: String!
+}
+
+type ObjectMetadataCommandMenuItemPayload {
+  objectMetadataItemId: UUID!
+}
+
 type ToolIndexEntry {
   name: String!
   description: String!
@@ -2553,10 +2537,6 @@ type ConnectedAccountDTO {
   connectionParameters: ImapSmtpCaldavConnectionParameters
   lastSignedInAt: DateTime
   userWorkspaceId: UUID!
-  connectionProviderId: UUID
-  applicationId: UUID
-  name: String
-  visibility: String!
   createdAt: DateTime!
   updatedAt: DateTime!
 }
@@ -2584,10 +2564,6 @@ type ConnectedAccountPublicDTO {
   scopes: [String!]
   lastSignedInAt: DateTime
   userWorkspaceId: UUID!
-  connectionProviderId: UUID
-  applicationId: UUID
-  name: String
-  visibility: String!
   createdAt: DateTime!
   updatedAt: DateTime!
   connectionParameters: PublicImapSmtpCaldavConnectionParameters
@@ -2633,6 +2609,19 @@ type Skill {
   updatedAt: DateTime!
 }
 
+type AgentChatThread {
+  id: UUID!
+  title: String
+  totalInputTokens: Int!
+  totalOutputTokens: Int!
+  contextWindowTokens: Int
+  conversationSize: Int!
+  totalInputCredits: Float!
+  totalOutputCredits: Float!
+  createdAt: DateTime!
+  updatedAt: DateTime!
+}
+
 type AgentMessage {
   id: UUID!
   threadId: UUID!
@@ -2645,21 +2634,6 @@ type AgentMessage {
   createdAt: DateTime!
 }
 
-type AgentChatThread {
-  id: ID!
-  title: String
-  totalInputTokens: Int!
-  totalOutputTokens: Int!
-  contextWindowTokens: Int
-  conversationSize: Int!
-  totalInputCredits: Float!
-  totalOutputCredits: Float!
-  createdAt: DateTime!
-  updatedAt: DateTime!
-  deletedAt: DateTime
-  lastMessageAt: DateTime
-}
-
 type AiSystemPromptSection {
   title: String!
   content: String!
@@ -2687,6 +2661,22 @@ type AgentChatEvent {
   event: JSON!
 }
 
+type AgentChatThreadEdge {
+  """The node containing the AgentChatThread"""
+  node: AgentChatThread!
+
+  """Cursor for this node."""
+  cursor: ConnectionCursor!
+}
+
+type AgentChatThreadConnection {
+  """Paging information"""
+  pageInfo: PageInfo!
+
+  """Array of edges."""
+  edges: [AgentChatThreadEdge!]!
+}
+
 type AgentTurnEvaluation {
   id: UUID!
   turnId: UUID!
@@ -2873,8 +2863,6 @@ enum AllMetadataName {
   fieldPermission
   frontComponent
   webhook
-  applicationVariable
-  connectionProvider
 }
 
 type MinimalObjectMetadata {
@@ -2945,7 +2933,6 @@ type Query {
   getPageLayoutTab(id: String!): PageLayoutTab!
   getPageLayouts(objectMetadataId: String, pageLayoutType: PageLayoutType): [PageLayout!]!
   getPageLayout(id: String!): PageLayout
-  applicationConnectionProviders(applicationId: UUID!): [ApplicationConnectionProvider!]!
   getPageLayoutWidgets(pageLayoutTabId: String!): [PageLayoutWidget!]!
   getPageLayoutWidget(id: String!): PageLayoutWidget!
   findOneLogicFunction(input: LogicFunctionIdInput!): LogicFunction!
@@ -3006,13 +2993,22 @@ type Query {
   webhooks: [Webhook!]!
   webhook(id: UUID!): Webhook
   minimalMetadata: MinimalMetadata!
-  chatThreads: [AgentChatThread!]!
   chatThread(id: UUID!): AgentChatThread!
   chatMessages(threadId: UUID!): [AgentMessage!]!
   chatStreamCatchupChunks(threadId: UUID!): ChatStreamCatchupChunks!
   getAiSystemPromptPreview: AiSystemPromptPreview!
   skills: [Skill!]!
   skill(id: UUID!): Skill
+  chatThreads(
+    """Limit or page results."""
+    paging: CursorPaging! = {first: 10}
+
+    """Specify to filter the records returned."""
+    filter: AgentChatThreadFilter! = {}
+
+    """Specify to sort results."""
+    sorting: [AgentChatThreadSort!]! = [{field: updatedAt, direction: DESC}]
+  ): AgentChatThreadConnection!
   agentTurns(agentId: UUID!): [AgentTurn!]!
   checkUserExists(email: String!, captchaToken: String): CheckUserExist!
   checkWorkspaceInviteHashIsValid(inviteHash: String!): WorkspaceInviteHashValid!
@@ -3061,6 +3057,56 @@ input AgentIdInput {
   id: UUID!
 }
 
+input AgentChatThreadFilter {
+  and: [AgentChatThreadFilter!]
+  or: [AgentChatThreadFilter!]
+  id: UUIDFilterComparison
+  updatedAt: DateFieldComparison
+}
+
+input DateFieldComparison {
+  is: Boolean
+  isNot: Boolean
+  eq: DateTime
+  neq: DateTime
+  gt: DateTime
+  gte: DateTime
+  lt: DateTime
+  lte: DateTime
+  in: [DateTime!]
+  notIn: [DateTime!]
+  between: DateFieldComparisonBetween
+  notBetween: DateFieldComparisonBetween
+}
+
+input DateFieldComparisonBetween {
+  lower: DateTime!
+  upper: DateTime!
+}
+
+input AgentChatThreadSort {
+  field: AgentChatThreadSortFields!
+  direction: SortDirection!
+  nulls: SortNulls
+}
+
+enum AgentChatThreadSortFields {
+  id
+  updatedAt
+}
+
+"""Sort Directions"""
+enum SortDirection {
+  ASC
+  DESC
+}
+
+"""Sort Nulls Options"""
+enum SortNulls {
+  NULLS_FIRST
+  NULLS_LAST
+}
+
 input EventLogQueryInput {
   table: EventLogTable!
   filters: EventLogFiltersInput
@@ -3147,7 +3193,6 @@ type Mutation {
   updateView(id: String!, input: UpdateViewInput!): View!
   deleteView(id: String!): Boolean!
   destroyView(id: String!): Boolean!
-  upsertViewWidget(input: UpsertViewWidgetInput!): View!
   createViewSort(input: CreateViewSortInput!): ViewSort!
   updateViewSort(input: UpdateViewSortInput!): ViewSort!
   deleteViewSort(input: DeleteViewSortInput!): Boolean!
@@ -3197,7 +3242,6 @@ type Mutation {
   resetPageLayoutToDefault(id: String!): PageLayout!
   resetPageLayoutWidgetToDefault(id: String!): PageLayoutWidget!
   resetPageLayoutTabToDefault(id: String!): PageLayoutTab!
-  updateOneApplicationVariable(key: String!, value: String!, applicationId: UUID!): Boolean!
   createPageLayoutWidget(input: CreatePageLayoutWidgetInput!): PageLayoutWidget!
   updatePageLayoutWidget(id: String!, input: UpdatePageLayoutWidgetInput!): PageLayoutWidget!
   destroyPageLayoutWidget(id: String!): Boolean!
@@ -3247,10 +3291,6 @@ type Mutation {
   createChatThread: AgentChatThread!
   sendChatMessage(threadId: UUID!, text: String!, messageId: UUID!, browsingContext: JSON, modelId: String, fileIds: [UUID!]): SendChatMessageResult!
   stopAgentChatStream(threadId: UUID!): Boolean!
-  renameChatThread(id: UUID!, title: String!): AgentChatThread!
-  archiveChatThread(id: UUID!): AgentChatThread!
-  unarchiveChatThread(id: UUID!): AgentChatThread!
-  deleteChatThread(id: UUID!): Boolean!
   deleteQueuedChatMessage(messageId: UUID!): Boolean!
   createSkill(input: CreateSkillInput!): Skill!
   updateSkill(input: UpdateSkillInput!): Skill!
@@ -3300,6 +3340,7 @@ type Mutation {
   installApplication(appRegistrationId: String!, version: String): Boolean!
   runWorkspaceMigration(workspaceMigration: WorkspaceMigrationInput!): Boolean!
   uninstallApplication(universalIdentifier: String!): Boolean!
+  updateOneApplicationVariable(key: String!, value: String!, applicationId: UUID!): Boolean!
   createOIDCIdentityProvider(input: SetupOIDCSsoInput!): SetupSso!
   createSAMLIdentityProvider(input: SetupSAMLSsoInput!): SetupSso!
   deleteSSOIdentityProvider(input: DeleteSsoInput!): DeleteSso!
@@ -3469,59 +3510,6 @@ input UpdateViewInput {
   shouldHideEmptyGroups: Boolean
 }
 
-input UpsertViewWidgetInput {
-  """The id of the view widget (page layout widget)."""
-  widgetId: UUID!
-
-  """The view fields to upsert."""
-  viewFields: [UpsertViewWidgetViewFieldInput!]
-
-  """The view filters to upsert."""
-  viewFilters: [UpsertViewWidgetViewFilterInput!]
-
-  """The view filter groups to upsert."""
-  viewFilterGroups: [UpsertViewWidgetViewFilterGroupInput!]
-
-  """The view sorts to upsert."""
-  viewSorts: [UpsertViewWidgetViewSortInput!]
-}
-
-input UpsertViewWidgetViewFieldInput {
-  """The id of an existing view field to update."""
-  viewFieldId: UUID
-
-  """
-  The field metadata id. Used to create a new view field when viewFieldId is not provided.
-  """
-  fieldMetadataId: UUID
-  isVisible: Boolean!
-  position: Float!
-  size: Float
-}
-
-input UpsertViewWidgetViewFilterInput {
-  id: UUID
-  fieldMetadataId: UUID!
-  operand: ViewFilterOperand = CONTAINS
-  value: JSON!
-  viewFilterGroupId: UUID
-  positionInViewFilterGroup: Float
-  subFieldName: String
-}
-
-input UpsertViewWidgetViewFilterGroupInput {
-  id: UUID
-  parentViewFilterGroupId: UUID
-  logicalOperator: ViewFilterGroupLogicalOperator = AND
-  positionInViewFilterGroup: Float
-}
-
-input UpsertViewWidgetViewSortInput {
-  id: UUID
-  fieldMetadataId: UUID!
-  direction: ViewSortDirection = ASC
-}
-
 input CreateViewSortInput {
   id: UUID
   fieldMetadataId: UUID!
@@ -3783,12 +3771,12 @@ input CreateLogicFunctionFromSourceInput {
   name: String!
   description: String
   timeoutSeconds: Float
+  toolInputSchema: JSON
+  isTool: Boolean
   source: JSON
   cronTriggerSettings: JSON
   databaseEventTriggerSettings: JSON
   httpRouteTriggerSettings: JSON
-  toolTriggerSettings: JSON
-  workflowActionTriggerSettings: JSON
 }
 
 input ExecuteOneLogicFunctionInput {
@@ -3812,13 +3800,13 @@ input UpdateLogicFunctionFromSourceInputUpdates {
   description: String
   timeoutSeconds: Float
   sourceHandlerCode: String
+  toolInputSchema: JSON
   handlerName: String
   sourceHandlerPath: String
+  isTool: Boolean
   cronTriggerSettings: JSON
   databaseEventTriggerSettings: JSON
   httpRouteTriggerSettings: JSON
-  toolTriggerSettings: JSON
-  workflowActionTriggerSettings: JSON
 }
 
 input CreateCommandMenuItemInput {

packages/twenty-docker/Makefile

@@ -26,11 +26,11 @@ prod-run:
 prod-postgres-run:
 	@docker run -d -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres --name twenty-postgres twenty-postgres:$(TAG)
 
-prod-website-new-build:
-	@cd ../.. && docker build -f ./packages/twenty-docker/twenty-website-new/Dockerfile --platform $(PLATFORM) --tag twenty-website-new:$(TAG) . && cd -
+prod-website-build:
+	@cd ../.. && docker build -f ./packages/twenty-docker/twenty-website/Dockerfile --platform $(PLATFORM) --tag twenty-website:$(TAG) . && cd -
 
-prod-website-new-run:
-	@docker run -d -p 3000:3000 --name twenty-website-new twenty-website-new:$(TAG)
+prod-website-run:
+	@docker run -d -p 3000:3000 --name twenty-website twenty-website:$(TAG)
 
 # =============================================================================
 # Local Development Services

packages/twenty-docker/twenty-app-dev/rootfs/etc/s6-overlay/scripts/init-db.sh

@@ -34,27 +34,25 @@ has_schema=$(PGPASSWORD=twenty psql -h localhost -U twenty -d default -tAc \
   "SELECT EXISTS (SELECT 1 FROM information_schema.schemata WHERE schema_name = 'core')")
 
 if [ "$has_schema" = "f" ]; then
-  step_start "Running initial database setup and migrations"
-  yarn database:init:prod
+  step_start "Running initial database setup"
+  NODE_OPTIONS="--max-old-space-size=1500" node ./dist/database/scripts/setup-db.js
   step_done
 fi
 
+step_start "Running migrations"
+yarn database:migrate:prod --force
+step_done
+
 step_start "Flushing cache"
-if ! yarn command:prod cache:flush; then
-  echo "Warning: Failed to flush cache before upgrade, but continuing startup..."
-fi
+yarn command:prod cache:flush
 step_done
 
 step_start "Running upgrade"
-if ! yarn command:prod upgrade; then
-  echo "Warning: Upgrade completed with errors. Some workspaces may not be fully migrated. Check logs for details."
-fi
+yarn command:prod upgrade
 step_done
 
 step_start "Flushing cache"
-if ! yarn command:prod cache:flush; then
-  echo "Warning: Failed to flush cache after upgrade, but continuing startup..."
-fi
+yarn command:prod cache:flush
 step_done
 
 # Only seed on first boot — check if the dev workspace already exists

packages/twenty-docker/twenty-app-dev/rootfs/etc/s6-overlay/scripts/register-crons.sh

@@ -4,6 +4,6 @@ set -e
 echo "==> START Registering cron jobs"
 
 cd /app/packages/twenty-server
-yarn command:prod cron:register:all
+yarn command:prod cron:register:all --dev-mode
 
 echo "==> DONE"

packages/twenty-docker/twenty-website-new/Dockerfile

@@ -11,12 +11,10 @@ COPY ./nx.json .
 COPY ./.yarn/releases /app/.yarn/releases
 COPY ./.yarn/patches /app/.yarn/patches
 COPY ./packages/twenty-oxlint-rules /app/packages/twenty-oxlint-rules
-COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/package.json
 COPY ./packages/twenty-website-new/package.json /app/packages/twenty-website-new/package.json
 
 RUN yarn
 
-COPY ./packages/twenty-shared /app/packages/twenty-shared
 COPY ./packages/twenty-website-new /app/packages/twenty-website-new
 RUN npx nx build twenty-website-new
 

packages/twenty-docker/twenty-website/Dockerfile

@@ -0,0 +1,43 @@
+FROM node:24-alpine AS twenty-website-build
+
+
+WORKDIR /app
+
+COPY ./package.json .
+COPY ./yarn.lock .
+COPY ./.yarnrc.yml .
+COPY ./.yarn/releases /app/.yarn/releases
+COPY ./.yarn/patches /app/.yarn/patches
+COPY ./packages/twenty-oxlint-rules /app/packages/twenty-oxlint-rules
+COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
+COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
+COPY ./packages/twenty-website/package.json /app/packages/twenty-website/package.json
+
+RUN yarn
+
+ENV KEYSTATIC_GITHUB_CLIENT_ID="<fake build value>"
+ENV KEYSTATIC_GITHUB_CLIENT_SECRET="<fake build value>"
+ENV KEYSTATIC_SECRET="<fake build value>"
+ENV NEXT_PUBLIC_KEYSTATIC_GITHUB_APP_SLUG="<fake build value>"
+
+COPY ./packages/twenty-ui /app/packages/twenty-ui
+COPY ./packages/twenty-website /app/packages/twenty-website
+RUN npx nx build twenty-website
+
+FROM node:24-alpine AS twenty-website
+
+WORKDIR /app/packages/twenty-website
+
+COPY --from=twenty-website-build /app /app
+
+WORKDIR /app/packages/twenty-website
+
+LABEL org.opencontainers.image.source=https://github.com/twentyhq/twenty
+LABEL org.opencontainers.image.description="This image provides a consistent and reproducible environment for the website."
+
+RUN chown -R 1000 /app
+
+# Use non root user with uid 1000
+USER 1000
+
+CMD ["/bin/sh", "-c", "npx nx start"]

packages/twenty-docker/twenty/Dockerfile

@@ -1,26 +1,8 @@
 # ===========================================================================
-# Dependency stages
+# Shared build stages (used by both targets)
 # ===========================================================================
 
-FROM node:24-alpine AS front-deps
-
-WORKDIR /app
-
-COPY ./package.json ./yarn.lock ./.yarnrc.yml ./tsconfig.base.json ./nx.json /app/
-COPY ./.yarn/releases /app/.yarn/releases
-COPY ./.yarn/patches /app/.yarn/patches
-
-COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
-COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
-COPY ./packages/twenty-front/package.json /app/packages/twenty-front/
-COPY ./packages/twenty-front-component-renderer/package.json /app/packages/twenty-front-component-renderer/
-COPY ./packages/twenty-sdk/package.json /app/packages/twenty-sdk/
-COPY ./packages/twenty-client-sdk/package.json /app/packages/twenty-client-sdk/
-
-RUN yarn workspaces focus twenty twenty-front twenty-front-component-renderer twenty-ui twenty-shared twenty-sdk twenty-client-sdk && yarn cache clean && npx nx reset
-
-
-FROM node:24-alpine AS server-deps
+FROM node:24-alpine AS common-deps
 
 WORKDIR /app
 
@@ -31,16 +13,22 @@ COPY ./.yarn/patches /app/.yarn/patches
 COPY ./packages/twenty-emails/package.json /app/packages/twenty-emails/
 COPY ./packages/twenty-server/package.json /app/packages/twenty-server/
 COPY ./packages/twenty-server/patches /app/packages/twenty-server/patches
+COPY ./packages/twenty-ui/package.json /app/packages/twenty-ui/
 COPY ./packages/twenty-shared/package.json /app/packages/twenty-shared/
+COPY ./packages/twenty-front/package.json /app/packages/twenty-front/
+COPY ./packages/twenty-front-component-renderer/package.json /app/packages/twenty-front-component-renderer/
+COPY ./packages/twenty-sdk/package.json /app/packages/twenty-sdk/
 COPY ./packages/twenty-client-sdk/package.json /app/packages/twenty-client-sdk/
 
-RUN yarn workspaces focus twenty twenty-server twenty-emails twenty-shared twenty-client-sdk && yarn cache clean && npx nx reset
+RUN yarn && yarn cache clean && npx nx reset
 
 
-FROM server-deps AS twenty-server-build
+FROM common-deps AS twenty-server-build
 
 COPY ./packages/twenty-emails /app/packages/twenty-emails
 COPY ./packages/twenty-shared /app/packages/twenty-shared
+COPY ./packages/twenty-ui /app/packages/twenty-ui
+COPY ./packages/twenty-sdk /app/packages/twenty-sdk
 COPY ./packages/twenty-client-sdk /app/packages/twenty-client-sdk
 COPY ./packages/twenty-server /app/packages/twenty-server
 
@@ -56,10 +44,12 @@ RUN npx nx run twenty-server:build
 RUN find /app/packages/twenty-server/dist -name '*.d.ts' -delete \
  && rm -rf /app/packages/twenty-server/dist/packages/twenty-server/test
 
-RUN yarn workspaces focus --production twenty-emails twenty-shared twenty-client-sdk twenty-server
+RUN yarn workspaces focus --production twenty-emails twenty-shared twenty-sdk twenty-client-sdk twenty-server
 
 
-FROM front-deps AS twenty-front-build
+FROM common-deps AS twenty-front-build
+
+ARG REACT_APP_SERVER_BASE_URL
 
 COPY ./packages/twenty-front /app/packages/twenty-front
 COPY ./packages/twenty-front-component-renderer /app/packages/twenty-front-component-renderer
@@ -111,8 +101,11 @@ COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-shared/package
 COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-shared/dist /app/packages/twenty-shared/dist
 COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-emails/package.json /app/packages/twenty-emails/
 COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-emails/dist /app/packages/twenty-emails/dist
+COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-sdk/package.json /app/packages/twenty-sdk/
 COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-client-sdk/package.json /app/packages/twenty-client-sdk/
 COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-client-sdk/dist /app/packages/twenty-client-sdk/dist
+COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-ui/package.json /app/packages/twenty-ui/
+COPY --chown=1000 --from=twenty-server-build /app/packages/twenty-front/package.json /app/packages/twenty-front/
 
 LABEL org.opencontainers.image.source=https://github.com/twentyhq/twenty
 LABEL org.opencontainers.image.description="Twenty server image (no frontend)."
@@ -145,6 +138,9 @@ USER 1000
 
 FROM twenty-server AS twenty
 
+ARG REACT_APP_SERVER_BASE_URL
+ENV REACT_APP_SERVER_BASE_URL=$REACT_APP_SERVER_BASE_URL
+
 COPY --chown=1000 --from=twenty-front-build /app/packages/twenty-front/build /app/packages/twenty-server/dist/front
 
 LABEL org.opencontainers.image.description="Twenty image with backend and frontend."
@@ -217,8 +213,11 @@ COPY --from=twenty-server-build /app/packages/twenty-shared/package.json /app/pa
 COPY --from=twenty-server-build /app/packages/twenty-shared/dist /app/packages/twenty-shared/dist
 COPY --from=twenty-server-build /app/packages/twenty-emails/package.json /app/packages/twenty-emails/
 COPY --from=twenty-server-build /app/packages/twenty-emails/dist /app/packages/twenty-emails/dist
+COPY --from=twenty-server-build /app/packages/twenty-sdk/package.json /app/packages/twenty-sdk/
 COPY --from=twenty-server-build /app/packages/twenty-client-sdk/package.json /app/packages/twenty-client-sdk/
 COPY --from=twenty-server-build /app/packages/twenty-client-sdk/dist /app/packages/twenty-client-sdk/dist
+COPY --from=twenty-server-build /app/packages/twenty-ui/package.json /app/packages/twenty-ui/
+COPY --from=twenty-server-build /app/packages/twenty-front/package.json /app/packages/twenty-front/
 
 # Frontend static build
 COPY --from=twenty-front-build /app/packages/twenty-front/build /app/packages/twenty-server/dist/front
@@ -233,6 +232,7 @@ RUN mkdir -p /data/postgres /data/redis /app/packages/twenty-server/.local-stora
  && chown -R postgres:postgres /data/postgres \
  && chown 1000:1000 /data/redis /app/packages/twenty-server/.local-storage
 
+ARG REACT_APP_SERVER_BASE_URL
 ARG APP_VERSION=0.0.0
 
 ENV S6_KEEP_ENV=1
@@ -241,6 +241,7 @@ ENV PG_DATABASE_URL=postgres://twenty:twenty@localhost:5432/default \
     REDIS_URL=redis://localhost:6379 \
     STORAGE_TYPE=local \
     APP_SECRET=twenty-app-dev-secret-not-for-production \
+    REACT_APP_SERVER_BASE_URL=$REACT_APP_SERVER_BASE_URL \
     APP_VERSION=$APP_VERSION \
     NODE_ENV=development \
     NODE_PORT=2020 \

packages/twenty-docker/twenty/entrypoint.sh

@@ -16,17 +16,9 @@ setup_and_migrate_db() {
         yarn database:init:prod
     fi
 
-    if ! yarn command:prod cache:flush; then
-        echo "Warning: Failed to flush cache before upgrade, but continuing startup..."
-    fi
-
-    if ! yarn command:prod upgrade; then
-        echo "Warning: Upgrade completed with errors. Some workspaces may not be fully migrated. Check logs for details."
-    fi
-
-    if ! yarn command:prod cache:flush; then
-        echo "Warning: Failed to flush cache after upgrade, but continuing startup..."
-    fi
+    yarn command:prod cache:flush
+    yarn command:prod upgrade
+    yarn command:prod cache:flush
 
     echo "Successfully migrated DB!"
 }

packages/twenty-docs/MIGRATION.md

@@ -77,10 +77,14 @@ To deploy to Mintlify:
 3. Set subdirectory to `packages/twenty-docs`
 4. Mintlify will auto-deploy and generate search embeddings
 
-## Status
+## Next Steps
 
-This migration has been completed. The legacy `packages/twenty-website` package
-has been removed, and documentation now lives in `packages/twenty-docs`.
+1. **Manual Review** - Check for any component conversion issues
+2. **Fix Image Paths** - Verify all images render correctly
+3. **Test Navigation** - Ensure all internal links work
+4. **Deploy** - Push to production Mintlify
+5. **Update Helper Agent** - Verify searchArticles tool works with full content
+6. **Deprecate twenty-website docs** - Once migration is confirmed working
 
 ## Known Issues to Review
 
@@ -88,3 +92,4 @@ has been removed, and documentation now lives in `packages/twenty-docs`.
 - Some images may have incorrect paths
 - Custom styled components may need adjustment
 - Video embeds might need review
+

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

@@ -1,193 +0,0 @@
----
-title: Connections
-description: Let your app act on a user's behalf in third-party services via OAuth.
-icon: 'plug'
----
-
-Connections are credentials a user holds for an external service (Linear, GitHub, Slack, ...). Your app declares **how** those credentials are obtained — a **connection provider** — and consumes them at runtime to make authenticated calls to the third-party API.
-
-Today only OAuth 2.0 is supported. Future credential types (personal access tokens, API keys, basic auth) will plug into the same surface — apps already using `defineConnectionProvider({ type: 'oauth', ... })` won't need to migrate.
-
-<AccordionGroup>
-
-<Accordion title="defineConnectionProvider" description="Declare how your app's connections are obtained">
-
-A connection provider describes the OAuth handshake your app needs. The user clicks "Add connection" in your app's settings, completes the provider's consent screen, and a `ConnectedAccount` row is created in their workspace.
-
-A working setup needs **two files** — the connection provider, and a matching `serverVariables` declaration on `defineApplication` that holds the OAuth client credentials.
-
-```ts src/connection-providers/linear-connection.ts
-import { defineConnectionProvider } from 'twenty-sdk/define';
-
-export default defineConnectionProvider({
-  universalIdentifier: '9c7d1f5e-6a0b-4d44-be0c-3f8b5a9d4e6f',
-  name: 'linear',
-  displayName: 'Linear',
-  icon: 'IconBrandLinear',
-  type: 'oauth',
-  oauth: {
-    authorizationEndpoint: 'https://linear.app/oauth/authorize',
-    tokenEndpoint: 'https://api.linear.app/oauth/token',
-    scopes: ['read', 'write'],
-    // These must match keys in `defineApplication.serverVariables` below.
-    clientIdVariable: 'LINEAR_CLIENT_ID',
-    clientSecretVariable: 'LINEAR_CLIENT_SECRET',
-    // Optional: defaults to 'json'. Some providers (Linear, Slack) want
-    // 'form-urlencoded' for the token request.
-    tokenRequestContentType: 'form-urlencoded',
-    // Optional: defaults to true. Disable only if the provider rejects PKCE.
-    usePkce: false,
-    // Optional: extra query params on the authorize URL.
-    // authorizationParams: { prompt: 'consent' },
-    // Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.
-    // revokeEndpoint: 'https://example.com/oauth/revoke',
-  },
-});
-```
-
-```ts src/application.config.ts
-import { defineApplication } from 'twenty-sdk/define';
-
-export default defineApplication({
-  universalIdentifier: '...',
-  displayName: 'Linear',
-  description: 'Connect Linear to Twenty.',
-  defaultRoleUniversalIdentifier: '...',
-  // OAuth client credentials live on the app registration (one OAuth app per
-  // Twenty server, configured by the admin) — not per-workspace. Declare them
-  // as serverVariables so the admin can fill them in once for all installs.
-  serverVariables: {
-    LINEAR_CLIENT_ID: {
-      description: 'OAuth client ID from your Linear OAuth application.',
-      isSecret: false,
-      isRequired: true,
-    },
-    LINEAR_CLIENT_SECRET: {
-      description: 'OAuth client secret from your Linear OAuth application.',
-      isSecret: true,
-      isRequired: true,
-    },
-  },
-});
-```
-
-Key points:
-
-- `name` is the unique identifier string used in `listConnections({ providerName })` (kebab-case, must match `^[a-z][a-z0-9-]*$`).
-- `displayName` shows in the per-app settings tab and in the AI tool list.
-- `clientIdVariable` / `clientSecretVariable` are **names**, not values — they must match keys declared in `defineApplication.serverVariables`. The actual `client_id` and `client_secret` are entered by the server admin through the app registration UI, never committed to your repo.
-- Use `serverVariables` (not `applicationVariables`) — OAuth credentials are server-wide and one OAuth app per Twenty server.
-- Until both `serverVariables` are filled in, the per-app settings tab shows a "needs server admin" hint and the "Add connection" button is disabled.
-- `type: 'oauth'` is the only supported value today. The discriminator is forward-compatible: future types (`'pat'`, `'api-key'`, ...) will add new sub-config blocks alongside `oauth`.
-
-The OAuth callback URL your provider needs to whitelist is:
-
-```
-https://<your-twenty-server>/apps/oauth/callback
-```
-
-</Accordion>
-
-<Accordion title="listConnections / getConnection" description="Use connections from a logic function">
-
-Inside a logic function handler, `listConnections({ providerName })` returns this app's `ConnectedAccount` rows for the given provider, with refreshed access tokens.
-
-```ts src/logic-functions/handlers/create-linear-issue-handler.ts
-import { listConnections } from 'twenty-sdk/logic-function';
-
-export const createLinearIssueHandler = async (input: {
-  teamId?: string;
-  title?: string;
-}) => {
-  if (!input.teamId || !input.title) {
-    return { success: false, error: 'teamId and title are required' };
-  }
-
-  const connections = await listConnections({ providerName: 'linear' });
-
-  // Workspace-shared credentials win when present; fall back to the first
-  // user-visibility one. For HTTP-route triggers you typically pick the
-  // request user's connection via event.userWorkspaceId instead.
-  const connection =
-    connections.find((c) => c.visibility === 'workspace') ?? connections[0];
-
-  if (!connection) {
-    return {
-      success: false,
-      error:
-        'Linear is not connected. Open the app settings and click "Add connection".',
-    };
-  }
-
-  // Use connection.accessToken to call the third-party API.
-  const response = await fetch('https://api.linear.app/graphql', {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${connection.accessToken}`,
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify({
-      query: `mutation { issueCreate(input: { teamId: "${input.teamId}", title: "${input.title}" }) { success } }`,
-    }),
-  });
-
-  return { success: response.ok };
-};
-```
-
-Each connection has:
-
-| Field             | Description                                                                                              |
-| ----------------- | -------------------------------------------------------------------------------------------------------- |
-| `id`              | Unique row id; pass to `getConnection(id)` to refetch a single one                                       |
-| `visibility`      | `'user'` (private to one workspace member) or `'workspace'` (shared with all members)                    |
-| `scopes`          | OAuth permissions granted by the upstream provider (distinct from `visibility` — those are unrelated)    |
-| `userWorkspaceId` | The owner's userWorkspace id — useful for picking "the request user's connection" in HTTP-route triggers |
-| `accessToken`     | Fresh OAuth access token (refreshed automatically if expired)                                            |
-| `name` / `handle` | The connection's display name (auto-derived at OAuth callback, user-renameable)                          |
-| `authFailedAt`    | Set when the most recent refresh failed; the user must reconnect                                         |
-
-Key points:
-
-- Pass `{ providerName }` to filter by provider; omit it to get all connections this app owns across all providers.
-- The server transparently refreshes the access token before returning. Your handler always sees a usable token (or `authFailedAt` set).
-- `getConnection(id)` is the single-row equivalent.
-
-</Accordion>
-
-<Accordion title="Per-user vs workspace-shared visibility" description="How users choose between private and shared credentials">
-
-When a user clicks "Add connection," they're prompted to pick a visibility:
-
-- **Just for me** — the credential is private to the connecting user. Any logic function called on their behalf (HTTP-route trigger with `isAuthRequired: true`) sees it; cron triggers and database events do not.
-- **Workspace shared** — any workspace member can use the credential. Cron / database triggers also see it, since they have no request user.
-
-Use the right one for each handler:
-
-```ts
-// HTTP-route trigger — prefer the request user's own connection.
-const conn =
-  connections.find((c) => c.userWorkspaceId === event.userWorkspaceId) ??
-  connections.find((c) => c.visibility === 'workspace');
-
-// Cron trigger — no request user; only shared credentials are sensible.
-const conn = connections.find((c) => c.visibility === 'workspace');
-```
-
-Multiple connections per (user, provider) are allowed, so the same user can hold "Personal Linear" and "Work Linear" side by side.
-
-</Accordion>
-
-<Accordion title="One-time provider setup" description="Register your OAuth app with the third-party service">
-
-For each connection provider, the server admin needs to register an OAuth app at the third party first.
-
-1. Go to the provider's developer settings (e.g. https://linear.app/settings/api/applications/new).
-2. Set the **Redirect URI** to `<SERVER_URL>/apps/oauth/callback`.
-3. Copy the generated **Client ID** and **Client Secret**.
-4. Open the installed app in Twenty as a server admin → set the values on the corresponding `serverVariables`.
-5. Workspace members can then add connections from the per-app **Connections** section.
-
-</Accordion>
-
-</AccordionGroup>

packages/twenty-docs/developers/extend/apps/data-model.mdx

@@ -77,6 +77,7 @@ export default defineApplication({
   universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
   displayName: 'My Twenty App',
   description: 'My first Twenty app',
+  icon: 'IconWorld',
   applicationVariables: {
     DEFAULT_RECIPIENT_NAME: {
       universalIdentifier: '19e94e59-d4fe-4251-8981-b96d0a9f74de',

packages/twenty-docs/developers/extend/apps/front-components.mdx

@@ -15,7 +15,7 @@ Front components can render in two locations within Twenty:
 
 ## Basic example
 
-The quickest way to see a front component in action is to register it with a **command menu item**. Use `defineCommandMenuItem` in a separate file to make the component appear as a quick-action button in the top-right corner of the page:
+The quickest way to see a front component in action is to register it as a **command**. Adding a `command` field with `isPinned: true` makes it appear as a quick-action button in the top-right corner of the page — no page layout needed:
 
 ```tsx src/front-components/hello-world.tsx
 import { defineFrontComponent } from 'twenty-sdk/define';
@@ -34,20 +34,14 @@ export default defineFrontComponent({
   name: 'hello-world',
   description: 'A simple front component',
   component: HelloWorld,
-});
-```
-
-```ts src/command-menu-items/hello-world.command-menu-item.ts
-import { defineCommandMenuItem } from 'twenty-sdk/define';
-
-export default defineCommandMenuItem({
-  universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
-  shortLabel: 'Hello',
-  label: 'Hello World',
-  icon: 'IconBolt',
-  isPinned: true,
-  availabilityType: 'GLOBAL',
-  frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
+  command: {
+    universalIdentifier: 'd4e5f6a7-b8c9-0123-defa-456789012345',
+    shortLabel: 'Hello',
+    label: 'Hello World',
+    icon: 'IconBolt',
+    isPinned: true,
+    availabilityType: 'GLOBAL',
+  },
 });
 ```
 
@@ -68,6 +62,7 @@ Click it to render the component inline.
 | `name` | No | Display name |
 | `description` | No | Description of what the component does |
 | `isHeadless` | No | Set to `true` if the component has no visible UI (see below) |
+| `command` | No | Register the component as a command (see [command options](#command-options) below) |
 
 ## Placing a front component on a page
 
@@ -146,17 +141,11 @@ export default defineFrontComponent({
   description: 'Creates a task from the command menu',
   component: RunAction,
   isHeadless: true,
-});
-```
-
-```ts src/command-menu-items/run-action.command-menu-item.ts
-import { defineCommandMenuItem } from 'twenty-sdk/define';
-
-export default defineCommandMenuItem({
-  universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
-  label: 'Run my action',
-  icon: 'IconPlayerPlay',
-  frontComponentUniversalIdentifier: 'e5f6a7b8-c9d0-1234-efab-345678901234',
+  command: {
+    universalIdentifier: 'f6a7b8c9-d0e1-2345-fabc-456789012345',
+    label: 'Run my action',
+    icon: 'IconPlayerPlay',
+  },
 });
 ```
 
@@ -188,6 +177,11 @@ export default defineFrontComponent({
   description: 'Deletes a draft with confirmation',
   component: DeleteDraft,
   isHeadless: true,
+  command: {
+    universalIdentifier: 'b8c9d0e1-f2a3-4567-bcde-678901234567',
+    label: 'Delete draft',
+    icon: 'IconTrash',
+  },
 });
 ```
 
@@ -229,8 +223,7 @@ Available hooks:
 | Hook | Returns | Description |
 |------|---------|-------------|
 | `useUserId()` | `string` or `null` | The current user's ID |
-| `useSelectedRecordIds()` | `string[]` | All selected record IDs (empty array if none selected) |
-| `useRecordId()` | `string` or `null` | **Deprecated.** Use `useSelectedRecordIds()` instead |
+| `useRecordId()` | `string` or `null` | The current record's ID (when placed on a record page) |
 | `useFrontComponentId()` | `string` | This component instance's ID |
 | `useFrontComponentExecutionContext(selector)` | varies | Access the full execution context with a selector function |
 
@@ -293,84 +286,14 @@ export default defineFrontComponent({
 });
 ```
 
-### Working with multiple records
+## Command options
 
-Use `useSelectedRecordIds()` to handle multiple selected records. This is useful for bulk operations:
-
-```tsx src/front-components/bulk-export.tsx
-import { defineFrontComponent } from 'twenty-sdk/define';
-import { useSelectedRecordIds, numberOfSelectedRecords } from 'twenty-sdk/front-component';
-import { enqueueSnackbar, closeSidePanel } from 'twenty-sdk/front-component';
-import { CoreApiClient } from 'twenty-sdk/clients';
-
-const BulkExport = () => {
-  const selectedRecordIds = useSelectedRecordIds();
-
-  const handleExport = async () => {
-    const client = new CoreApiClient();
-
-    for (const recordId of selectedRecordIds) {
-      await client.mutation({
-        updateTask: {
-          __args: { id: recordId, data: { exported: true } },
-          id: true,
-        },
-      });
-    }
-
-    await enqueueSnackbar({
-      message: `Exported ${selectedRecordIds.length} records`,
-      variant: 'success',
-    });
-
-    await closeSidePanel();
-  };
-
-  return (
-    <div style={{ padding: '20px' }}>
-      <p>Export {selectedRecordIds.length} selected record(s)?</p>
-      <button onClick={handleExport}>Export</button>
-    </div>
-  );
-};
-
-export default defineFrontComponent({
-  universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',
-  name: 'bulk-export',
-  description: 'Export selected records',
-  component: BulkExport,
-  command: {
-    universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',
-    label: 'Bulk Export',
-    availabilityType: 'RECORD_SELECTION',
-    conditionalAvailabilityExpression: numberOfSelectedRecords > 0,
-  },
-});
-```
-
-## defineCommandMenuItem
-
-Use `defineCommandMenuItem` to register a front component in the command menu (Cmd+K). If `isPinned` is `true`, it also appears as a quick-action button in the top-right corner of the page.
-
-```ts src/command-menu-items/open-dashboard.command-menu-item.ts
-import { defineCommandMenuItem } from 'twenty-sdk/define';
-
-export default defineCommandMenuItem({
-  universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
-  label: 'Open Dashboard',
-  shortLabel: 'Dashboard',
-  icon: 'IconLayoutDashboard',
-  isPinned: true,
-  availabilityType: 'GLOBAL',
-  frontComponentUniversalIdentifier: '74c526eb-cb68-4cf7-b05c-0dd8c288d948',
-});
-```
+Adding a `command` field to `defineFrontComponent` registers the component in the command menu (Cmd+K). If `isPinned` is `true`, it also appears as a quick-action button in the top-right corner of the page.
 
 | Field | Required | Description |
 |-------|----------|-------------|
 | `universalIdentifier` | Yes | Stable unique ID for the command |
 | `label` | Yes | Full label shown in the command menu (Cmd+K) |
-| `frontComponentUniversalIdentifier` | Yes | The `universalIdentifier` of the front component this command opens |
 | `shortLabel` | No | Shorter label displayed on the pinned quick-action button |
 | `icon` | No | Icon name displayed next to the label (e.g. `'IconBolt'`, `'IconSend'`) |
 | `isPinned` | No | When `true`, shows the command as a quick-action button in the top-right corner of the page |
@@ -382,23 +305,30 @@ export default defineCommandMenuItem({
 
 The `conditionalAvailabilityExpression` field lets you control when a command is visible based on the current page context. Import typed variables and operators from `twenty-sdk` to build expressions:
 
-```ts src/command-menu-items/bulk-update.command-menu-item.ts
-import { defineCommandMenuItem } from 'twenty-sdk/define';
+```tsx
+import { defineFrontComponent } from 'twenty-sdk/define';
 import {
+  pageType,
+  numberOfSelectedRecords,
   objectPermissions,
   everyEquals,
+  isDefined,
 } from 'twenty-sdk/front-component';
 
-export default defineCommandMenuItem({
+export default defineFrontComponent({
   universalIdentifier: '...',
-  label: 'Bulk Update',
-  availabilityType: 'RECORD_SELECTION',
-  frontComponentUniversalIdentifier: '...',
-  conditionalAvailabilityExpression: everyEquals(
-    objectPermissions,
-    'canUpdateObjectRecords',
-    true,
-  ),
+  name: 'bulk-action',
+  component: BulkAction,
+  command: {
+    universalIdentifier: '...',
+    label: 'Bulk Update',
+    availabilityType: 'RECORD_SELECTION',
+    conditionalAvailabilityExpression: everyEquals(
+      objectPermissions,
+      'canUpdateObjectRecords',
+      true,
+    ),
+  },
 });
 ```
 

packages/twenty-docs/developers/extend/apps/getting-started.mdx

@@ -4,52 +4,48 @@ icon: "rocket"
 description: Create your first Twenty app in minutes.
 ---
 
+## What are apps?
+
+Apps let you extend Twenty with custom objects, fields, logic functions, front components, AI skills, and more — all managed as code. Instead of configuring everything through the UI, you define your data model and logic in TypeScript and deploy it to one or more workspaces.
+
 ## Prerequisites
 
-- **Node.js 24+** — [Download](https://nodejs.org/)
-- **Yarn 4** — bundled with Node via Corepack. Enable it: `corepack enable`
-- **Docker** — [Download](https://www.docker.com/products/docker-desktop/). Needed to run a local Twenty server. Skip if you already have Twenty running elsewhere.
+Before you begin, make sure the following is installed on your machine:
 
-Building a Twenty app has three phases. The scaffolder collapses them into one happy-path command, but each phase is a separate concept — when something fails, knowing which phase you're in tells you what to fix.
+- **Node.js 24+** — [Download here](https://nodejs.org/)
+- **Yarn 4** — Comes with Node.js via Corepack. Enable it by running `corepack enable`
+- **Docker** — [Download here](https://www.docker.com/products/docker-desktop/). Required to run a local Twenty instance. Not needed if you already have a Twenty server running.
 
-| Phase | What you do | Tool | Result |
-|---|---|---|---|
-| **1. Scaffold** | Generate the app's source code | `npx create-twenty-app` | A TypeScript project on disk |
-| **2. Run a server** | Start a Twenty server to sync into | Docker + `yarn twenty server` | A running Twenty instance |
-| **3. Sync** | Live-sync your code to the server | `yarn twenty dev` | Your changes appear in the UI |
+## Create your first app
 
----
+### Scaffold your app
 
-## Phase 1 — Scaffold your project
-
-Create a new app from the template:
+Open a terminal and run:
 
 ```bash filename="Terminal"
 npx create-twenty-app@latest my-twenty-app
 ```
 
-You'll be prompted for a name and description — press **Enter** for the defaults. This generates a TypeScript project in `my-twenty-app/` with a starter `application-config.ts`, a default role, a CI workflow, and an integration test.
+You will be prompted to enter a name and a description for your app. Press **Enter** to accept the defaults.
 
-**After this phase:** you have an app's source code on your machine. It isn't running yet — that's Phase 2.
+This creates a new folder called `my-twenty-app` with everything you need.
 
----
+### Set up a local Twenty instance
 
-## Phase 2 — Run a local Twenty server
-
-Your app needs a Twenty server to sync into. The server is a full Twenty instance — UI, GraphQL API, PostgreSQL — running locally in Docker. Your local code uploads its definitions to that server, which makes them appear in the UI.
-
-The scaffolder offers to start one for you:
+The scaffolder will ask:
 
 > **Would you like to set up a local Twenty instance?**
 
-- **Yes (recommended)** — pulls the `twentycrm/twenty-app-dev` Docker image and starts it on port `2020`. Make sure Docker is running first.
-- **No** — choose this if you already have a Twenty server you want to connect to. You can wire it up later with `yarn twenty remote add`.
+- **Type `yes`** (recommended) — This pulls the `twenty-app-dev` Docker image and starts a local Twenty server on port `2020`. Make sure Docker is running before you continue.
+- **Type `no`** — Choose this if you already have a Twenty server running locally.
 
 <div style={{textAlign: 'center'}}>
   <img src="/images/docs/developers/extends/apps/start-instance.png" alt="Should start local instance?" />
 </div>
 
-Once the server is up, a browser opens for sign-in. Use the pre-seeded demo account:
+### Sign in to your workspace
+
+Next, a browser window will open with the Twenty login page. Sign in with the pre-seeded demo account:
 
 - **Email:** `tim@apple.dev`
 - **Password:** `tim@apple.dev`
@@ -58,66 +54,50 @@ Once the server is up, a browser opens for sign-in. Use the pre-seeded demo acco
   <img src="/images/docs/developers/extends/apps/login.png" alt="Twenty login screen" />
 </div>
 
-Click **Authorize** on the next screen — this gives the CLI access to your workspace.
+### Authorize the app
+
+After you sign in, you will see an authorization screen. This lets your app interact with your workspace.
+
+Click **Authorize** to continue.
 
 <div style={{textAlign: 'center'}}>
   <img src="/images/docs/developers/extends/apps/authorize.png" alt="Twenty CLI authorization screen" />
 </div>
 
-Your terminal will confirm everything is set up.
+Once authorized, your terminal will confirm that everything is set up.
 
 <div style={{textAlign: 'center'}}>
   <img src="/images/docs/developers/extends/apps/scaffolded.png" alt="App scaffolded successfully" />
 </div>
 
-**After this phase:** you have a running Twenty server at [http://localhost:2020](http://localhost:2020) with your CLI authorized to sync to it.
+### Start developing
 
-<Note>
-If Docker isn't installed or running, the scaffolder will tell you the right start command for your OS. Once Docker is up, you can resume with `yarn twenty server start` — no need to re-scaffold.
-</Note>
-
----
-
-## Phase 3 — Sync your changes
-
-This is the inner loop you'll spend most of your time in.
+Go into your new app folder and start the development server:
 
 ```bash filename="Terminal"
 cd my-twenty-app
 yarn twenty dev
 ```
 
-This watches `src/`, rebuilds on every change, and syncs the result to the server. Edit a file, save, and within a second the server reflects the change. You'll see a live status panel in your terminal.
+This watches your source files, rebuilds on every change, and syncs your app to the local Twenty server automatically. You should see a live status panel in your terminal.
 
-For more detailed output (build logs, sync requests, error traces), add `--verbose`.
+For more detailed output (build logs, sync requests, error traces), use the `--verbose` flag:
+
+```bash filename="Terminal"
+yarn twenty dev --verbose
+```
+
+<Warning>
+Dev mode is only available on Twenty instances running in development (`NODE_ENV=development`). Production instances reject dev sync requests. Use `yarn twenty deploy` to deploy to production servers — see [Publishing Apps](/developers/extend/apps/publishing) for details.
+</Warning>
 
 <div style={{textAlign: 'center'}}>
-  <img src="/images/docs/developers/extends/apps/dev.png" alt="Dev mode terminal output" />
+  <img src="/images/docs/developers/extends/apps/dev.jpg" alt="Dev mode terminal output" />
 </div>
 
-Open [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer). You should see your app under **Your Apps**.
+#### One-shot sync with `yarn twenty dev --once`
 
-<div style={{textAlign: 'center'}}>
-  <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="Your Apps list showing My twenty app" />
-</div>
-
-Click **My twenty app** to see its **application registration** — a server-level record describing your app (name, identifier, OAuth credentials, source). One registration can be installed across multiple workspaces on the same server.
-
-<div style={{textAlign: 'center'}}>
-  <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="Application registration details" />
-</div>
-
-Click **View installed app** to see the workspace install. The **About** tab shows version and management options.
-
-<div style={{textAlign: 'center'}}>
-  <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="Installed app" />
-</div>
-
-**After this phase:** you have a live development loop. Edit any file in `src/` and it appears in the UI.
-
-### One-shot sync for CI and scripts
-
-Pass `--once` to run a single build + sync and exit — same pipeline, no watcher:
+If you do not want a watcher running in the background (for example in a CI pipeline, a git hook, or a scripted workflow), pass the `--once` flag. It runs the same pipeline as `yarn twenty dev` — build manifest, bundle files, upload, sync, regenerate the typed API client — but **exits as soon as the sync completes**:
 
 ```bash filename="Terminal"
 yarn twenty dev --once
@@ -125,14 +105,38 @@ yarn twenty dev --once
 
 | Command | Behavior | When to use |
 |---------|----------|-------------|
-| `yarn twenty dev` | Watches and re-syncs on every change. Runs until you stop it. | Interactive local development. |
-| `yarn twenty dev --once` | Single build + sync, exits `0` on success, `1` on failure. | CI, pre-commit hooks, AI agents, scripted workflows. |
+| `yarn twenty dev` | Watches your source files and re-syncs on every change. Keeps running until you stop it. | Interactive local development — you want the live status panel and instant feedback loop. |
+| `yarn twenty dev --once` | Performs a single build + sync, then exits with code `0` on success or `1` on failure. | Scripts, CI, pre-commit hooks, AI agents, and any non-interactive workflow. |
 
-Both modes need a server in development mode and an authenticated remote.
+Both modes require a Twenty server running in development mode and an authenticated remote — the same prerequisites apply.
 
-<Warning>
-Dev mode is only available on Twenty instances running in development (`NODE_ENV=development`). Production instances reject dev sync requests — use `yarn twenty deploy` to deploy to production servers. See [Publishing Apps](/developers/extend/apps/publishing).
-</Warning>
+### See your app in Twenty
+
+Open [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer) in your browser. Navigate to **Settings > Apps** and select the **Developer** tab. You should see your app listed under **Your Apps**:
+
+<div style={{textAlign: 'center'}}>
+  <img src="/images/docs/developers/extends/apps/app-in-ui-1.png" alt="Your Apps list showing My twenty app" />
+</div>
+
+Click on **My twenty app** to open its **application registration**. A registration is a server-level record that describes your app — its name, unique identifier, OAuth credentials, and source (local, npm, or tarball). It lives on the server, not inside any specific workspace. When you install an app into a workspace, Twenty creates a workspace-scoped **application** that points back to this registration. One registration can be installed across multiple workspaces on the same server.
+
+<div style={{textAlign: 'center'}}>
+  <img src="/images/docs/developers/extends/apps/app-in-ui-2.png" alt="Application registration details" />
+</div>
+
+Click **View installed app** to see the installed app. The **About** tab shows the current version and management options:
+
+<div style={{textAlign: 'center'}}>
+  <img src="/images/docs/developers/extends/apps/app-in-ui-3.png" alt="Installed app — About tab" />
+</div>
+
+Switch to the **Content** tab to see everything your app provides — objects, fields, logic functions, and agents:
+
+<div style={{textAlign: 'center'}}>
+  <img src="/images/docs/developers/extends/apps/app-in-ui-4.png" alt="Installed app — Content tab" />
+</div>
+
+You are all set! Edit any file in `src/` and the changes will be picked up automatically.
 
 ---
 
@@ -142,110 +146,115 @@ Apps are composed of **entities** — each defined as a TypeScript file with a s
 
 | Entity | What it does |
 |--------|-------------|
-| **Objects & Fields** | Custom data models (Post Card, Invoice, etc.) with typed fields |
-| **Logic functions** | Server-side TypeScript triggered by HTTP routes, cron schedules, or database events |
+| **Objects & Fields** | Define custom data models (like Post Card, Invoice) with typed fields |
+| **Logic functions** | Server-side TypeScript functions triggered by HTTP routes, cron schedules, or database events |
 | **Front components** | React components that render inside Twenty's UI (side panel, widgets, command menu) |
 | **Skills & Agents** | AI capabilities — reusable instructions and autonomous assistants |
-| **Views & Navigation** | Pre-configured list views and sidebar menu items |
+| **Views & Navigation** | Pre-configured list views and sidebar menu items for your objects |
 | **Page layouts** | Custom record detail pages with tabs and widgets |
 
-Full reference: [Building Apps](/developers/extend/apps/building).
+Head over to [Building Apps](/developers/extend/apps/building) for a detailed guide on each entity type.
+
+---
 
 ## Project structure
 
+The scaffolder generates the following file structure:
+
 ```text filename="my-twenty-app/"
 my-twenty-app/
   package.json
+  yarn.lock
+  .gitignore
+  .nvmrc
+  .yarnrc.yml
+  .oxlintrc.json
+  tsconfig.json
+  tsconfig.spec.json                          # TypeScript config for tests
+  vitest.config.ts                            # Vitest test runner configuration
+  LLMS.md
+  README.md
+  .github/
+    └── workflows/
+        └── ci.yml                            # GitHub Actions CI workflow
+  public/                                     # Public assets (images, fonts, etc.)
   src/
-    application-config.ts                   # Required — your app's entry point
-    default-role.ts                         # Permissions for logic functions
-    constants/
-      universal-identifiers.ts              # Auto-generated UUIDs and metadata
-    __tests__/
-      setup-test.ts
-      app-install.integration-test.ts
-  .github/workflows/ci.yml                  # GitHub Actions
-  public/                                   # Static assets
-  vitest.config.ts                          # Test runner config
-  tsconfig.json, tsconfig.spec.json
-  .nvmrc, .yarnrc.yml, .oxlintrc.json
-  README.md, LLMS.md
+  ├── application-config.ts                   # Required — main application configuration
+  ├── default-role.ts                         # Default role for logic functions
+  ├── constants/
+  │   └── universal-identifiers.ts            # Auto-generated UUIDs and app metadata
+  └── __tests__/
+      ├── setup-test.ts                       # Test setup (server health check, config)
+      └── app-install.integration-test.ts     # Integration test
 ```
 
-| File / Folder | Purpose |
-|---|---|
-| `src/application-config.ts` | **Required.** The main configuration file for your app. |
-| `src/default-role.ts` | Default role controlling what your logic functions can access. |
-| `src/constants/universal-identifiers.ts` | Auto-generated UUIDs and metadata (display name, description). |
-| `src/__tests__/` | Integration tests (setup + example test). |
-| `public/` | Static assets (images, fonts) served with your app. |
-
 ### Starting from an example
 
-Use `--example` to start with a more complete project (custom objects, fields, logic functions, front components):
+To start from a more complete example with custom objects, fields, logic functions, front components, and more, use the `--example` flag:
 
 ```bash filename="Terminal"
 npx create-twenty-app@latest my-twenty-app --example postcard
 ```
 
-Examples live in [twenty-apps/examples](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples). You can also scaffold individual entities into an existing project with `yarn twenty add` — see [Building Apps](/developers/extend/apps/building#scaffolding-entities-with-yarn-twenty-add).
+Examples are sourced from the [twenty-apps/examples](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples) directory on GitHub. You can also scaffold individual entities into an existing project with `yarn twenty add` (see [Building Apps](/developers/extend/apps/building#scaffolding-entities-with-yarn-twenty-add)).
 
----
+### Key files
 
-## Managing the local server
+| File / Folder | Purpose |
+|---|---|
+| `package.json` | Declares your app name, version, and dependencies. Includes a `twenty` script so you can run `yarn twenty help` to see all commands. |
+| `src/application-config.ts` | **Required.** The main configuration file for your app. |
+| `src/default-role.ts` | Default role that controls what your logic functions can access. |
+| `src/constants/universal-identifiers.ts` | Auto-generated UUIDs and app metadata (display name, description). |
+| `src/__tests__/` | Integration tests (setup + example test). |
+| `public/` | Static assets (images, fonts) served with your app. |
 
-Use `yarn twenty server` to control the local Twenty container:
+## Local development server
 
-| Command | What it does |
-|---------|--------------|
-| `yarn twenty server start` | Start the server (pulls the image if needed) |
+The scaffolder already started a local Twenty server for you. To manage it later, use `yarn twenty server`:
+
+| Command | Description |
+|---------|-------------|
+| `yarn twenty server start` | Start the local server (pulls image if needed) |
 | `yarn twenty server start --port 3030` | Start on a custom port |
+| `yarn twenty server start --test` | Start a separate test instance on port 2021 |
 | `yarn twenty server stop` | Stop the server (preserves data) |
-| `yarn twenty server status` | Show URL, version, and login credentials |
+| `yarn twenty server status` | Show server status, URL, and credentials |
 | `yarn twenty server logs` | Stream server logs |
-| `yarn twenty server reset` | Wipe data and start fresh |
-| `yarn twenty server upgrade` | Pull the latest `twenty-app-dev` image |
-| `yarn twenty server upgrade 2.2.0` | Upgrade to a specific version |
+| `yarn twenty server logs --lines 100` | Show the last 100 log lines |
+| `yarn twenty server reset` | Delete all data and start fresh |
 
-Data persists across restarts in two Docker volumes (`twenty-app-dev-data` for PostgreSQL, `twenty-app-dev-storage` for files). Use `reset` to wipe everything.
+Data is persisted across restarts in two Docker volumes (`twenty-app-dev-data` for PostgreSQL, `twenty-app-dev-storage` for files). Use `reset` to wipe everything and start fresh.
 
-### Upgrading the server image
+### Running a test instance
 
-`yarn twenty server upgrade` pulls the latest image, compares digests, and only recreates the container if anything actually changed. Volumes are preserved — only the container is replaced. If a new image was pulled and the container was running, the upgrade automatically starts a new container; run `yarn twenty server start` afterward to wait for it to become healthy.
+Pass `--test` to any `server` command to manage a second, fully isolated instance — useful for running integration tests or experimenting without touching your main dev data.
 
-```bash filename="Terminal"
-yarn twenty server upgrade            # Latest
-yarn twenty server upgrade 2.2.0      # Specific version
-```
-
-Verify the running version with `yarn twenty server status` (it shows the `APP_VERSION` baked into the container).
-
-### Running a parallel test instance
-
-Pass `--test` to any `server` command to manage a second, fully isolated instance — useful for integration tests or experiments without touching your main dev data:
-
-| Command | What it does |
-|---------|--------------|
+| Command | Description |
+|---------|-------------|
 | `yarn twenty server start --test` | Start the test instance (defaults to port 2021) |
-| `yarn twenty server stop --test` | Stop it |
-| `yarn twenty server status --test` | Show its status |
-| `yarn twenty server logs --test` | Stream its logs |
-| `yarn twenty server reset --test` | Wipe its data |
-| `yarn twenty server upgrade --test` | Upgrade its image |
+| `yarn twenty server stop --test` | Stop the test instance |
+| `yarn twenty server status --test` | Show test instance status, URL, and credentials |
+| `yarn twenty server logs --test` | Stream test instance logs |
+| `yarn twenty server reset --test` | Wipe test data and start fresh |
 
-The test instance has its own container (`twenty-app-dev-test`), volumes (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`), and config — it runs alongside your main instance without conflicts. Combine `--test` with `--port` to override 2021.
+The test instance runs in its own Docker container (`twenty-app-dev-test`) with dedicated volumes (`twenty-app-dev-test-data`, `twenty-app-dev-test-storage`) and config, so it can run in parallel with your main instance without conflicts. Combine `--test` with `--port` to override the default 2021.
 
----
+<Note>
+  The server requires **Docker** to be running. If you see a "Docker not running" error, make sure Docker Desktop (or the Docker daemon) is started.
+</Note>
 
 ## Manual setup (without the scaffolder)
 
-Skip the scaffolder if you're adding the SDK to an existing project:
+If you prefer to set things up yourself instead of using `create-twenty-app`, you can do it in two steps.
+
+**1. Add `twenty-sdk` and `twenty-client-sdk` as dependencies:**
 
 ```bash filename="Terminal"
 yarn add twenty-sdk twenty-client-sdk
 ```
 
-Add the script to `package.json`:
+**2. Add a `twenty` script to your `package.json`:**
 
 ```json filename="package.json"
 {
@@ -255,19 +264,19 @@ Add the script to `package.json`:
 }
 ```
 
-You can now run `yarn twenty dev`, `yarn twenty server start`, and the rest.
+You can now run `yarn twenty dev`, `yarn twenty help`, and all other commands.
 
 <Note>
-Don't install `twenty-sdk` globally — pin it per project so each app uses its own version.
+Do not install `twenty-sdk` globally. Always use it as a local project dependency so that each project can pin its own version.
 </Note>
 
----
-
 ## Troubleshooting
 
-- **Docker errors** — Make sure Docker Desktop (or the daemon) is running before `yarn twenty server start`. The error message will show the right start command for your OS.
-- **Wrong Node version** — Need 24+. Check with `node -v`.
-- **Yarn 4 missing** — Run `corepack enable`.
-- **Dependencies broken** — `rm -rf node_modules && yarn install`.
+If you run into issues:
 
-Stuck? Ask on the [Twenty Discord](https://discord.com/channels/1130383047699738754/1130386664812982322).
+- Make sure **Docker is running** before starting the scaffolder with a local instance.
+- Make sure you are using **Node.js 24+** (`node -v` to check).
+- Make sure **Corepack is enabled** (`corepack enable`) so Yarn 4 is available.
+- Try deleting `node_modules` and running `yarn install` again if dependencies seem broken.
+
+Still stuck? Ask for help on the [Twenty Discord](https://discord.com/channels/1130383047699738754/1130386664812982322).

packages/twenty-docs/developers/extend/apps/logic-functions.mdx

@@ -76,28 +76,6 @@ yarn twenty logs
 ```
 </Note>
 
-#### enqueueLogicFunctionExecution
-
-Inside your logic function handler — regardless of trigger (HTTP route, cron, database event, tool, workflow action, or install hook) — you can enqueue **another** function that belongs to the **same application** on the worker queue. Import it from `twenty-sdk/logic-function`:
-
-```ts
-import {
-  enqueueLogicFunctionExecution,
-  type RoutePayload,
-} from 'twenty-sdk/logic-function';
-
-const handler = async (event: RoutePayload) => {
-  const { jobId, status } = await enqueueLogicFunctionExecution({
-    universalIdentifier: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
-    payload: { fromWebhook: true },
-  });
-
-  return { accepted: true, jobId, status };
-};
-```
-
-Pass **exactly one** of `name` or `universalIdentifier`.
-
 #### Route trigger payload
 
 When a route trigger invokes your logic function, it receives a `RoutePayload` object that follows the
@@ -123,7 +101,6 @@ The `RoutePayload` type has the following structure:
   | `queryStringParameters` | `Record<string, string \| undefined>` | Query string parameters (multiple values joined with commas)  | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }`|
   | `pathParameters` | `Record<string, string \| undefined>` | Path parameters extracted from the route pattern | `/users/:id`, `/users/123` -> `{ id: '123' }` |
   | `body` | `object \| null` | Parsed request body (JSON) | `{ id: 1 }` -> `{ id: 1 }` |
-  | `rawBody` | `string \| undefined` | Original UTF-8 request body, before JSON parsing. Useful for verifying HMAC-style webhook signatures (e.g. GitHub's `X-Hub-Signature-256`, Stripe). `undefined` when the runtime did not preserve it. | |
   | `isBase64Encoded` | `boolean` | Whether the body is base64 encoded | |
   | `requestContext.http.method` | `string` | HTTP method (GET, POST, PUT, PATCH, DELETE) | |
   | `requestContext.http.path` | `string` | Raw request path | |
@@ -164,14 +141,11 @@ const handler = async (event: RoutePayload) => {
 Header names are normalized to lowercase. Access them using lowercase keys (e.g., `event.headers['content-type']`).
 </Note>
 
-#### Exposing a function as an AI tool or workflow action
+#### Exposing a function as a tool
 
-Logic functions can be exposed on two surfaces, each with its own trigger:
+Logic functions can be exposed as **tools** for AI agents and workflows. When marked as a tool, a function becomes discoverable by Twenty's AI features and can be used in workflow automations.
 
-- **`toolTriggerSettings`** — makes the function discoverable by Twenty's AI features (chat, MCP, function calling). Uses standard JSON Schema, the format LLMs natively understand.
-- **`workflowActionTriggerSettings`** — makes the function appear as a step in the visual workflow builder. Uses Twenty's rich `InputSchema` so the builder can render proper field editors, variable pickers, and labels.
-
-A function can opt into one, the other, or both. They sit alongside `cronTriggerSettings`, `databaseEventTriggerSettings`, and `httpRouteTriggerSettings` — same pattern, same shape.
+To mark a logic function as a tool, set `isTool: true`:
 
 ```ts src/logic-functions/enrich-company.logic-function.ts
 import { defineLogicFunction } from 'twenty-sdk/define';
@@ -201,33 +175,31 @@ export default defineLogicFunction({
   description: 'Enrich a company record with external data',
   timeoutSeconds: 10,
   handler,
-  toolTriggerSettings: {},
+  isTool: true,
 });
 ```
 
 Key points:
 
-- A function can mix surfaces — declare both `toolTriggerSettings` and `workflowActionTriggerSettings` to expose it in chat AND in the workflow builder.
-- `toolTriggerSettings.inputSchema` and `workflowActionTriggerSettings.inputSchema` are both optional. When omitted, the manifest builder infers them from the handler source code (JSON Schema for the AI tool, Twenty's `InputSchema` for the workflow action). Provide one explicitly when you want richer typing — for example, with `FieldMetadataType`-aware fields like `CURRENCY` or `RELATION` for the workflow builder, or with `description` fields the AI agent can read:
+- You can combine `isTool` with triggers — a function can be both a tool (callable by AI agents) and triggered by events at the same time.
+- **`toolInputSchema`** (optional): A JSON Schema object describing the parameters your function accepts. The schema is computed automatically from source code static analysis, but you can set it explicitly:
 
 ```ts
 export default defineLogicFunction({
   ...,
-  toolTriggerSettings: {
-    inputSchema: {
-      type: 'object',
-      properties: {
-        companyName: {
-          type: 'string',
-          description: 'The name of the company to enrich',
-        },
-        domain: {
-          type: 'string',
-          description: 'The company website domain (optional)',
-        },
+  toolInputSchema: {
+    type: 'object',
+    properties: {
+      companyName: {
+        type: 'string',
+        description: 'The name of the company to enrich',
+      },
+      domain: {
+        type: 'string',
+        description: 'The company website domain (optional)',
       },
-      required: ['companyName'],
     },
+    required: ['companyName'],
   },
 });
 ```
@@ -266,7 +238,7 @@ yarn twenty exec --postInstall
 ```
 
 Key points:
-- Post-install functions use `definePostInstallLogicFunction()` — a specialized variant that omits trigger settings (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `toolTriggerSettings`, `workflowActionTriggerSettings`).
+- Post-install functions use `definePostInstallLogicFunction()` — a specialized variant that omits trigger settings (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `isTool`).
 - The handler receives an `InstallPayload` with `{ previousVersion?: string; newVersion: string }` — `newVersion` is the version being installed, and `previousVersion` is the version that was previously installed (or `undefined` on a fresh install). Use these values to distinguish fresh installs from upgrades and to run version-specific migration logic.
 - **When the hook runs**: on fresh installs only, by default. Pass `shouldRunOnVersionUpgrade: true` if you also want it to run when the app is upgraded from a previous version. When omitted, the flag defaults to `false` and upgrades skip the hook.
 - **Execution model — async by default, sync opt-in**: the `shouldRunSynchronously` flag controls *how* post-install is executed.

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

@@ -77,39 +77,6 @@ Pre-release tags work as expected: bumping `1.0.0-rc.1` → `1.0.0-rc.2` is allo
 
 {/* TODO: add screenshot of the Upgrade button */}
 
-### Server version compatibility
-
-If your app uses a feature introduced in a specific Twenty server version (for example, OAuth providers added in v2.3.0), you should declare the minimum server version your app requires using the `engines.twenty` field in `package.json`:
-
-```json filename="package.json"
-{
-  "name": "twenty-my-app",
-  "version": "1.0.0",
-  "engines": {
-    "node": "^24.5.0",
-    "twenty": ">=2.3.0"
-  }
-}
-```
-
-The value is a standard [semver range](https://github.com/npm/node-semver#ranges). Common patterns:
-
-| Range | Meaning |
-|-------|---------|
-| `>=2.3.0` | Any server from 2.3.0 onward |
-| `>=2.3.0 <3.0.0` | 2.3.0 or later, but below the next major |
-| `^2.3.0` | Same as `>=2.3.0 <3.0.0` |
-
-**What happens at deploy and install time:**
-
-- If `engines.twenty` is set and the target server's version does not satisfy the range, the deploy (tarball upload) or install is rejected with a `SERVER_VERSION_INCOMPATIBLE` error and a message indicating both the required range and the actual server version.
-- If `engines.twenty` is **not set**, the app is accepted on any server version (backward-compatible with existing apps).
-- If the server has no `APP_VERSION` configured, the check is skipped.
-
-<Note>
-The server is the authoritative check — it validates `engines.twenty` on both tarball upload and workspace install. If you deploy a tarball out-of-band or install from the marketplace, the server still enforces compatibility.
-</Note>
-
 ## Automated CI/CD (scaffolded workflows)
 
 Apps generated with `create-twenty-app` ship with two GitHub Actions workflows out of the box, under `.github/workflows/`. They are ready to run as soon as you push the repo to GitHub — no extra setup is needed for CI, and CD only requires a single secret.
@@ -198,14 +165,6 @@ export default defineApplication({
 
 See the [defineApplication accordion](/developers/extend/apps/building#defineentity-functions) in the Building Apps page for the full list of marketplace fields (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.).
 
-#### Recommended screenshot dimensions
-
-The marketplace renders `screenshots` in a fixed `8:5` container (for example, `1600×1000 px`).
-
-<Note>
-Screenshots of any aspect ratio are displayed in full and are never cropped, but anything significantly taller or narrower than `8:5` will show empty bands on the sides.
-</Note>
-
 ### Publish
 
 ```bash filename="Terminal"
@@ -225,9 +184,9 @@ The Twenty server syncs its marketplace catalog from the npm registry **every ho
 You can trigger the sync immediately instead of waiting:
 
 ```bash filename="Terminal"
-yarn twenty server catalog-sync
+yarn twenty catalog-sync
 # To target a specific remote:
-# yarn twenty server catalog-sync --remote production
+# yarn twenty catalog-sync --remote production
 ```
 
 The metadata shown in the marketplace comes from your `defineApplication()` config — fields like `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl`, and `termsUrl`.

packages/twenty-docs/docs.json

@@ -3866,10 +3866,10 @@
         "language": "ro",
         "tabs": [
           {
-            "tab": "Începeți",
+            "tab": "Getting Started",
             "groups": [
               {
-                "group": "Bun venit",
+                "group": "Welcome",
                 "pages": [
                   "l/ro/getting-started/introduction",
                   "l/ro/getting-started/key-features",
@@ -3877,7 +3877,7 @@
                 ]
               },
               {
-                "group": "Concepte cheie",
+                "group": "Core Concepts",
                 "pages": [
                   "l/ro/getting-started/core-concepts/data-model",
                   "l/ro/getting-started/core-concepts/layout",
@@ -3895,7 +3895,7 @@
             "tab": "User Guide",
             "groups": [
               {
-                "group": "Prezentare generală",
+                "group": "Overview",
                 "pages": [
                   "l/ro/user-guide/introduction"
                 ]
@@ -3906,7 +3906,7 @@
                 "pages": [
                   "l/ro/user-guide/data-model/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/data-model/capabilities/objects",
                       "l/ro/user-guide/data-model/capabilities/fields",
@@ -3932,7 +3932,7 @@
                 "pages": [
                   "l/ro/user-guide/data-migration/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/data-migration/capabilities/file-formats",
                       "l/ro/user-guide/data-migration/capabilities/field-mapping",
@@ -3964,7 +3964,7 @@
                 "pages": [
                   "l/ro/user-guide/calendar-emails/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/calendar-emails/capabilities/mailbox",
                       "l/ro/user-guide/calendar-emails/capabilities/calendar"
@@ -3989,7 +3989,7 @@
                 "pages": [
                   "l/ro/user-guide/workflows/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/workflows/capabilities/workflow-triggers",
                       "l/ro/user-guide/workflows/capabilities/workflow-actions",
@@ -4052,7 +4052,7 @@
                 "pages": [
                   "l/ro/user-guide/ai/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/ai/capabilities/ai-chatbot",
                       "l/ro/user-guide/ai/capabilities/ai-agents",
@@ -4068,16 +4068,16 @@
                 ]
               },
               {
-                "group": "Aspect",
+                "group": "Layout",
                 "icon": "table-columns",
                 "pages": [
                   "l/ro/user-guide/layout/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/layout/capabilities/navigation",
                       {
-                        "group": "Vizualizări",
+                        "group": "Views",
                         "pages": [
                           "l/ro/user-guide/views-pipelines/capabilities/table-views",
                           "l/ro/user-guide/views-pipelines/capabilities/kanban-views",
@@ -4091,7 +4091,7 @@
                     ]
                   },
                   {
-                    "group": "Ghiduri practice",
+                    "group": "How-Tos",
                     "pages": [
                       "l/ro/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping",
                       "l/ro/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects",
@@ -4110,7 +4110,7 @@
                 "pages": [
                   "l/ro/user-guide/dashboards/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/dashboards/capabilities/dashboards",
                       "l/ro/user-guide/dashboards/capabilities/widgets",
@@ -4132,7 +4132,7 @@
                 "pages": [
                   "l/ro/user-guide/permissions-access/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/permissions-access/capabilities/permissions",
                       "l/ro/user-guide/permissions-access/capabilities/sso-configuration"
@@ -4152,7 +4152,7 @@
                 "pages": [
                   "l/ro/user-guide/billing/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/billing/capabilities/pricing-plans",
                       "l/ro/user-guide/billing/capabilities/credits"
@@ -4172,7 +4172,7 @@
                 "pages": [
                   "l/ro/user-guide/settings/overview",
                   {
-                    "group": "Referință",
+                    "group": "Reference",
                     "pages": [
                       "l/ro/user-guide/settings/capabilities/workspace-settings",
                       "l/ro/user-guide/settings/capabilities/member-management",
@@ -4196,7 +4196,7 @@
             "tab": "Dezvoltatori",
             "groups": [
               {
-                "group": "Prezentare generală",
+                "group": "Overview",
                 "pages": [
                   "l/ro/developers/introduction"
                 ]

packages/twenty-docs/getting-started/core-concepts/apps.mdx

@@ -35,8 +35,14 @@ Everything is detected via AST analysis at build time — no config files, no re
 
 ## The developer experience
 
-You write your app as a TypeScript project on your machine. The CLI watches your source files and live-syncs them to a running Twenty server — edit a file, see the change in the UI within a second. The typed API client regenerates automatically when the schema changes. When you're ready, `yarn twenty deploy` pushes to a production server, or `yarn twenty publish` lists your app on npm and the Twenty marketplace.
+```bash
+npx create-twenty-app@latest my-app
+cd my-app
+yarn twenty dev
+```
+
+`yarn twenty dev` watches your source files, rebuilds on change, and live-syncs to a local Twenty instance. The typed API client regenerates automatically when the schema changes. When you're ready, `yarn twenty deploy` pushes to production. Apps can also be published to npm and listed in the Twenty marketplace.
 
 <Card title="Build your first app" icon="arrow-right" href="/developers/extend/apps/getting-started">
-  Three-phase walkthrough — scaffold, run a local server, sync your changes.
+  Full walkthrough — scaffold, develop, deploy.
 </Card>

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

@@ -94,16 +94,15 @@ const handler = async (event: RoutePayload) => {
 
 يحتوي نوع `RoutePayload` على البنية التالية:
 
-  | الخاصية                      | النوع                                                   | الوصف                                                                                                                                                                                                 | مثال                                                                       |
-  | ---------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
-  | `headers`                    | `Record\<string, string \| undefined>` | رؤوس HTTP (فقط تلك المدرجة في `forwardedRequestHeaders`)                                                                                                                                              | انظر القسم أدناه                                                           |
-  | `queryStringParameters`      | `Record\<string, string \| undefined>` | معلمات سلسلة الاستعلام (تُضمّ القيم المتعددة باستخدام فواصل)                                                                                                                                          | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
-  | `pathParameters`             | `Record\<string, string \| undefined>` | معلمات المسار المستخرجة من نمط المسار                                                                                                                                                                 | `/users/:id`, `/users/123` -> `{ id: '123' }`                              |
-  | `body`                       | `object \| null`                                        | جسم الطلب المُحلَّل (JSON)                                                                                                                                                                            | `{ id: 1 }` -> `{ id: 1 }`                                                 |
-  | `rawBody`                    | `string \| undefined`                                   | Original UTF-8 request body, before JSON parsing. Useful for verifying HMAC-style webhook signatures (e.g. GitHub's `X-Hub-Signature-256`, Stripe). `undefined` when the runtime did not preserve it. |                                                                            |
-  | `isBase64Encoded`            | `boolean`                                               | ما إذا كان جسم الطلب مُرمَّزًا بترميز base64                                                                                                                                                          |                                                                            |
-  | `requestContext.http.method` | `string`                                                | طريقة HTTP (GET, POST, PUT, PATCH, DELETE)                                                                                                                                                            |                                                                            |
-  | `requestContext.http.path`   | `string`                                                | المسار الخام للطلب                                                                                                                                                                                    |                                                                            |
+  | الخاصية                      | النوع                                                   | الوصف                                                        | مثال                                                                       |
+  | ---------------------------- | ------------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------- |
+  | `headers`                    | `Record\<string, string \| undefined>` | رؤوس HTTP (فقط تلك المدرجة في `forwardedRequestHeaders`)     | انظر القسم أدناه                                                           |
+  | `queryStringParameters`      | `Record\<string, string \| undefined>` | معلمات سلسلة الاستعلام (تُضمّ القيم المتعددة باستخدام فواصل) | `/users?ids=1&ids=2&ids=3&name=Alice` -> `{ ids: '1,2,3', name: 'Alice' }` |
+  | `pathParameters`             | `Record\<string, string \| undefined>` | معلمات المسار المستخرجة من نمط المسار                        | `/users/:id`, `/users/123` -> `{ id: '123' }`                              |
+  | `body`                       | `object \| null`                                        | جسم الطلب المُحلَّل (JSON)                                   | `{ id: 1 }` -> `{ id: 1 }`                                                 |
+  | `isBase64Encoded`            | `boolean`                                               | ما إذا كان جسم الطلب مُرمَّزًا بترميز base64                 |                                                                            |
+  | `requestContext.http.method` | `string`                                                | طريقة HTTP (GET, POST, PUT, PATCH, DELETE)                   |                                                                            |
+  | `requestContext.http.path`   | `string`                                                | المسار الخام للطلب                                           |                                                                            |
 
 
 #### forwardedRequestHeaders

packages/twenty-docs/l/ar/user-guide/billing/capabilities/pricing-plans.mdx

@@ -19,7 +19,7 @@ description: تعرّف على خطط تسعير Twenty وكيفية التبد
 * دعم قياسي
 
 <Note>
-Premium features (SSO, row-level permissions and AI usage data) are not included in the Pro plan.
+الميزات المتميزة (SSO وأذونات على مستوى الصف) غير مشمولة في خطة Pro.
 </Note>
 
 ### المؤسسة (سحابي)
@@ -27,7 +27,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
 للفرق الأكبر ذات الاحتياجات المتقدّمة:
 
 * كل ما في Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **ميزات متميزة**: تكامل SSO وأذونات على مستوى الصف
 * دعم متميز
 
 ## خطط الاستضافة الذاتية
@@ -45,7 +45,7 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
 للفرق التي تحتاج إلى ميزات متميزة أثناء الاستضافة الذاتية:
 
 * جميع ميزات Pro
-* **Premium features**: SSO integration, row-level permissions and AI usage data
+* **ميزات متميزة**: تكامل SSO وأذونات على مستوى الصف
 * دعم فريق Twenty
 * لا يُشترط نشر الشيفرة المخصّصة كمفتوح المصدر قبل التوزيع
 
@@ -55,7 +55,6 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
 
 * **تكامل SSO**: تسجيل دخول أحادي مع موفّر الهوية لديك
 * **أذونات على مستوى الصف**: تحكّم دقيق في الوصول على مستوى السجل
-* **AI usage data**: Track AI consumption across the workspace
 
 ## التبديل بين الخطط
 
@@ -78,15 +77,3 @@ Premium features (SSO, row-level permissions and AI usage data) are not included
 ### التبديل إلى الفوترة الشهرية
 
 تواصل مع الدعم للعودة إلى الفوترة الشهرية.
-
-## Obtain an Enterprise Key for Organization (Self-Hosted)
-
-To use the Organization (Self-Hosted) plan, you need to obtain an Enterprise key:
-
-1. Go to **Settings → Admin Panel → Enterprise**
-
-<img src="/images/user-guide/billing/enterprise-key.png" alt="Enterprise key" />
-
-2. Click **Get Enterprise Key**
-3. When you are redirected to Stripe, enter your payment details and confirm
-4. When your Enterprise key is displayed, paste it into the Enterprise settings page and activate the Organization license

packages/twenty-docs/l/ar/user-guide/billing/how-tos/billing-faq.mdx

@@ -16,11 +16,6 @@ description: الأسئلة الشائعة حول تسعير Twenty والفوت
 لا تتوفر الميزات المتميزة إلا في خطط Organization (السحابة أو الاستضافة الذاتية):
 * **تكامل SSO**: تسجيل الدخول الأحادي مع موفر الهوية لديك
 * **أذونات على مستوى السجل**: تحكم دقيق في الوصول على مستوى السجل
-* **بيانات استخدام الذكاء الاصطناعي**: تتبع استهلاك الذكاء الاصطناعي عبر مساحة العمل
-</Accordion>
-
-<Accordion title="هل خطة Organization على السحابة وخطة Organization ذاتية الاستضافة متماثلتان؟">
-كلتاهما تقدمان الميزات المتميزة نفسها. ومع ذلك، لا يمكن استخدام اشتراك السحابة لعمليات النشر ذاتية الاستضافة. يتطلب النشر ذاتي الاستضافة مفتاح Enterprise.
 </Accordion>
 
 <Accordion title="هل تقدمون مقاعد مجانية للمستخدمين العارضين فقط؟">

packages/twenty-docs/l/ar/user-guide/data-model/how-tos/create-many-to-many-relations.mdx

@@ -53,45 +53,38 @@ People ←→ Project Assignments ←→ Projects
 1. اذهب إلى **الإعدادات → نموذج البيانات**
 2. انقر **+ كائن جديد**
 3. سمِّه تسمية وصفية (مثلًا: "تعيين مشروع"، "عضو فريق"، "طلب منتج")
-4. فعِّل خيار "تخطي إنشاء حقل الاسم"
-
-<img src="/images/user-guide/fields/new-pivot-object.png" alt="كائن ربط جديد" />
-
-5. انقر على **حفظ**
+4. انقر على **حفظ**
 
 <Tip>
 **اتفاقية التسمية**: استخدم اسمًا يصف العلاقة، مثل "تعيين مشروع" أو "عضوية الفريق". هذا يجعل نموذج البيانات أسهل في الفهم.
 </Tip>
 
-## الخطوة 2: إنشاء علاقات بين الكائنات وكائن الربط
+## الخطوة 2: إنشاء علاقات من كائن الربط
 
-أضف حقول العلاقة من كلٍ من الكائنين لديك إلى كائن الربط.
+أضِف حقول علاقة من كائن الربط إلى كلا الكائنين اللذين تريد ربطهما.
 
-### العلاقة الأولى (الكائن A → كائن الربط)
-
-1. حدِّد الكائن الأول لديك في **الإعدادات → نموذج البيانات**
-2. انقر **+ إضافة علاقة**
-3. اختر كائن الربط (مثلًا، "تعيينات المشروع")
-4. عيِّن نوع العلاقة إلى **واحد-إلى-متعدد** (يمكن لشخص واحد الارتباط بالعديد من التعيينات)
-5. قم بتسمية الحقول:
-   * الحقل على الأشخاص: مثلًا، "تعيينات المشروع"
-   * الحقل على كائن الربط: مثلًا، "شخص"
-6. انقر على **حفظ**
-
-### العلاقة الثانية (الكائن B → كائن الربط)
-
-1. حدِّد الكائن الثاني لديك في **الإعدادات → نموذج البيانات**
-2. انقر **+ إضافة علاقة**
-3. اختر كائن الربط (مثلًا، "تعيينات المشروع")
-4. عيِّن نوع العلاقة إلى **واحد-إلى-متعدد** (يمكن لمشروع واحد الارتباط بالعديد من التعيينات)
-5. فعّل **"هذه علاقة بكائن ربط"**
-
-<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
+### العلاقة الأولى (كائن الربط → الكائن A)
 
+1. حدِّد كائن الربط في **الإعدادات → نموذج البيانات**
+2. انقر **+ إضافة حقل**
+3. اختر **العلاقة** كنوع الحقل
+4. اختر الكائن الأول (مثلًا، "الأشخاص")
+5. عيِّن نوع العلاقة إلى **متعدد-إلى-واحد** (يمكن لعديد من التعيينات الارتباط بشخص واحد)
 6. قم بتسمية الحقول:
+   * الحقل على كائن الربط: مثلًا، "شخص"
+   * الحقل على الأشخاص: مثلًا، "تعيينات المشروع"
+7. انقر على **حفظ**
+
+### العلاقة الثانية (كائن الربط → الكائن B)
+
+1. وأنت ما زلت في كائن الربط، انقر **+ إضافة حقل**
+2. اختر **العلاقة** كنوع الحقل
+3. اختر الكائن الثاني (مثلًا، "المشاريع")
+4. عيِّن نوع العلاقة إلى **متعدد-إلى-واحد**
+5. قم بتسمية الحقول:
    * الحقل على كائن الربط: مثلًا، "مشروع"
    * الحقل على المشاريع: مثلًا، "أعضاء الفريق"
-7. انقر على **حفظ**
+6. انقر على **حفظ**
 
 ## الخطوة 3: ضبط عرض علاقة الربط
 
@@ -105,6 +98,18 @@ People ←→ Project Assignments ←→ Projects
 6. حدِّد **العلاقة الهدف** (مثلًا، "مشروع" — الحقل على كائن الربط الذي يشير إلى الجانب الآخر)
 7. انقر على **حفظ**
 
+{/* TODO: Add image
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}}/>
+*/}
+
+كرِّر على الكائن الآخر:
+
+1. اختر "المشاريع" في نموذج البيانات
+2. حرِّر حقل العلاقة "أعضاء الفريق"
+3. فعّل مفتاح الربط
+4. حدِّد "شخص" كالعلاقة الهدف
+5. حفظ
+
 ## النتيجة
 
 بعد التكوين:
@@ -125,15 +130,15 @@ People ←→ Project Assignments ←→ Projects
 
 ### إضافة علاقات
 
-1. **الأشخاص → تعيين مشروع**
-   * النوع: واحد-إلى-متعدد
-   * الحقل على الأشخاص: "تعيينات المشروع"
+1. **تعيين مشروع → الأشخاص**
+   * النوع: متعدد-إلى-واحد
    * الحقل على التعيين: "شخص"
+   * الحقل على الأشخاص: "تعيينات المشروع"
 
-2. **المشاريع → تعيين مشروع**
-   * النوع: واحد-إلى-متعدد
-   * الحقل على المشاريع: "أعضاء الفريق"
+2. **تعيين مشروع → المشاريع**
+   * النوع: متعدد-إلى-واحد
    * الحقل على التعيين: "مشروع"
+   * الحقل على المشاريع: "أعضاء الفريق"
 
 ### ضبط عرض علاقة الربط
 

packages/twenty-docs/l/ar/user-guide/layout/capabilities/navigation.mdx

@@ -30,9 +30,3 @@ description: خصص الشريط الجانبي الأيسر ليتوافق مع
 ## قائمة الأوامر
 
 اضغط `Cmd+K` (أو `Ctrl+K`) لفتح قائمة الأوامر — شريط بحث للوصول السريع يتيح لك الانتقال إلى أي سجل أو طريقة عرض أو إجراء دون التنقل عبر الشريط الجانبي.
-
-## تخصيص الشريط الجانبي
-
-لتخصيص الشريط الجانبي، مرّر المؤشر فوق قسم "مساحة العمل" في الشريط الجانبي وانقر على أيقونة مفتاح الربط.
-
-<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="أيقونة تحرير التنقّل" />

packages/twenty-docs/l/ar/user-guide/layout/capabilities/record-pages.mdx

@@ -3,8 +3,6 @@ title: صفحات السجل
 description: خصص تخطيط صفحات تفاصيل السجلات باستخدام علامات تبويب وأدوات.
 ---
 
-## نظرة عامة
-
 عند فتح سجل في Twenty، تتكون صفحة التفاصيل من **علامات تبويب** و**أدوات**. كلاهما قابل للتخصيص بالكامل حسب نوع الكائن.
 
 ## علامات التبويب
@@ -40,20 +38,12 @@ description: خصص تخطيط صفحات تفاصيل السجلات باستخ
 
 1. افتح أي سجل
 2. اضغط على `Cmd+K` وابحث عن "تحرير تخطيط صفحة السجل"
-
-أو
-
-1. انتقل إلى الإعدادات > نموذج البيانات > الكائن الذي تختاره > التخطيط
-
-2. انقر على الزر "تخصيص صفحة السجل" لذلك الكائن
-
 3. أنت الآن في وضع التخصيص:
    * **أضف أدوات** من منتقي الأدوات
    * **اسحب الأدوات** لإعادة وضعها على الشبكة
    * **غيّر حجم الأدوات** بسحب حوافها
    * **اضبط الحقول** المعروضة داخل كل أداة
    * **أدِر علامات التبويب** — أضف، أزل، أعد التسمية، وأعد الترتيب
-
 4. احفظ تغييراتك — سيتم تطبيقها على جميع السجلات لذلك النوع من الكائنات
 
 ## ظهور الحقول