feat: create workspaces and user workspaces

feat: batch updates
fix: send id correctly
2026-02-26 18:31:59 +01:00 · 2026-02-26 16:46:37 +01:00 · 2026-02-26 16:29:26 +01:00 · 2026-02-26 16:15:31 +01:00 · 2026-02-26 13:41:17 +01:00 · 2026-02-25 17:51:12 +01:00
3615 changed files with 257315 additions and 81869 deletions
@@ -22,7 +22,7 @@ This directory contains Twenty's development guidelines and best practices in th

 ### React Development
 - **react-general-guidelines.mdc** - Core React development principles (Auto-attached to React files)
- **react-state-management.mdc** - State management approaches with Jotai (Auto-attached to state files)
+- **react-state-management.mdc** - State management approaches with Recoil (Auto-attached to state files)

 ### Testing & Quality
 - **testing-guidelines.mdc** - Testing strategies and best practices (Auto-attached to test files)
@@ -7,7 +7,7 @@ alwaysApply: true
 # Twenty Architecture

 ## Tech Stack
- **Frontend**: React 18, TypeScript, Jotai, Styled Components, Vite
+- **Frontend**: React 18, TypeScript, Recoil, Styled Components, Vite
 - **Backend**: NestJS, TypeORM, PostgreSQL, Redis, GraphQL
 - **Monorepo**: Nx workspace with yarn

@@ -4,20 +4,16 @@ alwaysApply: false
 ---
 # React State Management

-## Jotai Patterns
+## Recoil Patterns
 ```typescript
-// ✅ Atoms for primitive state (use createAtomState for keyed state with optional persistence)
-import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
-
-export const currentUserState = createAtomState<User | null>({
+// ✅ Atoms for primitive state
+export const currentUserState = atom<User | null>({
  key: 'currentUserState',
-  defaultValue: null,
+  default: null,
 });

-// ✅ Derived atoms for computed state (use createAtomSelector)
-import { createAtomSelector } from '@/ui/utilities/state/jotai/utils/createAtomSelector';
-
-export const userDisplayNameSelector = createAtomSelector({
+// ✅ Selectors for derived state
+export const userDisplayNameSelector = selector({
  key: 'userDisplayNameSelector',
  get: ({ get }) => {
    const user = get(currentUserState);
@@ -25,30 +21,13 @@ export const userDisplayNameSelector = createAtomSelector({
  },
 });

-// ✅ Atom factory pattern for dynamic atoms (use createAtomFamilyState)
-import { createAtomFamilyState } from '@/ui/utilities/state/jotai/utils/createAtomFamilyState';
-
-export const userByIdState = createAtomFamilyState<User | null, string>({
+// ✅ Atom families for dynamic atoms
+export const userByIdState = atomFamily<User | null, string>({
  key: 'userByIdState',
-  defaultValue: null,
+  default: null,
 });
 ```

-## Jotai Hooks
-```typescript
-// useAtomState - read and write
-import { useAtomState } from '@/ui/utilities/state/jotai/hooks/useAtomState';
-
-// useAtomStateValue - read only
-import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
-
-// useSetAtomState - write only
-import { useSetAtomState } from '@/ui/utilities/state/jotai/hooks/useSetAtomState';
-```
-
-## Provider
-Jotai works without a Provider by default. For scoped stores or testing, use `Provider` from `jotai`.
-
 ## Local State Guidelines
 ```typescript
 // ✅ Multiple useState for unrelated state
@@ -95,7 +74,7 @@ const increment = useCallback(() => {
 ```

 ## Performance Tips
- Use atom factory pattern (createAtomFamilyState) for dynamic data collections
- Derived atoms (createAtomSelector) are automatically memoized by Jotai
- Avoid heavy computations in derived atoms
+- Use atom families for dynamic data collections
+- Implement proper selector caching
+- Avoid heavy computations in selectors
 - Batch state updates when possible
@@ -771,16 +771,16 @@ jobs:
            kill $(cat /tmp/main-server.pid) || true
          fi

-      # - name: Upload API specifications and diffs
-      #   if: always()
-      #   uses: actions/upload-artifact@v4
-      #   with:
-      #     name: api-specifications-and-diffs
-      #     path: |
-      #       /tmp/main-server.log
-      #       /tmp/current-server.log
-      #       *-api.json
-      #       *-schema-introspection.json
-      #       *-diff.md
-      #       *-diff.json
+      - name: Upload API specifications and diffs
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: api-specifications-and-diffs
+          path: |
+            /tmp/main-server.log
+            /tmp/current-server.log
+            *-api.json
+            *-schema-introspection.json
+            *-diff.md
+            *-diff.json

@@ -98,47 +98,47 @@ jobs:
        run: npx nx reset:env twenty-front
      - name: Run storybook tests
        run: npx nx storybook:test twenty-front --configuration=${{ matrix.storybook_scope }} --shard=${{ matrix.shard }}/${{ env.SHARD_COUNTER }}
-      # - name: Rename coverage file
-      #   run: |
-      #     if [ -f "packages/twenty-front/coverage/storybook/coverage-final.json" ]; then
-      #       mv packages/twenty-front/coverage/storybook/coverage-final.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
-      #     else
-      #       echo "Error: coverage-final.json not found"
-      #       ls -la packages/twenty-front/coverage/storybook/ || echo "Coverage directory does not exist"
-      #       exit 1
-      #     fi
-      # - name: Upload coverage artifact
-      #   uses: actions/upload-artifact@v4
-      #   with:
-      #     retention-days: 1
-      #     name: coverage-artifacts-${{ matrix.storybook_scope }}-${{ github.run_id }}-${{ matrix.shard }}
-      #     path: packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
-  # merge-reports-and-check-coverage:
-  #   timeout-minutes: 30
-  #   runs-on: depot-ubuntu-24.04
-  #   needs: front-sb-test
-  #   env:
-  #     PATH_TO_COVERAGE: packages/twenty-front/coverage/storybook
-  #   strategy:
-  #     matrix:
-  #       storybook_scope: [modules, pages, performance]
-  #   steps:
-  #     - uses: actions/checkout@v4
-  #       with:
-  #         fetch-depth: 0
-  #     - name: Install dependencies
-  #       uses: ./.github/actions/yarn-install
-  #     - uses: actions/download-artifact@v4
-  #       with:
-  #         pattern: coverage-artifacts-${{ matrix.storybook_scope }}-${{ github.run_id }}-*
-  #         merge-multiple: true
-  #         path: coverage-artifacts
-  #     - name: Merge coverage reports
-  #       run: |
-  #         mkdir -p ${{ env.PATH_TO_COVERAGE }}
-  #         npx nyc merge coverage-artifacts ${{ env.PATH_TO_COVERAGE }}/coverage-storybook.json
-  #     - name: Checking coverage
-  #       run: npx nx storybook:coverage twenty-front --checkCoverage=true --configuration=${{ matrix.storybook_scope }}
+      - name: Rename coverage file
+        run: |
+          if [ -f "packages/twenty-front/coverage/storybook/coverage-final.json" ]; then
+            mv packages/twenty-front/coverage/storybook/coverage-final.json packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
+          else
+            echo "Error: coverage-final.json not found"
+            ls -la packages/twenty-front/coverage/storybook/ || echo "Coverage directory does not exist"
+            exit 1
+          fi
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          retention-days: 1
+          name: coverage-artifacts-${{ matrix.storybook_scope }}-${{ github.run_id }}-${{ matrix.shard }}
+          path: packages/twenty-front/coverage/storybook/coverage-shard-${{matrix.shard}}.json
+  merge-reports-and-check-coverage:
+    timeout-minutes: 30
+    runs-on: depot-ubuntu-24.04
+    needs: front-sb-test
+    env:
+      PATH_TO_COVERAGE: packages/twenty-front/coverage/storybook
+    strategy:
+      matrix:
+        storybook_scope: [modules, pages, performance]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install dependencies
+        uses: ./.github/actions/yarn-install
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: coverage-artifacts-${{ matrix.storybook_scope }}-${{ github.run_id }}-*
+          merge-multiple: true
+          path: coverage-artifacts
+      - name: Merge coverage reports
+        run: |
+          mkdir -p ${{ env.PATH_TO_COVERAGE }}
+          npx nyc merge coverage-artifacts ${{ env.PATH_TO_COVERAGE }}/coverage-storybook.json
+      - name: Checking coverage
+        run: npx nx storybook:coverage twenty-front --checkCoverage=true --configuration=${{ matrix.storybook_scope }}
  front-chromatic-deployment:
    timeout-minutes: 30
    if: false
@@ -229,12 +229,12 @@ jobs:
        run: npx nx reset:env twenty-front
      - name: Build frontend
        run: npx nx build twenty-front
-      # - name: Upload frontend build artifact
-      #   uses: actions/upload-artifact@v4
-      #   with:
-      #     name: frontend-build
-      #     path: packages/twenty-front/build
-      #     retention-days: 1
+      - name: Upload frontend build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: frontend-build
+          path: packages/twenty-front/build
+          retention-days: 1
  e2e-test:
    runs-on: depot-ubuntu-24.04
    needs: [changed-files-check-e2e, front-build]
@@ -296,18 +296,15 @@ jobs:
          cp packages/twenty-front/.env.example packages/twenty-front/.env
          npx nx reset:env:e2e-testing-server twenty-server

-      # - name: Download frontend build artifact
-      #   if: needs.front-build.result == 'success'
-      #   uses: actions/download-artifact@v4
-      #   with:
-      #     name: frontend-build
-      #     path: packages/twenty-front/build
+      - name: Download frontend build artifact
+        if: needs.front-build.result == 'success'
+        uses: actions/download-artifact@v4
+        with:
+          name: frontend-build
+          path: packages/twenty-front/build

-      # - name: Build frontend (if not available from front-build)
-      #   if: needs.front-build.result == 'skipped'
-      #   run: NODE_ENV=production NODE_OPTIONS="--max-old-space-size=10240" npx nx build twenty-front
-
-      - name: Build frontend
+      - name: Build frontend (if not available from front-build)
+        if: needs.front-build.result == 'skipped'
        run: NODE_ENV=production NODE_OPTIONS="--max-old-space-size=10240" npx nx build twenty-front

      - name: Build server
@@ -339,12 +336,12 @@ jobs:
      - name: Run Playwright tests
        run: npx nx test twenty-e2e-testing

-      # - uses: actions/upload-artifact@v4
-      #   if: always()
-      #   with:
-      #     name: playwright-report
-      #     path: packages/twenty-e2e-testing/run_results/
-      #     retention-days: 30
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-report
+          path: packages/twenty-e2e-testing/run_results/
+          retention-days: 30

  ci-front-status-check:
    if: always() && !cancelled()
@@ -355,7 +352,7 @@ jobs:
        changed-files-check,
        front-task,
        front-build,
-        # merge-reports-and-check-coverage,
+        merge-reports-and-check-coverage,
        front-sb-test,
        front-sb-build,
      ]
@@ -1,60 +0,0 @@
-name: CI Zapier
-
-on:
-  push:
-    branches:
-      - main
-
-  pull_request:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-jobs:
-  changed-files-check:
-    uses: ./.github/workflows/changed-files.yaml
-    with:
-      files: |
-        packages/twenty-zapier/**
-        packages/twenty-server/**
-        !packages/twenty-zapier/package.json
-        !packages/twenty-zapier/CHANGELOG.md
-  zapier-test:
-    needs: changed-files-check
-    if: needs.changed-files-check.outputs.any_changed == 'true'
-    timeout-minutes: 30
-    runs-on: depot-ubuntu-24.04
-    strategy:
-      matrix:
-        task: [lint, typecheck, test, validate]
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.11.0
-        with:
-          access_token: ${{ github.token }}
-      - name: Fetch custom Github Actions and base branch history
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Install dependencies
-        uses: ./.github/actions/yarn-install
-      - name: Build
-        run: npx nx build twenty-zapier
-      - name: Run ${{ matrix.task }} task
-        uses: ./.github/actions/nx-affected
-        with:
-          tag: scope:zapier
-          tasks: ${{ matrix.task }}
-  ci-zapier-status-check:
-    if: always() && !cancelled()
-    timeout-minutes: 5
-    runs-on: depot-ubuntu-24.04
-    needs: [changed-files-check, zapier-test]
-    steps:
-      - name: Fail job if any needs failed
-        if: contains(needs.*.result, 'failure')
-        run: exit 1
@@ -90,7 +90,7 @@ npx nx run twenty-front:graphql:generate --configuration=metadata
 ## Architecture Overview

 ### Tech Stack
- **Frontend**: React 18, TypeScript, Jotai (state management), Emotion (styling), Vite
+- **Frontend**: React 18, TypeScript, Recoil (state management), Emotion (styling), Vite
 - **Backend**: NestJS, TypeORM, PostgreSQL, Redis, GraphQL (with GraphQL Yoga)
 - **Monorepo**: Nx workspace managed with Yarn 4

@@ -138,7 +138,7 @@ packages/
 - 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
+- **Recoil** for global state: atoms for primitive state, selectors for derived state, atom families for dynamic collections
 - Component-specific state with React hooks (`useState`, `useReducer` for complex logic)
 - GraphQL cache managed by Apollo Client
 - Use functional state updates: `setState(prev => prev + 1)`
@@ -109,7 +109,7 @@ Below are a few features we have implemented to date:
 - [TypeScript](https://www.typescriptlang.org/)
 - [Nx](https://nx.dev/)
 - [NestJS](https://nestjs.com/), with [BullMQ](https://bullmq.io/), [PostgreSQL](https://www.postgresql.org/), [Redis](https://redis.io/)
- [React](https://reactjs.org/), with [Jotai](https://jotai.org/), [Emotion](https://emotion.sh/) and [Lingui](https://lingui.dev/)
+- [React](https://reactjs.org/), with [Recoil](https://recoiljs.org/), [Emotion](https://emotion.sh/) and [Lingui](https://lingui.dev/)



@@ -83,10 +83,6 @@ export default [
              sourceTag: 'scope:frontend',
              onlyDependOnLibsWithTags: ['scope:shared', 'scope:frontend'],
            },
-            {
-              sourceTag: 'scope:zapier',
-              onlyDependOnLibsWithTags: ['scope:shared', 'scope:zapier'],
-            },
          ],
        },
      ],
@@ -126,7 +126,7 @@
      "configurations": {
        "ci": {
          "ci": true,
-          "maxWorkers": 1
+          "maxWorkers": 3
        },
        "coverage": {
          "coverageReporters": ["lcov", "text"]
@@ -48,7 +48,8 @@
    "react-responsive": "^9.0.2",
    "react-router-dom": "^6.4.4",
    "react-tooltip": "^5.13.1",
-    "remark-gfm": "^4.0.1",
+    "recoil": "^0.7.7",
+    "remark-gfm": "^3.0.1",
    "rxjs": "^7.2.0",
    "semver": "^7.5.4",
    "slash": "^5.1.0",
@@ -31,6 +31,10 @@ See Twenty application documentation https://docs.twenty.com/developers/extend/c
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app

+# If you don't use yarn@4
+corepack enable
+yarn install
+
 # Get help and list all available commands
 yarn twenty help

@@ -41,7 +45,7 @@ yarn twenty auth:login
 yarn twenty entity:add

 # Start dev mode: watches, builds, and syncs local changes to your workspace
-# (also auto-generates typed API clients — CoreApiClient and MetadataApiClient — in node_modules/twenty-sdk/generated)
+# (also auto-generates a typed API client in node_modules/twenty-sdk/generated)
 yarn twenty app:dev

 # Watch your application's function logs
@@ -50,9 +54,6 @@ yarn twenty function:logs
 # Execute a function with a JSON payload
 yarn twenty function:execute -n my-function -p '{"key": "value"}'

-# Execute the pre-install function
-yarn twenty function:execute --preInstall
-
 # Execute the post-install function
 yarn twenty function:execute --postInstall

@@ -95,7 +96,6 @@ In interactive mode, you can pick from:
 **Core files (always created):**
 - `application-config.ts` — Application metadata configuration
 - `roles/default-role.ts` — Default role for logic functions
- `logic-functions/pre-install.ts` — Pre-install logic function (runs before app installation)
 - `logic-functions/post-install.ts` — Post-install logic function (runs after app installation)
 - TypeScript configuration, ESLint, package.json, .gitignore
 - A prewired `twenty` script that delegates to the `twenty` CLI from twenty-sdk
@@ -114,7 +114,7 @@ In interactive mode, you can pick from:
 - Use `yarn twenty auth:login` to authenticate with your Twenty workspace.
 - Explore the generated project and add your first entity with `yarn twenty entity:add` (logic functions, front components, objects, roles, views, navigation menu items, skills).
 - Use `yarn twenty app:dev` while you iterate — it watches, builds, and syncs changes to your workspace in real time.
- Two typed API clients are auto‑generated by `yarn twenty app:dev` and stored in `node_modules/twenty-sdk/generated`: `CoreApiClient` (for workspace data via `/graphql`) and `MetadataApiClient` (for workspace configuration and file uploads via `/metadata`).
+- Types are auto‑generated by `yarn twenty app:dev` and stored in `node_modules/twenty-sdk/generated`.


 ## Publish your application
@@ -1,5 +1,5 @@
 const jestConfig = {
-  displayName: 'create-twenty-app',
+  displayName: 'twenty-cli',
  preset: '../../jest.preset.js',
  testEnvironment: 'node',
  transformIgnorePatterns: ['../../node_modules/'],
@@ -1,6 +1,6 @@
 {
  "name": "create-twenty-app",
-  "version": "0.6.2",
+  "version": "0.6.0",
  "description": "Command-line interface to create Twenty application",
  "main": "dist/cli.cjs",
  "bin": "dist/cli.cjs",
@@ -3,9 +3,6 @@
 - Documentation: https://docs.twenty.com/developers/extend/capabilities/apps
 - Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-sdk/src/cli/__tests__/apps/rich-app

-## UUID requirement
- All generated UUIDs must be valid UUID v4.
-
 ## Common Pitfalls

 - Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
@@ -233,9 +233,9 @@ export class CreateAppCommand {
    console.log('');
    console.log(chalk.blue('Next steps:'));
    console.log(chalk.gray(`  cd ${dirName}`));
-    console.log(
-      chalk.gray('  yarn twenty auth:login  # Authenticate with Twenty'),
-    );
-    console.log(chalk.gray('  yarn twenty app:dev     # Start dev mode'));
+    console.log(chalk.gray(`  corepack enable  # if you don't use yarn@4`));
+    console.log(chalk.gray(`  yarn install     # if you don't use yarn@4`));
+    console.log(chalk.gray('  yarn auth:login  # Authenticate with Twenty'));
+    console.log(chalk.gray('  yarn app:dev     # Start dev mode'));
  }
 }
@@ -375,18 +375,6 @@ describe('copyBaseApplicationProject', () => {
            ),
          ),
        ).toBe(true);
-
-        // Install functions should always exist
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'pre-install.ts'),
-          ),
-        ).toBe(true);
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'post-install.ts'),
-          ),
-        ).toBe(true);
      });
    });

@@ -410,18 +398,6 @@ describe('copyBaseApplicationProject', () => {
          await fs.pathExists(join(srcPath, 'roles', DEFAULT_ROLE_FILE_NAME)),
        ).toBe(true);

-        // Install functions should always exist (not gated by exampleOptions)
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'pre-install.ts'),
-          ),
-        ).toBe(true);
-        expect(
-          await fs.pathExists(
-            join(srcPath, 'logic-functions', 'post-install.ts'),
-          ),
-        ).toBe(true);
-
        // Example files should not exist
        expect(
          await fs.pathExists(join(srcPath, 'objects', 'example-object.ts')),
@@ -700,124 +676,4 @@ describe('copyBaseApplicationProject', () => {
      expect(content).toContain('position: 0');
    });
  });
-
-  describe('pre-install logic function', () => {
-    it('should create pre-install.ts with definePreInstallLogicFunction and typed payload', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const preInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'pre-install.ts',
-      );
-
-      expect(await fs.pathExists(preInstallPath)).toBe(true);
-
-      const content = await fs.readFile(preInstallPath, 'utf8');
-
-      expect(content).toContain(
-        "import { definePreInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk'",
-      );
-      expect(content).toContain(
-        'export default definePreInstallLogicFunction({',
-      );
-      expect(content).toContain("name: 'pre-install'");
-      expect(content).toContain('timeoutSeconds: 300');
-      expect(content).toContain(
-        'const handler = async (payload: InstallLogicFunctionPayload): Promise<void>',
-      );
-      expect(content).toContain('payload.previousVersion');
-
-      // Verify it has a universalIdentifier (UUID format)
-      expect(content).toMatch(
-        /universalIdentifier: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'/,
-      );
-    });
-
-    it('should always create pre-install.ts regardless of example options', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const preInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'pre-install.ts',
-      );
-
-      expect(await fs.pathExists(preInstallPath)).toBe(true);
-    });
-  });
-
-  describe('post-install logic function', () => {
-    it('should create post-install.ts with definePostInstallLogicFunction and typed payload', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const postInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'post-install.ts',
-      );
-
-      expect(await fs.pathExists(postInstallPath)).toBe(true);
-
-      const content = await fs.readFile(postInstallPath, 'utf8');
-
-      expect(content).toContain(
-        "import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk'",
-      );
-      expect(content).toContain(
-        'export default definePostInstallLogicFunction({',
-      );
-      expect(content).toContain("name: 'post-install'");
-      expect(content).toContain('timeoutSeconds: 300');
-      expect(content).toContain(
-        'const handler = async (payload: InstallLogicFunctionPayload): Promise<void>',
-      );
-      expect(content).toContain('payload.previousVersion');
-
-      // Verify it has a universalIdentifier (UUID format)
-      expect(content).toMatch(
-        /universalIdentifier: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}'/,
-      );
-    });
-
-    it('should always create post-install.ts regardless of example options', async () => {
-      await copyBaseApplicationProject({
-        appName: 'my-test-app',
-        appDisplayName: 'My Test App',
-        appDescription: 'A test application',
-        appDirectory: testAppDirectory,
-        exampleOptions: NO_EXAMPLES,
-      });
-
-      const postInstallPath = join(
-        testAppDirectory,
-        'src',
-        'logic-functions',
-        'post-install.ts',
-      );
-
-      expect(await fs.pathExists(postInstallPath)).toBe(true);
-    });
-  });
 });
@@ -97,12 +97,6 @@ export const copyBaseApplicationProject = async ({
    });
  }

-  await createDefaultPreInstallFunction({
-    appDirectory: sourceFolderPath,
-    fileFolder: 'logic-functions',
-    fileName: 'pre-install.ts',
-  });
-
  await createDefaultPostInstallFunction({
    appDirectory: sourceFolderPath,
    fileFolder: 'logic-functions',
@@ -274,36 +268,6 @@ export default defineLogicFunction({
  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
 };

-const createDefaultPreInstallFunction = async ({
-  appDirectory,
-  fileFolder,
-  fileName,
-}: {
-  appDirectory: string;
-  fileFolder?: string;
-  fileName: string;
-}) => {
-  const universalIdentifier = v4();
-
-  const content = `import { definePreInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
-
-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Pre install logic function executed successfully!', payload.previousVersion);
-};
-
-export default definePreInstallLogicFunction({
-  universalIdentifier: '${universalIdentifier}',
-  name: 'pre-install',
-  description: 'Runs before installation to prepare the application.',
-  timeoutSeconds: 300,
-  handler,
-});
-`;
-
-  await fs.ensureDir(join(appDirectory, fileFolder ?? ''));
-  await fs.writeFile(join(appDirectory, fileFolder ?? '', fileName), content);
-};
-
 const createDefaultPostInstallFunction = async ({
  appDirectory,
  fileFolder,
@@ -315,14 +279,16 @@ const createDefaultPostInstallFunction = async ({
 }) => {
  const universalIdentifier = v4();

-  const content = `import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+  const content = `import { defineLogicFunction } from 'twenty-sdk';

-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Post install logic function executed successfully!', payload.previousVersion);
+export const POST_INSTALL_UNIVERSAL_IDENTIFIER = '${universalIdentifier}';
+
+const handler = async (): Promise<void> => {
+  console.log('Post install logic function executed successfully!');
 };

-export default definePostInstallLogicFunction({
-  universalIdentifier: '${universalIdentifier}',
+export default defineLogicFunction({
+  universalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
  name: 'post-install',
  description: 'Runs after installation to set up the application.',
  timeoutSeconds: 300,
@@ -511,12 +477,14 @@ const createApplicationConfig = async ({
 }) => {
  const content = `import { defineApplication } from 'twenty-sdk';
 import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';

 export default defineApplication({
  universalIdentifier: '${v4()}',
  displayName: '${displayName}',
  description: '${description ?? ''}',
  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
 });
 `;

@@ -6,13 +6,7 @@ const execPromise = promisify(exec);

 export const install = async (root: string) => {
  try {
-    await execPromise('corepack enable', { cwd: root });
-  } catch (error: any) {
-    console.warn(chalk.yellow('corepack enabled failed:'), error.stderr);
-  }
-
-  try {
-    await execPromise('yarn install', { cwd: root });
+    await execPromise('yarn', { cwd: root });
  } catch (error: any) {
    console.error(chalk.red('yarn install failed:'), error.stdout);
  }
@@ -0,0 +1,38 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn
+
+# codegen
+generated
+
+# testing
+/coverage
+
+# dev
+/dist/
+
+.twenty/*
+!.twenty/output/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# typescript
+*.tsbuildinfo
@@ -0,0 +1 @@
+24.5.0
@@ -0,0 +1,28 @@
+{
+  "name": "twentyfortwenty",
+  "version": "0.1.0",
+  "license": "MIT",
+  "engines": {
+    "node": "^24.5.0",
+    "npm": "please-use-yarn",
+    "yarn": ">=4.0.2"
+  },
+  "packageManager": "yarn@4.9.2",
+  "scripts": {
+    "twenty": "twenty",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
+  },
+  "dependencies": {
+    "twenty-sdk": "latest",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "@types/react": "^18.2.0",
+    "eslint": "^9.32.0",
+    "react": "^18.2.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.0"
+  }
+}
@@ -0,0 +1 @@
+nodeLinker: node-modules
@@ -0,0 +1,9 @@
+## Base documentation
+
+- Documentation: https://docs.twenty.com/developers/extend/capabilities/apps
+- Rich app example: https://github.com/twentyhq/twenty/tree/main/packages/twenty-sdk/src/cli/__tests__/apps/rich-app
+
+## Common Pitfalls
+
+- Creating an object without an index view associated. Unless this is a technical object, user will need to visualize it.
+- Creating a view without a navigationMenuItem associated. This will make the view available on the left sidebar.
@@ -0,0 +1,51 @@
+This is a [Twenty](https://twenty.com) application project bootstrapped with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app).
+
+## Getting Started
+
+First, authenticate to your workspace:
+
+```bash
+yarn twenty auth:login
+```
+
+Then, start development mode to sync your app and watch for changes:
+
+```bash
+yarn twenty app:dev
+```
+
+Open your Twenty instance and go to `/settings/applications` section to see the result.
+
+## Available Commands
+
+Run `yarn twenty help` to list all available commands. Common commands:
+
+```bash
+# Authentication
+yarn twenty auth:login     # Authenticate with Twenty
+yarn twenty auth:logout    # Remove credentials
+yarn twenty auth:status    # Check auth status
+yarn twenty auth:switch    # Switch default workspace
+yarn twenty auth:list      # List all configured workspaces
+
+# Application
+yarn twenty app:dev        # Start dev mode (watch, build, sync, and auto-generate typed client)
+yarn twenty entity:add     # Add a new entity (object, field, function, front-component, role, view, navigation-menu-item)
+yarn twenty function:logs  # Stream function logs
+yarn twenty function:execute  # Execute a function with JSON payload
+yarn twenty app:uninstall  # Uninstall app from workspace
+```
+
+## LLMs instructions
+
+Main docs and pitfalls are available in LLMS.md file.
+
+## Learn More
+
+To learn more about Twenty applications, take a look at the following resources:
+
+- [twenty-sdk](https://www.npmjs.com/package/twenty-sdk) - learn about `twenty-sdk` tool.
+- [Twenty doc](https://docs.twenty.com/) - Twenty's documentation.
+- Join our [Discord](https://discord.gg/cx5n4Jzs57)
+
+You can check out [the Twenty GitHub repository](https://github.com/twentyhq/twenty) - your feedback and contributions are welcome!
@@ -0,0 +1,29 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default [
+  // Base JS recommended rules
+  js.configs.recommended,
+
+  // TypeScript recommended rules
+  ...tseslint.configs.recommended,
+
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parserOptions: {
+        project: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      // Common TypeScript-friendly tweaks
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        { argsIgnorePattern: '^_' },
+      ],
+      '@typescript-eslint/no-explicit-any': 'off',
+      'no-unused-vars': 'off', // handled by TS rule
+    },
+  },
+];
@@ -0,0 +1,28 @@
+{
+  "name": "twentyfortwenty",
+  "version": "0.1.0",
+  "license": "MIT",
+  "engines": {
+    "node": "^24.5.0",
+    "npm": "please-use-yarn",
+    "yarn": ">=4.0.2"
+  },
+  "packageManager": "yarn@4.9.2",
+  "scripts": {
+    "twenty": "twenty",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
+  },
+  "dependencies": {
+    "twenty-sdk": "latest",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "@types/react": "^18.2.0",
+    "eslint": "^9.32.0",
+    "react": "^18.2.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.50.0"
+  }
+}
@@ -0,0 +1,31 @@
+import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { defineApplication } from 'twenty-sdk';
+
+export default defineApplication({
+  universalIdentifier: '0fac8de4-9d11-492b-9e6a-577e11e1c442',
+  displayName: 'Twenty for Twenty',
+  description: '',
+  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  applicationVariables: {
+    CLICKHOUSE_URL: {
+      universalIdentifier: 'b204304f-d3d3-4ae2-aafa-24b21c159181',
+      description: 'The URL of the ClickHouse server, including the protocol and port (e.g., http://localhost:8123)',
+      isSecret: true,
+    },
+    CLICKHOUSE_USERNAME: {
+      universalIdentifier: '711e8ea8-8b19-4cf0-82ab-ab44417312bd',
+      description: 'The username for authenticating with the ClickHouse server',
+      isSecret: true,
+    },
+    CLICKHOUSE_PASSWORD: {
+      universalIdentifier: 'faba7ed7-9f94-4202-944b-c25c683e9504',
+      description: 'The password for authenticating with the ClickHouse server',
+      isSecret: true,
+    },
+    CLICKHOUSE_DATABASE: {
+      universalIdentifier: '3e6698fa-0c00-49e5-9c4d-34d5b177bff3',
+      description: 'The name of the ClickHouse database to connect to',
+      isSecret: true,
+    },
+  },
+});
@@ -0,0 +1,37 @@
+// Field metadata identifiers for cloudUser2 object
+// These constants are used by both the object definition and views
+
+export const CLOUD_USER_2_ACTIVITY_STATUS_FIELD_ID =
+  '56e3d6ce-d57e-4ded-830f-958eb18d4d36';
+export const CLOUD_USER_2_AVG_DAILY_PAGEVIEWS_LAST_30D_FIELD_ID =
+  '1f7062c1-0e96-4599-a59c-6d7427794bb1';
+export const CLOUD_USER_2_DATA_LAST_UPDATED_AT_FIELD_ID =
+  'e134ce6b-5ab0-4e9c-ba32-36d0851aca21';
+export const CLOUD_USER_2_DAYS_SINCE_LAST_ACTIVITY_FIELD_ID =
+  'f305d341-7b12-4939-9299-e5e1b6d1591e';
+export const CLOUD_USER_2_EMAIL_FIELD_ID =
+  'ee110a77-34d7-4c8b-bc10-8560b9e2333a';
+export const CLOUD_USER_2_FULL_NAME_FIELD_ID =
+  '3c9540be-6e42-40f2-8598-973117bbe105';
+export const CLOUD_USER_2_IS_ACTIVE_L24H_FIELD_ID =
+  'efaa6e54-8019-454c-a556-2e340f0b156d';
+export const CLOUD_USER_2_IS_ACTIVE_L30D_FIELD_ID =
+  '86a07ca4-420e-4c82-82f8-8f8dfbfc2dc4';
+export const CLOUD_USER_2_IS_ACTIVE_L7D_FIELD_ID =
+  '87bf8c09-1863-4c65-811f-6fb54a87238e';
+export const CLOUD_USER_2_IS_TWENTY_FIELD_ID =
+  'f6dcd9f3-3f7e-4aea-84a5-41282a68910d';
+export const CLOUD_USER_2_LAST_ACTIVITY_DATE_FIELD_ID =
+  '643ab4a2-b6f2-4d11-9173-6859884b8781';
+export const CLOUD_USER_2_PAGE_VIEWS_L24H_FIELD_ID =
+  '294e95cb-13b3-4163-95f8-e4f31837cb47';
+export const CLOUD_USER_2_PAGE_VIEWS_L30D_FIELD_ID =
+  '8dacb4f1-b4ef-42d6-a917-17c78d6273a7';
+export const CLOUD_USER_2_PAGE_VIEWS_L7D_FIELD_ID =
+  'c7741332-d9b6-42ed-84e2-8afa184b58f3';
+export const CLOUD_USER_2_UPDATED_BY_FIELD_ID =
+  '639c9a30-2926-44c3-ab44-100dbda91c64';
+export const CLOUD_USER_2_USER_TENURE_FIELD_ID =
+  '0cc9ca63-c06f-4422-9325-5e99f98d05ed';
+export const CLOUD_USER_2_WORKSPACE_COUNT_FIELD_ID =
+  '5af6ae62-b741-471b-90bb-7fb6678fc8c9';
@@ -0,0 +1,25 @@
+import { defineField, FieldType, OnDeleteAction, RelationType } from 'twenty-sdk';
+
+import {
+    CLOUD_USER_ON_CLOUD_USER_WORKSPACE_ID,
+    CLOUD_USER_WORKSPACES_ON_CLOUD_USER_ID,
+} from 'src/fields/cloud-user-workspaces-on-cloud-user.field';
+import { CLOUD_USER_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-2';
+import { CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-workspace-2';
+
+export default defineField({
+  universalIdentifier: CLOUD_USER_ON_CLOUD_USER_WORKSPACE_ID,
+  objectUniversalIdentifier: CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  type: FieldType.RELATION,
+  name: 'cloudUser2',
+  label: 'Cloud User 2',
+  relationTargetObjectMetadataUniversalIdentifier:
+    CLOUD_USER_2_UNIVERSAL_IDENTIFIER,
+  relationTargetFieldMetadataUniversalIdentifier:
+    CLOUD_USER_WORKSPACES_ON_CLOUD_USER_ID,
+  universalSettings: {
+    relationType: RelationType.MANY_TO_ONE,
+    onDelete: OnDeleteAction.CASCADE,
+    joinColumnName: 'cloudUser2Id',
+  },
+});
@@ -0,0 +1,11 @@
+// Field metadata identifiers for cloudUserWorkspace2 object
+// These constants are used by both the object definition and views
+
+export const CLOUD_USER_WORKSPACE_2_TWENTY_USER_IDENTIFIER_FIELD_ID =
+  'ad149693-0df5-4346-90ff-39e6d945b90f';
+export const CLOUD_USER_WORKSPACE_2_TWENTY_WORKSPACE_IDENTIFIER_FIELD_ID =
+  'c5d02b59-ebaf-4604-809c-ce3f6e50dedc';
+export const CLOUD_USER_WORKSPACE_2_ID_OF_THE_USER_WORKSPACE_FIELD_ID =
+  '6a0f8018-be3c-49b0-bb91-8d3e6b44adec';
+export const CLOUD_USER_WORKSPACE_2_UPDATED_BY_FIELD_ID =
+  '29d47f11-1e45-4c67-b495-fcfa45bb67e2';
@@ -0,0 +1,24 @@
+import { defineField, FieldType, RelationType } from 'twenty-sdk';
+
+import { CLOUD_USER_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-2';
+import { CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-workspace-2';
+
+export const CLOUD_USER_WORKSPACES_ON_CLOUD_USER_ID =
+  '2290d722-d4b1-47ab-a895-4e2c3163a541';
+export const CLOUD_USER_ON_CLOUD_USER_WORKSPACE_ID =
+  '49b08cf9-15e1-4583-826f-943fe3c6b0e8';
+
+export default defineField({
+  universalIdentifier: CLOUD_USER_WORKSPACES_ON_CLOUD_USER_ID,
+  objectUniversalIdentifier: CLOUD_USER_2_UNIVERSAL_IDENTIFIER,
+  type: FieldType.RELATION,
+  name: 'cloudUserWorkspaces2',
+  label: 'Cloud User Workspaces 2',
+  relationTargetObjectMetadataUniversalIdentifier:
+    CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  relationTargetFieldMetadataUniversalIdentifier:
+    CLOUD_USER_ON_CLOUD_USER_WORKSPACE_ID,
+  universalSettings: {
+    relationType: RelationType.ONE_TO_MANY,
+  },
+});
@@ -0,0 +1,24 @@
+import { defineField, FieldType, RelationType } from 'twenty-sdk';
+
+import { CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-workspace-2';
+import { CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-workspace-2';
+
+export const CLOUD_USER_WORKSPACES_ON_CLOUD_WORKSPACE_ID =
+  '90d9dfc7-7058-4d1c-aac2-1505bd7cb827';
+export const CLOUD_WORKSPACE_ON_CLOUD_USER_WORKSPACE_ID =
+  '7bcd2dda-d1f8-4aa7-a83f-6cf240be80b2';
+
+export default defineField({
+  universalIdentifier: CLOUD_USER_WORKSPACES_ON_CLOUD_WORKSPACE_ID,
+  objectUniversalIdentifier: CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  type: FieldType.RELATION,
+  name: 'cloudUserWorkspaces2',
+  label: 'Cloud User Workspaces 2',
+  relationTargetObjectMetadataUniversalIdentifier:
+    CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  relationTargetFieldMetadataUniversalIdentifier:
+    CLOUD_WORKSPACE_ON_CLOUD_USER_WORKSPACE_ID,
+  universalSettings: {
+    relationType: RelationType.ONE_TO_MANY,
+  },
+});
@@ -0,0 +1,28 @@
+import {
+    defineField,
+    FieldType,
+    RelationType,
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
+
+import { CLOUD_USER_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-2';
+
+export const CLOUD_USERS_2_ON_PERSON_ID =
+  'f238e91c-11d8-4a27-a39b-c9fa3515d4a0';
+export const PERSON_ON_CLOUD_USER_2_ID =
+  '08d3aff0-7548-4a99-a097-20a0ad2c9ee7';
+
+export default defineField({
+  universalIdentifier: CLOUD_USERS_2_ON_PERSON_ID,
+  objectUniversalIdentifier:
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+  type: FieldType.RELATION,
+  name: 'cloudUsers2',
+  label: 'Cloud Users 2',
+  relationTargetObjectMetadataUniversalIdentifier:
+    CLOUD_USER_2_UNIVERSAL_IDENTIFIER,
+  relationTargetFieldMetadataUniversalIdentifier: PERSON_ON_CLOUD_USER_2_ID,
+  universalSettings: {
+    relationType: RelationType.ONE_TO_MANY,
+  },
+});
@@ -0,0 +1,83 @@
+// Field metadata identifiers for cloudWorkspace2 object
+// These constants are used by both the object definition and views
+
+export const CLOUD_WORKSPACE_2_CUSTOM_DOMAIN_FIELD_ID =
+  'c30799d5-adc0-49be-82a1-6d41b5aa9e82';
+export const CLOUD_WORKSPACE_2_WORKSPACE_BUSINESS_DOMAIN_FIELD_ID =
+  'bfa2f91d-1c6c-48de-bb11-ac2a1e2545a9';
+export const CLOUD_WORKSPACE_2_COMPANY_LINKEDIN_FIELD_ID =
+  'f9f2ef3a-8235-4d21-9a45-d29cc2124456';
+export const CLOUD_WORKSPACE_2_DATA_LAST_UPDATED_AT_FIELD_ID =
+  'fbeaab89-77e0-4e13-97ed-caeb757a38c7';
+export const CLOUD_WORKSPACE_2_LAST_PAGE_VIEW_DATE_FIELD_ID =
+  '7d3d4ba3-5af2-4248-afc7-7f4ce7c82805';
+export const CLOUD_WORKSPACE_2_TOTAL_EVER_ACTIVE_WORKSPACE_USERS_FIELD_ID =
+  '56e99339-dcc4-4950-ae64-1b6ae326af2c';
+export const CLOUD_WORKSPACE_2_ACTIVE_USERS_L30D_FIELD_ID =
+  'e9c703e6-9ffc-497d-9755-018724ac8d66';
+export const CLOUD_WORKSPACE_2_ACTIVE_USERS_L7D_FIELD_ID =
+  '81d8f622-2366-481f-b0e8-b14fb7efa4d5';
+export const CLOUD_WORKSPACE_2_ACTIVE_USERS_L24H_FIELD_ID =
+  '3e53d606-1afa-4d49-be62-52f4bb1cb49e';
+export const CLOUD_WORKSPACE_2_WORKSPACE_TENURE_FIELD_ID =
+  '3fdd272c-73dd-432e-99c7-782f237a7cd8';
+export const CLOUD_WORKSPACE_2_PAGE_VIEWS_L30D_FIELD_ID =
+  '1931f3cd-a984-41e3-b8f5-510f67b508e6';
+export const CLOUD_WORKSPACE_2_PAGE_VIEWS_L7D_FIELD_ID =
+  '1f6a0ef6-3faf-4157-88a7-f624b7655c6b';
+export const CLOUD_WORKSPACE_2_PAGE_VIEWS_L24H_FIELD_ID =
+  'ab0f46aa-9fef-40c6-a229-6ed4e05867d4';
+export const CLOUD_WORKSPACE_2_TOTAL_WORKSPACE_USERS_FIELD_ID =
+  '38095859-2efb-4f40-86a1-aa883fd88e3d';
+export const CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_L30D_FIELD_ID =
+  '4ebd8329-a18c-4606-9ee0-f32fb1c4aa6f';
+export const CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_TOTAL_FIELD_ID =
+  '754f137f-b759-47da-8b57-7de71ad34d37';
+export const CLOUD_WORKSPACE_2_ALEXA_RANK_FIELD_ID =
+  '1627e6b8-e87a-4048-b954-8d2fe09b67c8';
+export const CLOUD_WORKSPACE_2_EMPLOYEES_FIELD_ID =
+  '1d8bb210-b50d-4b38-a611-d78ba865cbae';
+export const CLOUD_WORKSPACE_2_IS_ACTIVE_L7D_FIELD_ID =
+  '42879662-d4fc-4806-bcfb-fdb586827491';
+export const CLOUD_WORKSPACE_2_IS_ACTIVE_L24H_FIELD_ID =
+  '44b2c12f-aedd-459a-848a-ade9fc4620b7';
+export const CLOUD_WORKSPACE_2_IS_ACTIVE_L30D_FIELD_ID =
+  'cac2d3e0-c2ee-4e22-bd96-4fa051a36f73';
+export const CLOUD_WORKSPACE_2_IS_ENRICHED_FIELD_ID =
+  '45cbddfa-54cc-4d94-88d2-db7a7a550414';
+export const CLOUD_WORKSPACE_2_INDUSTRY_FIELD_ID =
+  'a6686308-dfcf-4abb-be0f-e8f48cc579d9';
+export const CLOUD_WORKSPACE_2_COMPANY_FOUNDED_YEAR_FIELD_ID =
+  '0432af7e-7575-486e-a022-f4a625a8ac14';
+export const CLOUD_WORKSPACE_2_DESCRIPTION_FIELD_ID =
+  '40854f41-4175-4b14-9567-c6bfb3f5d441';
+export const CLOUD_WORKSPACE_2_LATEST_FUNDING_STAGE_FIELD_ID =
+  '44aba339-be2e-4364-a894-cf730081c8a6';
+export const CLOUD_WORKSPACE_2_COMPANY_NAME_FIELD_ID =
+  'f11ddfc2-3356-453a-a6e1-494b6c6b12f6';
+export const CLOUD_WORKSPACE_2_SUB_DOMAIN_FIELD_ID =
+  '8fb18f52-44e9-4288-87c1-9650222efb05';
+export const CLOUD_WORKSPACE_2_ANNUAL_REVENUE_FIELD_ID =
+  '8f5dfc54-213b-43b2-a502-631f0f3240d1';
+export const CLOUD_WORKSPACE_2_MRR_FIELD_ID =
+  '67125b6c-ff41-459f-8153-a338ed11c4f0';
+export const CLOUD_WORKSPACE_2_POTENTIAL_ARR_FIELD_ID =
+  '0c38b297-0e9d-47cc-8f8f-a0e5402413ce';
+export const CLOUD_WORKSPACE_2_ARR_FIELD_ID =
+  'f932f94b-c48b-4ef3-9eea-0c8dad370d89';
+export const CLOUD_WORKSPACE_2_TOTAL_FUNDING_FIELD_ID =
+  'ae5da0c9-e9ac-401b-ad48-c37a31c6ecd1';
+export const CLOUD_WORKSPACE_2_ACTIVATION_STATUS_FIELD_ID =
+  'ef44daa9-d272-4680-a19c-caf2bac32b70';
+export const CLOUD_WORKSPACE_2_SUBSCRIPTION_STATUS_FIELD_ID =
+  'a88e8cab-333f-44a3-980e-f2cc22871aee';
+export const CLOUD_WORKSPACE_2_PAYMENT_FREQUENCY_FIELD_ID =
+  'fccc73da-2b6e-434b-921b-e3bcbab1c56c';
+export const CLOUD_WORKSPACE_2_NEXT_RENEWAL_DATE_FIELD_ID =
+  '488b38b4-971e-4c33-b60d-7e7934911579';
+export const CLOUD_WORKSPACE_2_CREATOR_EMAIL_FIELD_ID =
+  '3815b992-a919-4c52-8629-b4b5f89a6060';
+export const CLOUD_WORKSPACE_2_TAGS_FIELD_ID =
+  '0f41485f-4868-4bd6-8d76-709a6b7a54e3';
+export const CLOUD_WORKSPACE_2_UPDATED_BY_FIELD_ID =
+  '252cdff1-facb-4f66-8608-6138a585d099';
@@ -0,0 +1,25 @@
+import { defineField, FieldType, OnDeleteAction, RelationType } from 'twenty-sdk';
+
+import {
+    CLOUD_USER_WORKSPACES_ON_CLOUD_WORKSPACE_ID,
+    CLOUD_WORKSPACE_ON_CLOUD_USER_WORKSPACE_ID,
+} from 'src/fields/cloud-user-workspaces-on-cloud-workspace.field';
+import { CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-workspace-2';
+import { CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-workspace-2';
+
+export default defineField({
+  universalIdentifier: CLOUD_WORKSPACE_ON_CLOUD_USER_WORKSPACE_ID,
+  objectUniversalIdentifier: CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  type: FieldType.RELATION,
+  name: 'cloudWorkspace2',
+  label: 'Cloud Workspace 2',
+  relationTargetObjectMetadataUniversalIdentifier:
+    CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  relationTargetFieldMetadataUniversalIdentifier:
+    CLOUD_USER_WORKSPACES_ON_CLOUD_WORKSPACE_ID,
+  universalSettings: {
+    relationType: RelationType.MANY_TO_ONE,
+    onDelete: OnDeleteAction.CASCADE,
+    joinColumnName: 'cloudWorkspace2Id',
+  },
+});
@@ -0,0 +1,29 @@
+import {
+    defineField,
+    FieldType,
+    OnDeleteAction,
+    RelationType,
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,
+} from 'twenty-sdk';
+
+import {
+    CLOUD_USERS_2_ON_PERSON_ID,
+    PERSON_ON_CLOUD_USER_2_ID,
+} from 'src/fields/cloud-users-2-on-person.field';
+import { CLOUD_USER_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-2';
+
+export default defineField({
+  universalIdentifier: PERSON_ON_CLOUD_USER_2_ID,
+  objectUniversalIdentifier: CLOUD_USER_2_UNIVERSAL_IDENTIFIER,
+  type: FieldType.RELATION,
+  name: 'person',
+  label: 'Person',
+  relationTargetObjectMetadataUniversalIdentifier:
+    STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,
+  relationTargetFieldMetadataUniversalIdentifier: CLOUD_USERS_2_ON_PERSON_ID,
+  universalSettings: {
+    relationType: RelationType.MANY_TO_ONE,
+    onDelete: OnDeleteAction.SET_NULL,
+    joinColumnName: 'personId',
+  },
+});
@@ -0,0 +1,49 @@
+import { defineLogicFunction } from 'twenty-sdk';
+
+import { syncCloudUserWorkspaces } from 'src/logic-functions/sync-product-data/sync-cloud-user-workspaces';
+import { syncCloudUsers } from 'src/logic-functions/sync-product-data/sync-cloud-users';
+import { syncCloudWorkspaces } from 'src/logic-functions/sync-product-data/sync-cloud-workspaces';
+
+const handler = async (): Promise<{ message: string }> => {
+  try {
+    console.log('Starting product data sync');
+
+    const cloudUsersResult = await syncCloudUsers();
+
+    console.log(
+      `Cloud users sync complete: ${cloudUsersResult.syncedCount} users`,
+    );
+
+    const cloudWorkspacesResult = await syncCloudWorkspaces();
+
+    console.log(
+      `Cloud workspaces sync complete: ${cloudWorkspacesResult.syncedCount} workspaces`,
+    );
+
+    const cloudUserWorkspacesResult = await syncCloudUserWorkspaces();
+
+    console.log(
+      `Cloud user workspaces sync complete: ${cloudUserWorkspacesResult.syncedCount} user workspaces`,
+    );
+
+    return {
+      message: `Product data sync complete — ${cloudUsersResult.syncedCount} users, ${cloudWorkspacesResult.syncedCount} workspaces, ${cloudUserWorkspacesResult.syncedCount} user workspaces`,
+    };
+  } catch (err) {
+    console.log(err);
+
+    throw err;
+  }
+};
+
+export default defineLogicFunction({
+  universalIdentifier: '3897e059-715e-4a4b-b165-c44f17d2e30a',
+  name: 'sync-product-data',
+  description:
+    'Syncs cloud users, cloud workspaces, and cloud user workspaces from ClickHouse',
+  timeoutSeconds: 120,
+  handler,
+  cronTriggerSettings: {
+    pattern: '*/10 * * * *',
+  },
+});
@@ -0,0 +1,93 @@
+import { z } from 'zod';
+
+import { getApplicationConfig } from 'src/shared/application-config';
+import { fetchFromClickHouse } from 'src/shared/clickhouse-client';
+import { twentyClient } from 'src/shared/twenty-client';
+
+const clickHouseUserWorkspaceSchema = z.object({
+  id: z.string(),
+  workspaceId: z.string(),
+  userId: z.string(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  deletedAt: z.string(),
+  is_active_membership: z.coerce.boolean(),
+});
+
+type ClickHouseUserWorkspace = z.infer<typeof clickHouseUserWorkspaceSchema>;
+
+const fetchUserWorkspacesFromClickHouse = async (): Promise<
+  ClickHouseUserWorkspace[]
+> => {
+  const { clickHouseDatabase } = getApplicationConfig();
+
+  // const nowDate = 'now()'
+  const nowDate = "'2026-02-04 14:28:52.000'";
+
+  const query = `
+    SELECT
+      *
+    FROM (
+      SELECT
+        *,
+        row_number() OVER (PARTITION BY id ORDER BY updatedAt DESC) AS rn
+      FROM
+        ${clickHouseDatabase}.user_workspace
+      WHERE
+        updatedAt >= ${nowDate} - INTERVAL 500 MINUTE
+          AND
+        updatedAt <= ${nowDate}
+    )
+    WHERE
+      rn = 1
+    FORMAT
+      JSONEachRow;
+  `;
+
+  return fetchFromClickHouse(query, clickHouseUserWorkspaceSchema);
+};
+
+const buildCloudUserWorkspaceInput = (
+  userWorkspace: ClickHouseUserWorkspace,
+) => ({
+  id: userWorkspace.id,
+  twentyUserIdentifier: userWorkspace.userId,
+  twentyWorkspaceIdentifier: userWorkspace.workspaceId,
+  idOfTheUserWorkspace: userWorkspace.id,
+  cloudUser2Id: userWorkspace.userId,
+  cloudWorkspace2Id: userWorkspace.workspaceId,
+});
+
+export const syncCloudUserWorkspaces = async (): Promise<{
+  syncedCount: number;
+}> => {
+  const userWorkspaces = await fetchUserWorkspacesFromClickHouse();
+
+  console.log(
+    `Fetched ${userWorkspaces.length} user workspaces from ClickHouse`,
+  );
+
+  if (userWorkspaces.length === 0) {
+    return { syncedCount: 0 };
+  }
+
+  const cloudUserWorkspaceInputs = userWorkspaces.map(
+    buildCloudUserWorkspaceInput,
+  );
+
+  console.log(
+    `Batch-upserting ${cloudUserWorkspaceInputs.length} cloud user workspaces`,
+  );
+
+  await twentyClient.mutation({
+    createCloudUserWorkspaces2: {
+      __args: {
+        data: cloudUserWorkspaceInputs,
+        upsert: true,
+      },
+      __scalar: true,
+    },
+  });
+
+  return { syncedCount: userWorkspaces.length };
+};
@@ -0,0 +1,268 @@
+import { enumCloudUser2ActivityStatusEnum } from 'twenty-sdk/generated';
+import { z } from 'zod';
+
+import { getApplicationConfig } from 'src/shared/application-config';
+import { fetchFromClickHouse } from 'src/shared/clickhouse-client';
+import { clickHouseDateToIso } from 'src/shared/clickhouse-date-to-iso';
+import { twentyClient } from 'src/shared/twenty-client';
+
+const clickHouseUserSchema = z.object({
+  userId: z.uuid(),
+  firstName: z.string(),
+  lastName: z.string(),
+  email: z.email(),
+  fullName: z.string(),
+  isEmailVerified: z.boolean(),
+  disabled: z.boolean(),
+  canImpersonate: z.boolean(),
+  canAccessFullAdminPanel: z.boolean(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  deletedAt: z.string(),
+  locale: z.string(),
+  createdDate: z.string(),
+  workspaceCount: z.coerce.number(),
+  workspaceIds: z.string(),
+  workspaceDomains: z.string(),
+  firstActivityDate: z.string(),
+  lastActivityDate: z.string(),
+  lastWorkspaceId: z.string(),
+  totalPageviews: z.coerce.number(),
+  pageviewsLast30d: z.coerce.number(),
+  pageviewsLast7d: z.coerce.number(),
+  pageviewsLast24h: z.coerce.number(),
+  userAgeDays: z.coerce.number(),
+  daysSinceLastActivity: z.coerce.number(),
+  isActiveLast30d: z.boolean(),
+  isActiveLast7d: z.boolean(),
+  isActiveLast24h: z.boolean(),
+  activityStatus: z
+    .string()
+    .transform((val) => val.toUpperCase())
+    .pipe(z.enum(enumCloudUser2ActivityStatusEnum)),
+  avgDailyPageviewsLast30d: z.coerce.number(),
+  isTwenty: z.coerce.boolean(),
+  maxWorkspaceMembers: z.coerce.number(),
+  inTrial: z.boolean(),
+});
+
+type ClickHouseUser = z.infer<typeof clickHouseUserSchema>;
+
+const fetchUsersFromClickHouse = async (): Promise<ClickHouseUser[]> => {
+  const { clickHouseDatabase } = getApplicationConfig();
+
+  // const nowDate = 'now()'
+  const nowDate = "'2026-02-04 14:28:52.000'";
+
+  const query = `
+    SELECT
+      *
+    FROM
+      ${clickHouseDatabase}.user
+    WHERE
+      lastActivityDate >= ${nowDate} - INTERVAL 500 MINUTE
+        AND
+      lastActivityDate <= ${nowDate}
+    FORMAT
+      JSONEachRow;
+  `;
+
+  return fetchFromClickHouse(query, clickHouseUserSchema);
+};
+
+const fetchAllPeopleFromTwentyByEmail = async (emails: string[]) => {
+  if (emails.length === 0) {
+    return [];
+  }
+
+  const allPeople = await twentyClient.query({
+    people: {
+      edges: {
+        node: {
+          id: true,
+          emails: {
+            primaryEmail: true,
+          },
+        },
+      },
+      __args: {
+        filter: {
+          emails: {
+            primaryEmail: {
+              in: emails,
+            },
+          },
+        },
+      },
+    },
+  });
+
+  return allPeople.people?.edges.map((edge) => edge.node) ?? [];
+};
+
+const buildCloudUserInput = ({
+  user,
+  personId,
+}: {
+  user: ClickHouseUser;
+  personId: string;
+}) => ({
+  id: user.userId,
+  name: user.fullName,
+  email: {
+    primaryEmail: user.email,
+  },
+  personId,
+  fullName: {
+    lastName: user.lastName,
+    firstName: user.firstName,
+  },
+  isTwenty: user.isTwenty,
+  userTenure: user.userAgeDays,
+  isActiveL7d: user.isActiveLast7d,
+  isActiveL24h: user.isActiveLast24h,
+  isActiveL30d: user.isActiveLast30d,
+  pageViewsL7d: user.pageviewsLast7d,
+  pageViewsL24h: user.pageviewsLast24h,
+  pageViewsL30d: user.pageviewsLast30d,
+  activityStatus: user.activityStatus,
+  workspaceCount: user.workspaceCount,
+  lastActivityDate: clickHouseDateToIso(user.lastActivityDate),
+  dataLastUpdatedAt: new Date().toISOString(),
+  avgDailyPageviewsLast30d: user.avgDailyPageviewsLast30d,
+  daysSinceLastActivity: user.daysSinceLastActivity,
+});
+
+export const syncCloudUsers = async (): Promise<{
+  syncedCount: number;
+}> => {
+  const users = await fetchUsersFromClickHouse();
+
+  console.log('Fetched users from ClickHouse', users);
+
+  const emails = users.map((user) => user.email);
+
+  console.log('Fetching people from Twenty with emails', emails);
+
+  const people = await fetchAllPeopleFromTwentyByEmail(emails);
+
+  console.log('Fetched people from Twenty', people);
+
+  // Build a map of email -> personId from existing people
+  const emailToPersonId = new Map<string, string>();
+
+  for (const person of people) {
+    if (person.emails?.primaryEmail !== undefined) {
+      emailToPersonId.set(person.emails.primaryEmail.toLowerCase(), person.id);
+    }
+  }
+
+  // Partition users into those with/without an existing person
+  const usersWithoutPerson = users.filter(
+    (user) => !emailToPersonId.has(user.email.toLowerCase()),
+  );
+
+  // Step 1: Batch-create missing people
+  const newlyCreatedPersonIds: string[] = [];
+
+  if (usersWithoutPerson.length > 0) {
+    console.log(`Batch-creating ${usersWithoutPerson.length} people records`);
+
+    const createPeopleResult = await twentyClient.mutation({
+      createPeople: {
+        __args: {
+          data: usersWithoutPerson.map((user) => ({
+            name: {
+              firstName: user.firstName,
+              lastName: user.lastName,
+            },
+            emails: {
+              primaryEmail: user.email,
+            },
+          })),
+        },
+        id: true,
+        emails: {
+          primaryEmail: true,
+        },
+      },
+    });
+
+    const createdPeople = createPeopleResult.createPeople ?? [];
+
+    for (const person of createdPeople) {
+      if (
+        person.emails?.primaryEmail === undefined ||
+        person.id === undefined
+      ) {
+        continue;
+      }
+
+      newlyCreatedPersonIds.push(person.id);
+      emailToPersonId.set(person.emails.primaryEmail.toLowerCase(), person.id);
+    }
+  }
+
+  // Step 2: Batch-upsert all cloud users, with rollback on failure
+  const cloudUserInputs = users.map((user) => {
+    const personId = emailToPersonId.get(user.email.toLowerCase());
+
+    if (personId === undefined) {
+      throw new Error(
+        `No personId found for user ${user.email} — this should not happen`,
+      );
+    }
+
+    return buildCloudUserInput({ user, personId });
+  });
+
+  try {
+    console.log(`Batch-upserting ${cloudUserInputs.length} cloud users`);
+
+    await twentyClient.mutation({
+      createCloudUsers2: {
+        __args: {
+          data: cloudUserInputs,
+          upsert: true,
+        },
+        __scalar: true,
+      },
+    });
+  } catch (cloudUserError) {
+    console.log(
+      'Cloud user upsert failed, rolling back newly created people',
+      cloudUserError,
+    );
+
+    // Rollback: hard-delete people that were created in step 1
+    if (newlyCreatedPersonIds.length > 0) {
+      try {
+        await twentyClient.mutation({
+          destroyPeople: {
+            __args: {
+              filter: {
+                id: {
+                  in: newlyCreatedPersonIds,
+                },
+              },
+            },
+            id: true,
+          },
+        });
+
+        console.log(
+          `Rolled back ${newlyCreatedPersonIds.length} newly created people`,
+        );
+      } catch (rollbackError) {
+        console.log(
+          'Rollback of newly created people also failed',
+          rollbackError,
+        );
+      }
+    }
+
+    throw cloudUserError;
+  }
+
+  return { syncedCount: users.length };
+};
@@ -0,0 +1,201 @@
+import {
+  enumCloudWorkspace2ActivationStatusEnum,
+  enumCloudWorkspace2PaymentFrequencyEnum,
+  enumCloudWorkspace2SubscriptionStatusEnum,
+} from 'twenty-sdk/generated';
+import { z } from 'zod';
+
+import { getApplicationConfig } from 'src/shared/application-config';
+import { fetchFromClickHouse } from 'src/shared/clickhouse-client';
+import { clickHouseDateToIso } from 'src/shared/clickhouse-date-to-iso';
+import { twentyClient } from 'src/shared/twenty-client';
+
+const clickHouseWorkspaceSchema = z.object({
+  workspaceId: z.string(),
+  workspaceName: z.string(),
+  subdomain: z.string(),
+  customDomain: z.string(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  deletedAt: z.string(),
+  activationStatus: z
+    .string()
+    .transform((val) => {
+      const upper = val.toUpperCase();
+      if (upper === '') return 'EMPTY';
+      const valid: string[] = Object.values(
+        enumCloudWorkspace2ActivationStatusEnum,
+      );
+      return valid.includes(upper) ? upper : 'EMPTY';
+    })
+    .pipe(z.enum(enumCloudWorkspace2ActivationStatusEnum)),
+  createdDate: z.string(),
+  lastPageviewDate: z.string(),
+  pageviewsLast30d: z.coerce.number(),
+  pageviewsLast7d: z.coerce.number(),
+  pageviewsLast24h: z.coerce.number(),
+  totalEverActiveUsers: z.coerce.number(),
+  totalWorkspaceUsers: z.coerce.number(),
+  activeUsersLast30d: z.coerce.number(),
+  activeUsersLast7d: z.coerce.number(),
+  activeUsersLast24h: z.coerce.number(),
+  isActiveLast30d: z.coerce.boolean(),
+  isActiveLast7d: z.coerce.boolean(),
+  isActiveLast24h: z.coerce.boolean(),
+  activeUserRatioLast30d: z.coerce.number(),
+  activeUserRatioLast7d: z.coerce.number(),
+  workspaceAgeDays: z.coerce.number(),
+  totalEvents: z.coerce.number(),
+  eventsLast30d: z.coerce.number(),
+  eventsPerUser: z.coerce.number(),
+  subscription_status: z
+    .string()
+    .transform((val) => {
+      const upper = val.toUpperCase();
+      if (upper === '') return 'EMPTY';
+      const valid: string[] = Object.values(
+        enumCloudWorkspace2SubscriptionStatusEnum,
+      );
+      return valid.includes(upper) ? upper : 'OTHER';
+    })
+    .pipe(z.enum(enumCloudWorkspace2SubscriptionStatusEnum)),
+  payment_frequency: z
+    .string()
+    .transform((val) => {
+      const upper = val.toUpperCase();
+      if (upper === '') return 'EMPTY';
+      const valid: string[] = Object.values(
+        enumCloudWorkspace2PaymentFrequencyEnum,
+      );
+      return valid.includes(upper) ? upper : 'OTHER';
+    })
+    .pipe(z.enum(enumCloudWorkspace2PaymentFrequencyEnum)),
+  trial_status: z.string(),
+  mrr: z.coerce.number(),
+  potential_arr: z.coerce.number(),
+  arr: z.coerce.number().nullable(),
+  next_renewal_date: z.string(),
+  workspace_domain: z.string(),
+  domain_source: z.string(),
+  creatorUserId: z.string(),
+  creatorEmail: z.string(),
+  creator_domain_type: z.string(),
+  primary_business_domain: z.string(),
+  business_domain_user_count: z.coerce.number(),
+  isTwenty: z.coerce.boolean(),
+});
+
+type ClickHouseWorkspace = z.infer<typeof clickHouseWorkspaceSchema>;
+
+const fetchWorkspacesFromClickHouse =
+  async (): Promise<ClickHouseWorkspace[]> => {
+    const { clickHouseDatabase } = getApplicationConfig();
+
+    // const nowDate = 'now()'
+    const nowDate = "'2026-02-04 14:28:52.000'";
+
+    const query = `
+    SELECT
+      *
+    FROM (
+      SELECT
+        *,
+        row_number() OVER (PARTITION BY workspaceId ORDER BY updatedAt DESC) AS rn
+      FROM
+        ${clickHouseDatabase}.workspace
+      WHERE
+        updatedAt >= ${nowDate} - INTERVAL 500 MINUTE
+          AND
+        updatedAt <= ${nowDate}
+    )
+    WHERE
+      rn = 1
+    FORMAT
+      JSONEachRow;
+  `;
+
+    return fetchFromClickHouse(query, clickHouseWorkspaceSchema);
+  };
+
+// Convert a dollar amount to micros (1 USD = 1_000_000 micros).
+const dollarsToAmountMicros = (dollars: number) =>
+  Math.round(dollars * 1_000_000);
+
+const buildCloudWorkspaceInput = (workspace: ClickHouseWorkspace) => ({
+  id: workspace.workspaceId,
+  name: workspace.workspaceName,
+  subDomain: workspace.subdomain,
+  customDomain: {
+    primaryLinkUrl: workspace.customDomain,
+    primaryLinkLabel: '',
+  },
+  activationStatus: workspace.activationStatus,
+  subscriptionStatus: workspace.subscription_status,
+  paymentFrequency: workspace.payment_frequency,
+  lastPageViewDate: workspace.lastPageviewDate,
+  pageViewsL30D: workspace.pageviewsLast30d,
+  pageViewsL7D: workspace.pageviewsLast7d,
+  pageViewsL24H: workspace.pageviewsLast24h,
+  totalEverActiveWorkspaceUsers: workspace.totalEverActiveUsers,
+  totalWorkspaceUsers: workspace.totalWorkspaceUsers,
+  activeUsersL30D: workspace.activeUsersLast30d,
+  activeUsersL7D: workspace.activeUsersLast7d,
+  activeUsersL24H: workspace.activeUsersLast24h,
+  isActiveL30D: workspace.isActiveLast30d,
+  isActiveL7D: workspace.isActiveLast7d,
+  isActiveL24H: workspace.isActiveLast24h,
+  workspaceTenure: workspace.workspaceAgeDays,
+  numberOfEventsTotal: workspace.totalEvents,
+  numberOfEventsL30D: workspace.eventsLast30d,
+  mrr: {
+    amountMicros: dollarsToAmountMicros(workspace.mrr),
+    currencyCode: 'USD',
+  },
+  potentialArr: {
+    amountMicros: dollarsToAmountMicros(workspace.potential_arr),
+    currencyCode: 'USD',
+  },
+  arr: {
+    amountMicros: dollarsToAmountMicros(workspace.arr ?? 0),
+    currencyCode: 'USD',
+  },
+  nextRenewalDate: clickHouseDateToIso(workspace.next_renewal_date),
+  creatorEmail: {
+    primaryEmail: workspace.creatorEmail,
+  },
+  workspaceBusinessDomain: {
+    primaryLinkUrl: workspace.primary_business_domain,
+    primaryLinkLabel: '',
+  },
+  dataLastUpdatedAt: new Date().toISOString(),
+});
+
+export const syncCloudWorkspaces = async (): Promise<{
+  syncedCount: number;
+}> => {
+  const workspaces = await fetchWorkspacesFromClickHouse();
+
+  console.log(`Fetched ${workspaces.length} workspaces from ClickHouse`);
+
+  if (workspaces.length === 0) {
+    return { syncedCount: 0 };
+  }
+
+  const cloudWorkspaceInputs = workspaces.map(buildCloudWorkspaceInput);
+
+  console.log(
+    `Batch-upserting ${cloudWorkspaceInputs.length} cloud workspaces`,
+  );
+
+  await twentyClient.mutation({
+    createCloudWorkspaces2: {
+      __args: {
+        data: cloudWorkspaceInputs,
+        upsert: true,
+      },
+      __scalar: true,
+    },
+  });
+
+  return { syncedCount: workspaces.length };
+};
@@ -0,0 +1,11 @@
+import { defineNavigationMenuItem } from 'twenty-sdk';
+
+import { ALL_CLOUD_USER_2_VIEW_ID } from 'src/views/all-cloud-user-2';
+
+export default defineNavigationMenuItem({
+  universalIdentifier: 'ac6df084-0f0f-404a-b3d1-b084cb624d76',
+  name: 'cloud-user-2',
+  icon: 'IconList',
+  position: 0,
+  viewUniversalIdentifier: ALL_CLOUD_USER_2_VIEW_ID,
+});
@@ -0,0 +1,11 @@
+import { defineNavigationMenuItem } from 'twenty-sdk';
+
+import { ALL_CLOUD_USER_WORKSPACE_2_VIEW_ID } from 'src/views/all-cloud-user-workspace-2';
+
+export default defineNavigationMenuItem({
+  universalIdentifier: 'e29251f0-78ad-493f-8f99-ec54ab0b5378',
+  name: 'cloud-user-workspace-2',
+  icon: 'IconList',
+  position: 0,
+  viewUniversalIdentifier: ALL_CLOUD_USER_WORKSPACE_2_VIEW_ID,
+});
@@ -0,0 +1,11 @@
+import { defineNavigationMenuItem } from 'twenty-sdk';
+
+import { ALL_CLOUD_WORKSPACE_2_VIEW_ID } from 'src/views/all-cloud-workspace-2';
+
+export default defineNavigationMenuItem({
+  universalIdentifier: '0ba6315e-0d79-47a5-8c05-29dec621a647',
+  name: 'cloud-workspace-2',
+  icon: 'IconList',
+  position: 0,
+  viewUniversalIdentifier: ALL_CLOUD_WORKSPACE_2_VIEW_ID,
+});
@@ -0,0 +1,171 @@
+import { defineObject, FieldType } from 'twenty-sdk';
+
+import {
+  CLOUD_USER_2_ACTIVITY_STATUS_FIELD_ID,
+  CLOUD_USER_2_AVG_DAILY_PAGEVIEWS_LAST_30D_FIELD_ID,
+  CLOUD_USER_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+  CLOUD_USER_2_DAYS_SINCE_LAST_ACTIVITY_FIELD_ID,
+  CLOUD_USER_2_EMAIL_FIELD_ID,
+  CLOUD_USER_2_FULL_NAME_FIELD_ID,
+  CLOUD_USER_2_IS_ACTIVE_L24H_FIELD_ID,
+  CLOUD_USER_2_IS_ACTIVE_L30D_FIELD_ID,
+  CLOUD_USER_2_IS_ACTIVE_L7D_FIELD_ID,
+  CLOUD_USER_2_IS_TWENTY_FIELD_ID,
+  CLOUD_USER_2_LAST_ACTIVITY_DATE_FIELD_ID,
+  CLOUD_USER_2_PAGE_VIEWS_L24H_FIELD_ID,
+  CLOUD_USER_2_PAGE_VIEWS_L30D_FIELD_ID,
+  CLOUD_USER_2_PAGE_VIEWS_L7D_FIELD_ID,
+  CLOUD_USER_2_UPDATED_BY_FIELD_ID,
+  CLOUD_USER_2_USER_TENURE_FIELD_ID,
+  CLOUD_USER_2_WORKSPACE_COUNT_FIELD_ID,
+} from 'src/fields/cloud-user-2-field-ids';
+
+export const CLOUD_USER_2_UNIVERSAL_IDENTIFIER =
+  'da264c72-df22-49b3-98e3-21cf6013e671';
+
+export default defineObject({
+  universalIdentifier: CLOUD_USER_2_UNIVERSAL_IDENTIFIER,
+  nameSingular: 'cloudUser2',
+  namePlural: 'cloudUsers2',
+  labelSingular: 'Cloud user 2',
+  labelPlural: 'Cloud users 2',
+  icon: 'IconBox',
+  fields: [
+    {
+      universalIdentifier: CLOUD_USER_2_ACTIVITY_STATUS_FIELD_ID,
+      type: FieldType.SELECT,
+      name: 'activityStatus',
+      label: 'Activity Status',
+      options: [
+        {
+          id: '141d21f3-71b0-4b37-a3d2-5d91d43d0493',
+          value: 'ACTIVE',
+          label: 'Active',
+          position: 0,
+          color: 'green',
+        },
+        {
+          id: 'adb1d290-750f-468e-99ee-ed892bcb8974',
+          value: 'RECENT',
+          label: 'Recent',
+          position: 1,
+          color: 'blue',
+        },
+        {
+          id: '96f24b75-a671-4727-a78f-5a72419370ea',
+          value: 'DORMANT',
+          label: 'Dormant',
+          position: 2,
+          color: 'orange',
+        },
+        {
+          id: '88ddbef9-16a8-4643-9726-5b271cd477fa',
+          value: 'INACTIVE',
+          label: 'Inactive',
+          position: 3,
+          color: 'blue',
+        },
+      ],
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_AVG_DAILY_PAGEVIEWS_LAST_30D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'avgDailyPageviewsLast30d',
+      label: 'Avg Daily Page Views',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+      type: FieldType.DATE_TIME,
+      name: 'dataLastUpdatedAt',
+      label: 'Data last updated at',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_DAYS_SINCE_LAST_ACTIVITY_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'daysSinceLastActivity',
+      label: 'Days Since Last Activity',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_EMAIL_FIELD_ID,
+      type: FieldType.EMAILS,
+      name: 'email',
+      label: 'Email',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_FULL_NAME_FIELD_ID,
+      type: FieldType.FULL_NAME,
+      name: 'fullName',
+      label: 'Full Name',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_IS_ACTIVE_L24H_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isActiveL24h',
+      label: 'Is Active L24H',
+      defaultValue: true
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_IS_ACTIVE_L30D_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isActiveL30d',
+      label: 'Is Active L30D',
+      defaultValue: false
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_IS_ACTIVE_L7D_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isActiveL7d',
+      label: 'Is Active L7D',
+      defaultValue: true
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_IS_TWENTY_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isTwenty',
+      label: 'Is Twenty',
+      defaultValue: false
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_LAST_ACTIVITY_DATE_FIELD_ID,
+      type: FieldType.DATE_TIME,
+      name: 'lastActivityDate',
+      label: 'Last Activity Date',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_PAGE_VIEWS_L24H_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'pageViewsL24h',
+      label: 'Page Views L24H',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_PAGE_VIEWS_L30D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'pageViewsL30d',
+      label: 'Page Views L30D',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_PAGE_VIEWS_L7D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'pageViewsL7d',
+      label: 'Page Views L7D',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_UPDATED_BY_FIELD_ID,
+      type: FieldType.ACTOR,
+      name: 'updatedBy',
+      label: 'Updated by',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_USER_TENURE_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'userTenure',
+      label: 'User tenure',
+    },
+    {
+      universalIdentifier: CLOUD_USER_2_WORKSPACE_COUNT_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'workspaceCount',
+      label: 'Workspace count',
+    },
+  ],
+});
@@ -0,0 +1,67 @@
+import { defineObject, FieldType } from 'twenty-sdk';
+
+import {
+  CLOUD_USER_WORKSPACE_2_ID_OF_THE_USER_WORKSPACE_FIELD_ID,
+  CLOUD_USER_WORKSPACE_2_TWENTY_USER_IDENTIFIER_FIELD_ID,
+  CLOUD_USER_WORKSPACE_2_TWENTY_WORKSPACE_IDENTIFIER_FIELD_ID,
+  CLOUD_USER_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+} from 'src/fields/cloud-user-workspace-2-field-ids';
+
+export const CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER =
+  '14d6e1f4-c513-4766-9210-bc5dc8294e51';
+
+export default defineObject({
+  universalIdentifier: CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  nameSingular: 'cloudUserWorkspace2',
+  namePlural: 'cloudUserWorkspaces2',
+  labelSingular: 'Cloud user workspace 2',
+  labelPlural: 'Cloud user workspaces 2',
+  icon: 'IconBox',
+  fields: [
+    {
+      universalIdentifier: CLOUD_USER_WORKSPACE_2_TWENTY_USER_IDENTIFIER_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'twentyUserIdentifier',
+      label: 'Twenty User Identifier',
+      icon: 'IconMan',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        displayedMaxRows: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_USER_WORKSPACE_2_TWENTY_WORKSPACE_IDENTIFIER_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'twentyWorkspaceIdentifier',
+      label: 'Twenty Workspace Identifier',
+      icon: 'IconScreenShare',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        displayedMaxRows: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_USER_WORKSPACE_2_ID_OF_THE_USER_WORKSPACE_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'idOfTheUserWorkspace',
+      label: 'Id of the user workspace',
+      icon: 'IconTypography',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        displayedMaxRows: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_USER_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+      type: FieldType.ACTOR,
+      name: 'updatedBy',
+      label: 'Updated by',
+      description: 'The user who last updated the record',
+      icon: 'IconUserCircle',
+      isNullable: true,
+    },
+  ],
+});
@@ -0,0 +1,589 @@
+import { defineObject, FieldType } from 'twenty-sdk';
+
+import {
+  CLOUD_WORKSPACE_2_ACTIVATION_STATUS_FIELD_ID,
+  CLOUD_WORKSPACE_2_ACTIVE_USERS_L24H_FIELD_ID,
+  CLOUD_WORKSPACE_2_ACTIVE_USERS_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_ACTIVE_USERS_L7D_FIELD_ID,
+  CLOUD_WORKSPACE_2_ALEXA_RANK_FIELD_ID,
+  CLOUD_WORKSPACE_2_ANNUAL_REVENUE_FIELD_ID,
+  CLOUD_WORKSPACE_2_ARR_FIELD_ID,
+  CLOUD_WORKSPACE_2_COMPANY_FOUNDED_YEAR_FIELD_ID,
+  CLOUD_WORKSPACE_2_COMPANY_LINKEDIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_COMPANY_NAME_FIELD_ID,
+  CLOUD_WORKSPACE_2_CREATOR_EMAIL_FIELD_ID,
+  CLOUD_WORKSPACE_2_CUSTOM_DOMAIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+  CLOUD_WORKSPACE_2_DESCRIPTION_FIELD_ID,
+  CLOUD_WORKSPACE_2_EMPLOYEES_FIELD_ID,
+  CLOUD_WORKSPACE_2_INDUSTRY_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ACTIVE_L24H_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ACTIVE_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ACTIVE_L7D_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ENRICHED_FIELD_ID,
+  CLOUD_WORKSPACE_2_LAST_PAGE_VIEW_DATE_FIELD_ID,
+  CLOUD_WORKSPACE_2_LATEST_FUNDING_STAGE_FIELD_ID,
+  CLOUD_WORKSPACE_2_MRR_FIELD_ID,
+  CLOUD_WORKSPACE_2_NEXT_RENEWAL_DATE_FIELD_ID,
+  CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_TOTAL_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAGE_VIEWS_L24H_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAGE_VIEWS_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAGE_VIEWS_L7D_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAYMENT_FREQUENCY_FIELD_ID,
+  CLOUD_WORKSPACE_2_POTENTIAL_ARR_FIELD_ID,
+  CLOUD_WORKSPACE_2_SUB_DOMAIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_SUBSCRIPTION_STATUS_FIELD_ID,
+  CLOUD_WORKSPACE_2_TAGS_FIELD_ID,
+  CLOUD_WORKSPACE_2_TOTAL_EVER_ACTIVE_WORKSPACE_USERS_FIELD_ID,
+  CLOUD_WORKSPACE_2_TOTAL_FUNDING_FIELD_ID,
+  CLOUD_WORKSPACE_2_TOTAL_WORKSPACE_USERS_FIELD_ID,
+  CLOUD_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+  CLOUD_WORKSPACE_2_WORKSPACE_BUSINESS_DOMAIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_WORKSPACE_TENURE_FIELD_ID,
+} from 'src/fields/cloud-workspace-2-field-ids';
+
+export const CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER =
+  '77376ed3-19c1-4859-bde5-90f19ad02113';
+
+export default defineObject({
+  universalIdentifier: CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  nameSingular: 'cloudWorkspace2',
+  namePlural: 'cloudWorkspaces2',
+  labelSingular: 'Cloud workspace 2',
+  labelPlural: 'Cloud workspaces 2',
+  icon: 'IconBox',
+  fields: [
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_CUSTOM_DOMAIN_FIELD_ID,
+      type: FieldType.LINKS,
+      name: 'customDomain',
+      label: 'Custom domain',
+      description: 'Custom domain set up by the customer to use their own.',
+      icon: 'IconLink',
+      isNullable: true,
+
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_WORKSPACE_BUSINESS_DOMAIN_FIELD_ID,
+      type: FieldType.LINKS,
+      name: 'workspaceBusinessDomain',
+      label: 'Workspace Business Domain',
+      icon: 'IconLink',
+      isNullable: true,
+
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_COMPANY_LINKEDIN_FIELD_ID,
+      type: FieldType.LINKS,
+      name: 'companyLinkedin',
+      label: 'Company LinkedIn',
+      icon: 'IconBrandLinkedin',
+      isNullable: true,
+
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+      type: FieldType.DATE,
+      name: 'dataLastUpdatedAt',
+      label: 'Data last updated at',
+      description: 'by workflow',
+      icon: 'IconCalendarEvent',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_LAST_PAGE_VIEW_DATE_FIELD_ID,
+      type: FieldType.DATE,
+      name: 'lastPageViewDate',
+      label: 'Last Page View Date',
+      icon: 'IconCalendarEvent',
+      isNullable: true,
+      defaultValue: null,
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_TOTAL_EVER_ACTIVE_WORKSPACE_USERS_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'totalEverActiveWorkspaceUsers',
+      label: 'Total ever active workspace users',
+      icon: 'IconUsers',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ACTIVE_USERS_L30D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'activeUsersL30D',
+      label: 'Active Users L30D',
+      icon: 'IconUsersGroup',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ACTIVE_USERS_L7D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'activeUsersL7D',
+      label: 'Active Users L7D',
+      icon: 'IconUsersGroup',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ACTIVE_USERS_L24H_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'activeUsersL24H',
+      label: 'Active Users L24H',
+      icon: 'IconUsersGroup',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_WORKSPACE_TENURE_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'workspaceTenure',
+      label: 'Workspace tenure',
+      description: 'in days',
+      icon: 'IconCalendarHeart',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_PAGE_VIEWS_L30D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'pageViewsL30D',
+      label: 'Page Views L30D',
+      icon: 'IconClick',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_PAGE_VIEWS_L7D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'pageViewsL7D',
+      label: 'Page Views L7D',
+      icon: 'IconClick',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_PAGE_VIEWS_L24H_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'pageViewsL24H',
+      label: 'Page Views L24H',
+      icon: 'IconClick',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_TOTAL_WORKSPACE_USERS_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'totalWorkspaceUsers',
+      label: 'Total workspace users',
+      icon: 'IconUsers',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_L30D_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'numberOfEventsL30D',
+      label: 'Number of events L30D',
+      icon: 'IconHandClick',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_TOTAL_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'numberOfEventsTotal',
+      label: 'Number of events total',
+      icon: 'IconHandClick',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ALEXA_RANK_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'alexaRank',
+      label: 'Alexa Rank',
+      icon: 'IconNumber9',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_EMPLOYEES_FIELD_ID,
+      type: FieldType.NUMBER,
+      name: 'employees',
+      label: 'Employees',
+      icon: 'IconUsers',
+      isNullable: true,
+      defaultValue: null,
+      universalSettings: {
+        type: 'number',
+        decimals: 0,
+      },
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_IS_ACTIVE_L7D_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isActiveL7D',
+      label: 'Is Active L7D',
+      icon: 'IconActivity',
+      isNullable: true,
+      defaultValue: false,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_IS_ACTIVE_L24H_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isActiveL24H',
+      label: 'Is Active L24H',
+      icon: 'IconActivity',
+      isNullable: true,
+      defaultValue: true,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_IS_ACTIVE_L30D_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isActiveL30D',
+      label: 'Is Active L30D',
+      icon: 'IconActivity',
+      isNullable: true,
+      defaultValue: false,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_IS_ENRICHED_FIELD_ID,
+      type: FieldType.BOOLEAN,
+      name: 'isEnriched',
+      label: 'Is Enriched',
+      icon: 'IconToggleLeft',
+      isNullable: true,
+      defaultValue: false,
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_INDUSTRY_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'industry',
+      label: 'Industry',
+      icon: 'IconWorldLongitude',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_COMPANY_FOUNDED_YEAR_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'companyFoundedYear',
+      label: 'Company Founded Year',
+      icon: 'IconCalendarPlus',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_DESCRIPTION_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'description',
+      label: 'Description',
+      icon: 'IconBaselineDensitySmall',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_LATEST_FUNDING_STAGE_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'latestFundingStage',
+      label: 'Latest Funding Stage',
+      icon: 'IconBellDollar',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_COMPANY_NAME_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'companyName',
+      label: 'Company Name',
+      icon: 'IconTypography',
+      isNullable: true,
+      defaultValue: null,
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_SUB_DOMAIN_FIELD_ID,
+      type: FieldType.TEXT,
+      name: 'subDomain',
+      label: 'Sub domain',
+      description:
+        'This is the subdomain chosen by customers to access their workspace',
+      icon: 'IconLink',
+      isNullable: true,
+      defaultValue: null,
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ANNUAL_REVENUE_FIELD_ID,
+      type: FieldType.CURRENCY,
+      name: 'annualRevenue',
+      label: 'Annual Revenue',
+      icon: 'IconCurrencyDollar',
+      isNullable: true,
+
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_MRR_FIELD_ID,
+      type: FieldType.CURRENCY,
+      name: 'mrr',
+      label: 'MRR',
+      icon: 'IconMoneybag',
+      isNullable: true,
+
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_POTENTIAL_ARR_FIELD_ID,
+      type: FieldType.CURRENCY,
+      name: 'potentialArr',
+      label: 'Potential ARR',
+      icon: 'IconMoneybag',
+      isNullable: true,
+
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ARR_FIELD_ID,
+      type: FieldType.CURRENCY,
+      name: 'arr',
+      label: 'ARR',
+      icon: 'IconMoneybag',
+      isNullable: true,
+
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_TOTAL_FUNDING_FIELD_ID,
+      type: FieldType.CURRENCY,
+      name: 'totalFunding',
+      label: 'Total Funding',
+      icon: 'IconMoneybag',
+      isNullable: true,
+
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_ACTIVATION_STATUS_FIELD_ID,
+      type: FieldType.SELECT,
+      name: 'activationStatus',
+      label: 'Activation Status',
+      icon: 'IconTag',
+      isNullable: true,
+      defaultValue: null,
+      options: [
+        {
+          id: 'c41ee49c-e629-431e-8601-183726f93315',
+          color: 'yellow',
+          label: 'Pending creation',
+          value: 'PENDING_CREATION',
+          position: 0,
+        },
+        {
+          id: 'cb82ad14-5fcb-4ed0-af58-c92f84b45d2b',
+          color: 'gray',
+          label: 'Suspended',
+          value: 'SUSPENDED',
+          position: 1,
+        },
+        {
+          id: 'b1084bc8-0efd-44ce-974c-7fb44c310be5',
+          color: 'green',
+          label: 'Active',
+          value: 'ACTIVE',
+          position: 2,
+        },
+        {
+          id: 'b5b33c8e-eb3f-4758-99c9-d2f39c011b96',
+          color: 'blue',
+          label: 'Ongoing creation',
+          value: 'ONGOING_CREATION',
+          position: 3,
+        },
+        {
+          id: '2ae41a69-c521-4545-9e0b-f1f941ceee83',
+          color: 'purple',
+          label: 'Empty',
+          value: 'EMPTY',
+          position: 4,
+        },
+      ],
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_SUBSCRIPTION_STATUS_FIELD_ID,
+      type: FieldType.SELECT,
+      name: 'subscriptionStatus',
+      label: 'Subscription Status',
+      icon: 'IconTag',
+      isNullable: true,
+      defaultValue: null,
+      options: [
+        {
+          id: 'b5ee9a91-0a15-4cbe-a36e-198f5bae431d',
+          color: 'green',
+          label: 'Active',
+          value: 'ACTIVE',
+          position: 0,
+        },
+        {
+          id: '78837243-38d9-44d4-8b9c-a6c0ca082ba8',
+          color: 'blue',
+          label: 'Trialing',
+          value: 'TRIALING',
+          position: 1,
+        },
+        {
+          id: '6b27ee33-3c30-4694-a607-19264765b11c',
+          color: 'gray',
+          label: 'Canceled',
+          value: 'CANCELED',
+          position: 2,
+        },
+        {
+          id: '05118231-18b6-4589-be23-8f1368c0182f',
+          color: 'yellow',
+          label: 'Other',
+          value: 'OTHER',
+          position: 3,
+        },
+        {
+          id: 'ea83a7ff-4fe0-4c56-88f8-cf0bdf76cb08',
+          color: 'gray',
+          label: 'Empty',
+          value: 'EMPTY',
+          position: 4,
+        },
+      ],
+    },
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_PAYMENT_FREQUENCY_FIELD_ID,
+      type: FieldType.SELECT,
+      name: 'paymentFrequency',
+      label: 'Payment Frequency',
+      icon: 'IconCurrencyDollar',
+      isNullable: true,
+      defaultValue: null,
+      options: [
+        {
+          id: 'fa97d4fb-12bf-4cf4-b252-14b1c657d3b6',
+          color: 'sky',
+          label: 'Month',
+          value: 'MONTH',
+          position: 0,
+        },
+        {
+          id: 'c09c3f1d-31e7-4b29-969a-a4304f04abe0',
+          color: 'purple',
+          label: 'Year',
+          value: 'YEAR',
+          position: 1,
+        },
+        {
+          id: 'a91d77ed-90ad-41fc-83ae-e688c981abb2',
+          color: 'gray',
+          label: 'Other',
+          value: 'OTHER',
+          position: 2,
+        },
+        {
+          id: '5c595203-1b33-430b-abd8-8bc80aeedbd7',
+          color: 'red',
+          label: 'Empty',
+          value: 'EMPTY',
+          position: 3,
+        },
+      ],
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_NEXT_RENEWAL_DATE_FIELD_ID,
+      type: FieldType.DATE_TIME,
+      name: 'nextRenewalDate',
+      label: 'Next Renewal Date',
+      icon: 'IconCalendarClock',
+      isNullable: true,
+      defaultValue: null,
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_CREATOR_EMAIL_FIELD_ID,
+      type: FieldType.EMAILS,
+      name: 'creatorEmail',
+      label: 'Creator Email',
+      icon: 'IconMail',
+      isNullable: true,
+      defaultValue: null,
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_TAGS_FIELD_ID,
+      type: FieldType.ARRAY,
+      name: 'tags',
+      label: 'Tags',
+      icon: 'IconBracketsContain',
+      isNullable: true,
+      defaultValue: null,
+    },
+
+    {
+      universalIdentifier: CLOUD_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+      type: FieldType.ACTOR,
+      name: 'updatedBy',
+      label: 'Updated by',
+      description: 'The user who last updated the record',
+      icon: 'IconUserCircle',
+      isNullable: true,
+    },
+  ],
+});
@@ -0,0 +1,14 @@
+import { defineRole } from 'twenty-sdk';
+
+export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
+  '4bd740cc-f6a1-40c5-b46b-e2a4dbf5af04';
+
+export default defineRole({
+  universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  label: 'Twenty for Twenty default function role',
+  description: 'Twenty for Twenty default function role',
+  canReadAllObjectRecords: true,
+  canUpdateAllObjectRecords: true,
+  canSoftDeleteAllObjectRecords: true,
+  canDestroyAllObjectRecords: false,
+});
@@ -0,0 +1,25 @@
+import { z } from 'zod';
+
+const applicationConfigSchema = z
+  .object({
+    CLICKHOUSE_DATABASE: z.string().nonempty(),
+    CLICKHOUSE_URL: z.url(),
+    CLICKHOUSE_USERNAME: z.string().nonempty(),
+    CLICKHOUSE_PASSWORD: z.string().nonempty(),
+  });
+
+export const getApplicationConfig = () => {
+  const env = applicationConfigSchema.parse({
+    CLICKHOUSE_DATABASE: process.env.CLICKHOUSE_DATABASE,
+    CLICKHOUSE_URL: process.env.CLICKHOUSE_URL,
+    CLICKHOUSE_USERNAME: process.env.CLICKHOUSE_USERNAME,
+    CLICKHOUSE_PASSWORD: process.env.CLICKHOUSE_PASSWORD,
+  });
+
+  return {
+    clickHouseDatabase: env.CLICKHOUSE_DATABASE,
+    clickHouseUrl: env.CLICKHOUSE_URL,
+    clickHouseUsername: env.CLICKHOUSE_USERNAME,
+    clickHousePassword: env.CLICKHOUSE_PASSWORD,
+  };
+};
@@ -0,0 +1,43 @@
+import { z } from 'zod';
+
+import { getApplicationConfig } from 'src/shared/application-config';
+
+// Fetches rows from ClickHouse using a raw SQL query,
+// parses the JSONEachRow response, and validates each row against the provided Zod schema.
+export const fetchFromClickHouse = async <T>(
+  query: string,
+  schema: z.ZodType<T>,
+): Promise<T[]> => {
+  const { clickHouseUrl, clickHouseUsername, clickHousePassword } =
+    getApplicationConfig();
+
+  const response = await fetch(clickHouseUrl, {
+    method: 'POST',
+    headers: {
+      Authorization:
+        'Basic ' +
+        Buffer.from(`${clickHouseUsername}:${clickHousePassword}`).toString(
+          'base64',
+        ),
+      'Content-Type': 'text/plain',
+    },
+    body: query,
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+
+    throw new Error(`ClickHouse error: ${response.status} - ${errorText}`);
+  }
+
+  // Format is a list of JSON objects, one per line (JSONEachRow format).
+  const text = await response.text();
+
+  const rows = text
+    .trim()
+    .split('\n')
+    .filter((line) => line.trim())
+    .map((line) => JSON.parse(line));
+
+  return z.array(schema).parse(rows);
+};
@@ -0,0 +1,16 @@
+// ClickHouse returns DateTime64 values in the format 'YYYY-MM-DD HH:mm:ss.SSSSSS'
+// (space-separated, up to 6 fractional digits). Twenty's DATE_TIME fields expect
+// ISO 8601 format ('YYYY-MM-DDTHH:mm:ss.SSSZ', at most 3 fractional digits).
+//
+// Additionally, ClickHouse uses '1970-01-01 00:00:00.000000' as a sentinel for
+// null/empty dates. We map that to null.
+
+const CLICKHOUSE_EPOCH_SENTINEL = '1970-01-01 00:00:00.000000';
+
+export const clickHouseDateToIso = (value: string): string | null => {
+  if (!value || value === CLICKHOUSE_EPOCH_SENTINEL) {
+    return null;
+  }
+
+  return new Date(value.replace(' ', 'T') + 'Z').toISOString();
+};
@@ -0,0 +1,3 @@
+import Twenty from 'twenty-sdk/generated';
+
+export const twentyClient = new Twenty();
@@ -0,0 +1,159 @@
+import { defineView } from 'twenty-sdk';
+import { ViewType } from 'twenty-shared/types';
+
+import {
+  CLOUD_USER_2_ACTIVITY_STATUS_FIELD_ID,
+  CLOUD_USER_2_AVG_DAILY_PAGEVIEWS_LAST_30D_FIELD_ID,
+  CLOUD_USER_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+  CLOUD_USER_2_DAYS_SINCE_LAST_ACTIVITY_FIELD_ID,
+  CLOUD_USER_2_EMAIL_FIELD_ID,
+  CLOUD_USER_2_FULL_NAME_FIELD_ID,
+  CLOUD_USER_2_IS_ACTIVE_L24H_FIELD_ID,
+  CLOUD_USER_2_IS_ACTIVE_L30D_FIELD_ID,
+  CLOUD_USER_2_IS_ACTIVE_L7D_FIELD_ID,
+  CLOUD_USER_2_IS_TWENTY_FIELD_ID,
+  CLOUD_USER_2_LAST_ACTIVITY_DATE_FIELD_ID,
+  CLOUD_USER_2_PAGE_VIEWS_L24H_FIELD_ID,
+  CLOUD_USER_2_PAGE_VIEWS_L30D_FIELD_ID,
+  CLOUD_USER_2_PAGE_VIEWS_L7D_FIELD_ID,
+  CLOUD_USER_2_UPDATED_BY_FIELD_ID,
+  CLOUD_USER_2_USER_TENURE_FIELD_ID,
+  CLOUD_USER_2_WORKSPACE_COUNT_FIELD_ID,
+} from 'src/fields/cloud-user-2-field-ids';
+import { CLOUD_USER_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-2';
+
+export const ALL_CLOUD_USER_2_VIEW_ID = 'd6137e11-dbcd-4824-85d3-42fe1ca48cb6';
+
+export default defineView({
+  universalIdentifier: ALL_CLOUD_USER_2_VIEW_ID,
+  name: 'all-cloud-user-2',
+  objectUniversalIdentifier: CLOUD_USER_2_UNIVERSAL_IDENTIFIER,
+  icon: 'IconList',
+  position: 0,
+  type: ViewType.TABLE,
+  fields: [
+    {
+      universalIdentifier: '9e82305e-9fd9-4bf7-8cc5-098eb35a748e',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_FULL_NAME_FIELD_ID,
+      position: 0,
+      isVisible: true,
+      size: 180,
+    },
+    {
+      universalIdentifier: 'ea737839-bcb7-4da1-aaf6-79cda65e6263',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_EMAIL_FIELD_ID,
+      position: 1,
+      isVisible: true,
+      size: 200,
+    },
+    {
+      universalIdentifier: 'ccd1eca7-c851-4e97-9f0e-48c7139f3ced',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_ACTIVITY_STATUS_FIELD_ID,
+      position: 2,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: 'e99c82d3-d2fe-4758-9253-ab2ca2b50ef8',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_IS_TWENTY_FIELD_ID,
+      position: 3,
+      isVisible: true,
+      size: 100,
+    },
+    {
+      universalIdentifier: 'c03da046-30b6-402e-8d4b-10799aa5102d',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_WORKSPACE_COUNT_FIELD_ID,
+      position: 4,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: 'e3a787f2-77d1-4865-a5c2-c60976809d4d',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_USER_TENURE_FIELD_ID,
+      position: 5,
+      isVisible: true,
+      size: 110,
+    },
+    {
+      universalIdentifier: '352d77f2-726b-4a75-8c9d-3117cfabedc1',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_IS_ACTIVE_L24H_FIELD_ID,
+      position: 6,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: 'cf06d6b0-e425-4daf-8a6d-9b66a058ae80',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_IS_ACTIVE_L7D_FIELD_ID,
+      position: 7,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: '4ab63729-0b48-4b0b-ac9e-e72f5448998c',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_IS_ACTIVE_L30D_FIELD_ID,
+      position: 8,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: '8c6a3315-fa47-4a12-b9fe-1775462c803d',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_PAGE_VIEWS_L24H_FIELD_ID,
+      position: 9,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '89011d63-e670-498e-bc8f-142f7ceafd04',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_PAGE_VIEWS_L7D_FIELD_ID,
+      position: 10,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '88816c57-aa5b-4efe-b53a-b288fad24ab4',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_PAGE_VIEWS_L30D_FIELD_ID,
+      position: 11,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '3b0ff937-1eaf-4589-80ec-23abb4f2e204',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_2_AVG_DAILY_PAGEVIEWS_LAST_30D_FIELD_ID,
+      position: 12,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'dee5f679-9ad9-4bc4-94a9-af28d7210699',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_2_DAYS_SINCE_LAST_ACTIVITY_FIELD_ID,
+      position: 13,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '25b4e175-be18-4b20-9c51-5db0a596d968',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_2_LAST_ACTIVITY_DATE_FIELD_ID,
+      position: 14,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'f1706c21-d164-414c-9cf5-4cf376584bb9',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+      position: 15,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '88d0f343-42c1-4d36-82df-cfdb74e785eb',
+      fieldMetadataUniversalIdentifier: CLOUD_USER_2_UPDATED_BY_FIELD_ID,
+      position: 16,
+      isVisible: true,
+      size: 150,
+    },
+  ],
+});
@@ -0,0 +1,56 @@
+import { defineView } from 'twenty-sdk';
+import { ViewType } from 'twenty-shared/types';
+
+import {
+  CLOUD_USER_WORKSPACE_2_ID_OF_THE_USER_WORKSPACE_FIELD_ID,
+  CLOUD_USER_WORKSPACE_2_TWENTY_USER_IDENTIFIER_FIELD_ID,
+  CLOUD_USER_WORKSPACE_2_TWENTY_WORKSPACE_IDENTIFIER_FIELD_ID,
+  CLOUD_USER_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+} from 'src/fields/cloud-user-workspace-2-field-ids';
+import { CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-user-workspace-2';
+
+export const ALL_CLOUD_USER_WORKSPACE_2_VIEW_ID =
+  'f80e44ef-43fb-409e-a003-decadaa38b3e';
+
+export default defineView({
+  universalIdentifier: ALL_CLOUD_USER_WORKSPACE_2_VIEW_ID,
+  name: 'all-cloud-user-workspace-2',
+  objectUniversalIdentifier: CLOUD_USER_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  icon: 'IconList',
+  position: 0,
+  type: ViewType.TABLE,
+  fields: [
+    {
+      universalIdentifier: '4a0d9d93-d182-443d-8a70-3a4f25e51c50',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_WORKSPACE_2_TWENTY_USER_IDENTIFIER_FIELD_ID,
+      position: 0,
+      isVisible: true,
+      size: 200,
+    },
+    {
+      universalIdentifier: '14b78fc4-a6a5-471b-ba87-6aebc9a3da68',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_WORKSPACE_2_TWENTY_WORKSPACE_IDENTIFIER_FIELD_ID,
+      position: 1,
+      isVisible: true,
+      size: 220,
+    },
+    {
+      universalIdentifier: '8c9c8a1b-d511-4706-afe7-32b22cce2e7e',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_WORKSPACE_2_ID_OF_THE_USER_WORKSPACE_FIELD_ID,
+      position: 2,
+      isVisible: true,
+      size: 200,
+    },
+    {
+      universalIdentifier: 'ee35eded-4222-4a87-b31c-69e415e331db',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_USER_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+      position: 3,
+      isVisible: true,
+      size: 150,
+    },
+  ],
+});
@@ -0,0 +1,368 @@
+import { defineView } from 'twenty-sdk';
+import { ViewType } from 'twenty-shared/types';
+
+import {
+  CLOUD_WORKSPACE_2_ACTIVATION_STATUS_FIELD_ID,
+  CLOUD_WORKSPACE_2_ACTIVE_USERS_L24H_FIELD_ID,
+  CLOUD_WORKSPACE_2_ACTIVE_USERS_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_ACTIVE_USERS_L7D_FIELD_ID,
+  CLOUD_WORKSPACE_2_ALEXA_RANK_FIELD_ID,
+  CLOUD_WORKSPACE_2_ANNUAL_REVENUE_FIELD_ID,
+  CLOUD_WORKSPACE_2_ARR_FIELD_ID,
+  CLOUD_WORKSPACE_2_COMPANY_FOUNDED_YEAR_FIELD_ID,
+  CLOUD_WORKSPACE_2_COMPANY_LINKEDIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_COMPANY_NAME_FIELD_ID,
+  CLOUD_WORKSPACE_2_CREATOR_EMAIL_FIELD_ID,
+  CLOUD_WORKSPACE_2_CUSTOM_DOMAIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+  CLOUD_WORKSPACE_2_DESCRIPTION_FIELD_ID,
+  CLOUD_WORKSPACE_2_EMPLOYEES_FIELD_ID,
+  CLOUD_WORKSPACE_2_INDUSTRY_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ACTIVE_L24H_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ACTIVE_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ACTIVE_L7D_FIELD_ID,
+  CLOUD_WORKSPACE_2_IS_ENRICHED_FIELD_ID,
+  CLOUD_WORKSPACE_2_LAST_PAGE_VIEW_DATE_FIELD_ID,
+  CLOUD_WORKSPACE_2_LATEST_FUNDING_STAGE_FIELD_ID,
+  CLOUD_WORKSPACE_2_MRR_FIELD_ID,
+  CLOUD_WORKSPACE_2_NEXT_RENEWAL_DATE_FIELD_ID,
+  CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_TOTAL_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAGE_VIEWS_L24H_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAGE_VIEWS_L30D_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAGE_VIEWS_L7D_FIELD_ID,
+  CLOUD_WORKSPACE_2_PAYMENT_FREQUENCY_FIELD_ID,
+  CLOUD_WORKSPACE_2_POTENTIAL_ARR_FIELD_ID,
+  CLOUD_WORKSPACE_2_SUB_DOMAIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_SUBSCRIPTION_STATUS_FIELD_ID,
+  CLOUD_WORKSPACE_2_TAGS_FIELD_ID,
+  CLOUD_WORKSPACE_2_TOTAL_EVER_ACTIVE_WORKSPACE_USERS_FIELD_ID,
+  CLOUD_WORKSPACE_2_TOTAL_FUNDING_FIELD_ID,
+  CLOUD_WORKSPACE_2_TOTAL_WORKSPACE_USERS_FIELD_ID,
+  CLOUD_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+  CLOUD_WORKSPACE_2_WORKSPACE_BUSINESS_DOMAIN_FIELD_ID,
+  CLOUD_WORKSPACE_2_WORKSPACE_TENURE_FIELD_ID,
+} from 'src/fields/cloud-workspace-2-field-ids';
+import { CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER } from 'src/objects/cloud-workspace-2';
+
+export const ALL_CLOUD_WORKSPACE_2_VIEW_ID =
+  '3747a3a0-25a0-42f0-99d9-61a4b4a76009';
+
+export default defineView({
+  universalIdentifier: ALL_CLOUD_WORKSPACE_2_VIEW_ID,
+  name: 'all-cloud-workspace-2',
+  objectUniversalIdentifier: CLOUD_WORKSPACE_2_UNIVERSAL_IDENTIFIER,
+  icon: 'IconList',
+  position: 0,
+  type: ViewType.TABLE,
+  fields: [
+    {
+      universalIdentifier: '146e3f00-8efc-46be-aafb-a6bafcefa5b0',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_COMPANY_NAME_FIELD_ID,
+      position: 0,
+      isVisible: true,
+      size: 180,
+    },
+    {
+      universalIdentifier: '10ce2149-d25b-4e21-8215-c628677bc4cb',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_SUB_DOMAIN_FIELD_ID,
+      position: 1,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'c8735db0-9a89-4204-ad58-b68b71c10182',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_DESCRIPTION_FIELD_ID,
+      position: 2,
+      isVisible: true,
+      size: 250,
+    },
+    {
+      universalIdentifier: 'cf3f182b-1a69-4274-a200-ef191400a9e8',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_INDUSTRY_FIELD_ID,
+      position: 3,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'c932adb5-129b-4457-bbfa-75baaf27707f',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_EMPLOYEES_FIELD_ID,
+      position: 4,
+      isVisible: true,
+      size: 110,
+    },
+    {
+      universalIdentifier: '5f0d33f0-60f0-442c-8c2d-19bfe1c9ea49',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_SUBSCRIPTION_STATUS_FIELD_ID,
+      position: 5,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '904e4ecd-f997-42b6-933a-1174cf2bebdc',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_ACTIVATION_STATUS_FIELD_ID,
+      position: 6,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'f2d919e7-f782-4edb-ad1a-b99649fbbaf9',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_MRR_FIELD_ID,
+      position: 7,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: '92afa154-72f2-4b01-8376-2f5311bb40f9',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_ARR_FIELD_ID,
+      position: 8,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: 'c63bcd0a-f8d3-4c86-b9c0-6d638d7e9195',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_POTENTIAL_ARR_FIELD_ID,
+      position: 9,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '8659ca48-23b0-4fb8-b588-0919169cae4d',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_ANNUAL_REVENUE_FIELD_ID,
+      position: 10,
+      isVisible: true,
+      size: 140,
+    },
+    {
+      universalIdentifier: '1524079b-0e7e-41a6-80bc-85bcdfcab537',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_TOTAL_FUNDING_FIELD_ID,
+      position: 11,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '36a755ee-903c-4c61-b091-ebc0e687333d',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_ACTIVE_USERS_L24H_FIELD_ID,
+      position: 12,
+      isVisible: true,
+      size: 140,
+    },
+    {
+      universalIdentifier: '5ac28b38-823f-421c-a177-1749b8283381',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_ACTIVE_USERS_L7D_FIELD_ID,
+      position: 13,
+      isVisible: true,
+      size: 140,
+    },
+    {
+      universalIdentifier: '6fa0bfe5-ac55-4165-8830-5c084466c7f5',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_ACTIVE_USERS_L30D_FIELD_ID,
+      position: 14,
+      isVisible: true,
+      size: 140,
+    },
+    {
+      universalIdentifier: 'bee2ed03-23c2-4c99-86db-c0dd4599c669',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_PAGE_VIEWS_L24H_FIELD_ID,
+      position: 15,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: 'e8f9775b-c984-4832-800a-3dd26060c0aa',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_PAGE_VIEWS_L7D_FIELD_ID,
+      position: 16,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '95c4fdfc-8fe5-43ce-9885-3f0fc5b4756a',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_PAGE_VIEWS_L30D_FIELD_ID,
+      position: 17,
+      isVisible: true,
+      size: 130,
+    },
+    {
+      universalIdentifier: '6448c0f1-1469-466e-99ed-c7aa015d9e38',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_TOTAL_WORKSPACE_USERS_FIELD_ID,
+      position: 18,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '082ed200-9bba-444a-9b28-3a129b7ac9d8',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_TOTAL_EVER_ACTIVE_WORKSPACE_USERS_FIELD_ID,
+      position: 19,
+      isVisible: true,
+      size: 180,
+    },
+    {
+      universalIdentifier: 'd61bbf0c-48ad-428a-90a1-87b54a87bacf',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_WORKSPACE_TENURE_FIELD_ID,
+      position: 20,
+      isVisible: true,
+      size: 140,
+    },
+    {
+      universalIdentifier: '26058a5b-edde-4caa-a034-32b8edb54ce6',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_IS_ACTIVE_L24H_FIELD_ID,
+      position: 21,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: '36931d2b-f250-4325-a877-3285dd8a797e',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_IS_ACTIVE_L7D_FIELD_ID,
+      position: 22,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: 'c120fc92-4796-4cf4-866f-c1d8c4555321',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_IS_ACTIVE_L30D_FIELD_ID,
+      position: 23,
+      isVisible: true,
+      size: 120,
+    },
+    {
+      universalIdentifier: 'a6674592-070b-41c1-baab-f360984328cc',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_IS_ENRICHED_FIELD_ID,
+      position: 24,
+      isVisible: true,
+      size: 110,
+    },
+    {
+      universalIdentifier: 'd3701295-ef41-46c4-8dd3-b31c27663516',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_CUSTOM_DOMAIN_FIELD_ID,
+      position: 25,
+      isVisible: true,
+      size: 180,
+    },
+    {
+      universalIdentifier: 'dd22ffe7-95ed-4c67-be33-c2d1592daa32',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_WORKSPACE_BUSINESS_DOMAIN_FIELD_ID,
+      position: 26,
+      isVisible: true,
+      size: 200,
+    },
+    {
+      universalIdentifier: 'c7a9bcf8-d41d-4ded-b680-868e470e3228',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_COMPANY_LINKEDIN_FIELD_ID,
+      position: 27,
+      isVisible: true,
+      size: 180,
+    },
+    {
+      universalIdentifier: '398eb88f-0d12-446d-a486-d1fb262f82bb',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_CREATOR_EMAIL_FIELD_ID,
+      position: 28,
+      isVisible: true,
+      size: 200,
+    },
+    {
+      universalIdentifier: '52d2a1b3-e2b2-4d6b-a5dd-ea8d63c7c369',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_TAGS_FIELD_ID,
+      position: 29,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'f74fed2c-94dc-4954-ac27-79acd7e04103',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_PAYMENT_FREQUENCY_FIELD_ID,
+      position: 30,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '666d0cea-e50b-4cc8-9ed5-5f5c0ec7fe7e',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_NEXT_RENEWAL_DATE_FIELD_ID,
+      position: 31,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '60508519-5ac4-4f96-a30f-5c75d3ce9a93',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_L30D_FIELD_ID,
+      position: 32,
+      isVisible: true,
+      size: 160,
+    },
+    {
+      universalIdentifier: '3b1ca2b6-31a1-4755-a9a4-07ee9a9b8a33',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_NUMBER_OF_EVENTS_TOTAL_FIELD_ID,
+      position: 33,
+      isVisible: true,
+      size: 160,
+    },
+    {
+      universalIdentifier: '47ba21ab-a5c5-42b9-b1e2-7a988ece154d',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_ALEXA_RANK_FIELD_ID,
+      position: 34,
+      isVisible: true,
+      size: 110,
+    },
+    {
+      universalIdentifier: 'de5e2e42-2600-488c-81d0-f700e7dd0f67',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_COMPANY_FOUNDED_YEAR_FIELD_ID,
+      position: 35,
+      isVisible: true,
+      size: 160,
+    },
+    {
+      universalIdentifier: 'd6bec718-8b50-41e2-95d7-521151e2df82',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_LATEST_FUNDING_STAGE_FIELD_ID,
+      position: 36,
+      isVisible: true,
+      size: 160,
+    },
+    {
+      universalIdentifier: '9aaff045-64fa-4857-a8df-7394cf43a120',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_LAST_PAGE_VIEW_DATE_FIELD_ID,
+      position: 37,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: 'f2cb82b9-ebb4-4258-971b-061d709f28e5',
+      fieldMetadataUniversalIdentifier:
+        CLOUD_WORKSPACE_2_DATA_LAST_UPDATED_AT_FIELD_ID,
+      position: 38,
+      isVisible: true,
+      size: 150,
+    },
+    {
+      universalIdentifier: '7e631992-3ae6-478b-9874-67c3b211f05a',
+      fieldMetadataUniversalIdentifier: CLOUD_WORKSPACE_2_UPDATED_BY_FIELD_ID,
+      position: 39,
+      isVisible: true,
+      size: 150,
+    },
+  ],
+});
@@ -0,0 +1,31 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "sourceMap": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "jsx": "react-jsx",
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "importHelpers": true,
+    "allowUnreachableCode": false,
+    "strict": true,
+    "alwaysStrict": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": false,
+    "target": "es2018",
+    "module": "esnext",
+    "lib": ["es2020", "dom"],
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "resolveJsonModule": true,
+    "paths": {
+      "src/*": ["./src/*"],
+      "~/*": ["./*"]
+    }
+  },
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}
@@ -7,9 +7,9 @@ This document outlines the best practices you should follow when working on the

 ## State management

-React and Jotai handle state management in the codebase.
+React and Recoil handle state management in the codebase.

-### Use Jotai atoms to store state
+### Use `useRecoilState` to store state

 It's good practice to create as many atoms as you need to store your state.

@@ -20,16 +20,13 @@ It's better to use extra atoms than trying to be too concise with props drilling
 </Warning>

 ```tsx
-import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
-import { useAtomState } from '@/ui/utilities/state/jotai/hooks/useAtomState';
-
-export const myAtomState = createAtomState<string>({
+export const myAtomState = atom({
  key: 'myAtomState',
-  defaultValue: 'default value',
+  default: 'default value',
 });

 export const MyComponent = () => {
-  const [myAtom, setMyAtom] = useAtomState(myAtomState);
+  const [myAtom, setMyAtom] = useRecoilState(myAtomState);

  return (
    <div>
@@ -46,7 +43,7 @@ export const MyComponent = () => {

 Avoid using `useRef` to store state.

-If you want to store state, you should use `useState` or Jotai atoms with `useAtomState`.
+If you want to store state, you should use `useState` or `useRecoilState`.

 See [how to manage re-renders](#managing-re-renders) if you feel like you need `useRef` to prevent some re-renders from happening.

@@ -86,8 +83,8 @@ You can apply the same for data fetching logic, with Apollo hooks.
 // ❌ Bad, will cause re-renders even if data is not changing,
 //    because useEffect needs to be re-evaluated
 export const PageComponent = () => {
-  const [data, setData] = useAtomState(dataState);
-  const [someDependency] = useAtomState(someDependencyState);
+  const [data, setData] = useRecoilState(dataState);
+  const [someDependency] = useRecoilState(someDependencyState);

  useEffect(() => {
    if(someDependency !== data) {
@@ -99,7 +96,9 @@ export const PageComponent = () => {
 };

 export const App = () => (
-  <PageComponent />
+  <RecoilRoot>
+    <PageComponent />
+  </RecoilRoot>
 );
 ```

@@ -107,14 +106,14 @@ export const App = () => (
 // ✅ Good, will not cause re-renders if data is not changing,
 //   because useEffect is re-evaluated in another sibling component
 export const PageComponent = () => {
-  const [data, setData] = useAtomState(dataState);
+  const [data, setData] = useRecoilState(dataState);

  return <div>{data}</div>;
 };

 export const PageData = () => {
-  const [data, setData] = useAtomState(dataState);
-  const [someDependency] = useAtomState(someDependencyState);
+  const [data, setData] = useRecoilState(dataState);
+  const [someDependency] = useRecoilState(someDependencyState);

  useEffect(() => {
    if(someDependency !== data) {
@@ -126,16 +125,16 @@ export const PageData = () => {
 };

 export const App = () => (
-  <>
+  <RecoilRoot>
    <PageData />
    <PageComponent />
-  </>
+  </RecoilRoot>
 );
 ```

-### Use atom family states and selectors
+### Use recoil family states and recoil family selectors

-Atom family states and selectors are a great way to avoid re-renders.
+Recoil family states and selectors are a great way to avoid re-renders.

 They are useful when you need to store a list of items.

@@ -83,9 +83,9 @@ See [Hooks](https://react.dev/learn/reusing-logic-with-custom-hooks) for more de

 ### States

-Contains the state management logic. [Jotai](https://jotai.org) handles this.
+Contains the state management logic. [RecoilJS](https://recoiljs.org) handles this.

- Selectors: Derived atoms (using `createAtomSelector`) compute values from other atoms and are automatically memoized.
+- Selectors: See [RecoilJS Selectors](https://recoiljs.org/docs/basic-tutorial/selectors) for more details.

 React's built-in state management still handles state within a component.

@@ -52,7 +52,7 @@ The project has a clean and simple stack, with minimal boilerplate code.
 - [React](https://react.dev/)
 - [Apollo](https://www.apollographql.com/docs/)
 - [GraphQL Codegen](https://the-guild.dev/graphql/codegen)
- [Jotai](https://jotai.org/)
+- [Recoil](https://recoiljs.org/docs/introduction/core-concepts)
 - [TypeScript](https://www.typescriptlang.org/)

 **Testing**
@@ -76,7 +76,7 @@ To avoid unnecessary [re-renders](/developers/contribute/capabilities/frontend-d

 ### State Management

-[Jotai](https://jotai.org/) handles state management.
+[Recoil](https://recoiljs.org/docs/introduction/core-concepts) handles state management.

 See [best practices](/developers/contribute/capabilities/frontend-development/best-practices-front#state-management) for more information on state management.

@@ -159,7 +159,7 @@ export enum PageHotkeyScope {
 }
 ```

-Internally, the currently selected scope is stored in a Jotai atom that is shared across the application :
+Internally, the currently selected scope is stored in a Recoil state that is shared across the application :

 ```tsx
 export const currentHotkeyScopeState = createState<HotkeyScope>({
@@ -168,10 +168,10 @@ export const currentHotkeyScopeState = createState<HotkeyScope>({
 });
 ```

-But this atom should never be handled manually ! We'll see how to use it in the next section.
+But this Recoil state should never be handled manually ! We'll see how to use it in the next section.

 ## How is it working internally?

 We made a thin wrapper on top of [react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) that makes it more performant and avoids unnecessary re-renders.

-We also create a Jotai atom to handle the hotkey scope state and make it available everywhere in the application.
+We also create a Recoil state to handle the hotkey scope state and make it available everywhere in the application.
@@ -31,6 +31,13 @@ Create a new app using the official scaffolder, then authenticate and start deve
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app

+# If you don't use yarn@4
+corepack enable
+yarn install
+
+# Authenticate using your API key (you'll be prompted)
+yarn twenty auth:login
+
 # Start dev mode: automatically syncs local changes to your workspace
 yarn twenty app:dev
 ```
@@ -60,9 +67,6 @@ yarn twenty function:logs
 # Execute a function by name
 yarn twenty function:execute -n my-function -p '{"name": "test"}'

-# Execute the pre-install function
-yarn twenty function:execute --preInstall
-
 # Execute the post-install function
 yarn twenty function:execute --postInstall

@@ -82,7 +86,7 @@ When you run `npx create-twenty-app@latest my-twenty-app`, the scaffolder:
 - Copies a minimal base application into `my-twenty-app/`
 - Adds a local `twenty-sdk` dependency and Yarn 4 configuration
 - Creates config files and scripts wired to the `twenty` CLI
- Generates core files (application config, default function role, pre-install and post-install functions) plus example files based on the scaffolding mode
+- Generates core files (application config, default function role, post-install function) plus example files based on the scaffolding mode

 A freshly scaffolded app with the default `--exhaustive` mode looks like this:

@@ -109,7 +113,6 @@ my-twenty-app/
  │   └── example-field.ts              # Example standalone field definition
  ├── logic-functions/
  │   ├── hello-world.ts                # Example logic function
-  │   ├── pre-install.ts                # Pre-install logic function
  │   └── post-install.ts               # Post-install logic function
  ├── front-components/
  │   └── hello-world.tsx               # Example front component
@@ -121,7 +124,7 @@ my-twenty-app/
      └── example-skill.ts                # Example AI agent skill definition
 ```

-With `--minimal`, only the core files are created (`application-config.ts`, `roles/default-role.ts`, `logic-functions/pre-install.ts`, and `logic-functions/post-install.ts`). With `--interactive`, you choose which example files to include.
+With `--minimal`, only the core files are created (`application-config.ts`, `roles/default-role.ts`, and `logic-functions/post-install.ts`). With `--interactive`, you choose which example files to include.

 At a high level:

@@ -142,8 +145,6 @@ The SDK detects entities by parsing your TypeScript files for **`export default
 |-----------------|-------------|
 | `defineObject()` | Custom object definitions |
 | `defineLogicFunction()` | Logic function definitions |
-| `definePreInstallLogicFunction()` | Pre-install logic function (runs before installation) |
-| `definePostInstallLogicFunction()` | Post-install logic function (runs after installation) |
 | `defineFrontComponent()` | Front component definitions |
 | `defineRole()` | Role definitions |
 | `defineField()` | Field extensions for existing objects |
@@ -169,7 +170,7 @@ export default defineObject({

 Later commands will add more files and folders:

- `yarn twenty app:dev` will auto-generate two typed API clients in `node_modules/twenty-sdk/generated`: `CoreApiClient` (for workspace data via `/graphql`) and `MetadataApiClient` (for workspace configuration and file uploads via `/metadata`).
+- `yarn twenty app:dev` will auto-generate a typed API client in `node_modules/twenty-sdk/generated` (typed Twenty client + workspace types).
 - `yarn twenty entity:add` will add entity definition files under `src/` for your custom objects, functions, front components, roles, skills, and more.

 ## Authentication
@@ -218,8 +219,6 @@ The SDK provides helper functions for defining your app entities. As described i
 | `defineApplication()` | Configure application metadata (required, one per app) |
 | `defineObject()` | Define custom objects with fields |
 | `defineLogicFunction()` | Define logic functions with handlers |
-| `definePreInstallLogicFunction()` | Define a pre-install logic function (one per app) |
-| `definePostInstallLogicFunction()` | Define a post-install logic function (one per app) |
 | `defineFrontComponent()` | Define front components for custom UI |
 | `defineRole()` | Configure role permissions and object access |
 | `defineField()` | Extend existing objects with additional fields |
@@ -326,7 +325,6 @@ Every app has a single `application-config.ts` file that describes:
 - **Who the app is**: identifiers, display name, and description.
 - **How its functions run**: which role they use for permissions.
 - **(Optional) variables**: key–value pairs exposed to your functions as environment variables.
- **(Optional) pre-install function**: a logic function that runs before the app is installed.
 - **(Optional) post-install function**: a logic function that runs after the app is installed.

 Use `defineApplication()` to define your application configuration:
@@ -335,6 +333,7 @@ Use `defineApplication()` to define your application configuration:
 // src/application-config.ts
 import { defineApplication } from 'twenty-sdk';
 import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';

 export default defineApplication({
  universalIdentifier: '4ec0391d-18d5-411c-b2f3-266ddc1c3ef7',
@@ -350,6 +349,7 @@ export default defineApplication({
    },
  },
  defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
 });
 ```

@@ -357,7 +357,7 @@ Notes:
 - `universalIdentifier` fields are deterministic IDs you own; generate them once and keep them stable across syncs.
 - `applicationVariables` become environment variables for your functions (for example, `DEFAULT_RECIPIENT_NAME` is available as `process.env.DEFAULT_RECIPIENT_NAME`).
 - `defaultRoleUniversalIdentifier` must match the role file (see below).
- Pre-install and post-install functions are automatically detected during the manifest build. See [Pre-install functions](#pre-install-functions) and [Post-install functions](#post-install-functions).
+- `postInstallLogicFunctionUniversalIdentifier` (optional) points to a logic function that runs automatically after the app is installed. See [Post-install functions](#post-install-functions).

 #### Roles and permissions

@@ -430,10 +430,10 @@ Each function file uses `defineLogicFunction()` to export a configuration with a
 // src/app/createPostCard.logic-function.ts
 import { defineLogicFunction } from 'twenty-sdk';
 import type { DatabaseEventPayload, ObjectRecordCreateEvent, CronPayload, RoutePayload } from 'twenty-sdk';
-import { CoreApiClient, type Person } from 'twenty-sdk/generated';
+import Twenty, { type Person } from '~/generated';

 const handler = async (params: RoutePayload) => {
-  const client = new CoreApiClient();
+  const client = new Twenty(); // generated typed client
  const name = 'name' in params.queryStringParameters
    ? params.queryStringParameters.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
    : 'Hello world';
@@ -490,43 +490,6 @@ Notes:
 - The `triggers` array is optional. Functions without triggers can be used as utility functions called by other functions.
 - You can mix multiple trigger types in a single function.

-### Pre-install functions
-
-A pre-install function is a logic function that runs automatically before your app is installed on a workspace. This is useful for validation tasks, prerequisite checks, or preparing workspace state before the main installation proceeds.
-
-When you scaffold a new app with `create-twenty-app`, a pre-install function is generated for you at `src/logic-functions/pre-install.ts`:
-
-```typescript
-// src/logic-functions/pre-install.ts
-import { definePreInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
-
-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Pre install logic function executed successfully!', payload.previousVersion);
-};
-
-export default definePreInstallLogicFunction({
-  universalIdentifier: '<generated-uuid>',
-  name: 'pre-install',
-  description: 'Runs before installation to prepare the application.',
-  timeoutSeconds: 300,
-  handler,
-});
-```
-
-You can also manually execute the pre-install function at any time using the CLI:
-
-```bash filename="Terminal"
-yarn twenty function:execute --preInstall
-```
-
-Key points:
- Pre-install functions use `definePreInstallLogicFunction()` — a specialized variant that omits trigger settings (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `isTool`).
- The handler receives an `InstallLogicFunctionPayload` with `{ previousVersion: string }` — the version of the app that was previously installed (or an empty string for fresh installs).
- Only one pre-install function is allowed per application. The manifest build will error if more than one is detected.
- The function's `universalIdentifier` is automatically set as `preInstallLogicFunctionUniversalIdentifier` on the application manifest during the build — you do not need to reference it in `defineApplication()`.
- The default timeout is set to 300 seconds (5 minutes) to allow for longer preparation tasks.
- Pre-install functions do not need triggers — they are invoked by the platform before installation or manually via `function:execute --preInstall`.
-
 ### Post-install functions

 A post-install function is a logic function that runs automatically after your app is installed on a workspace. This is useful for one-time setup tasks such as seeding default data, creating initial records, or configuring workspace settings.
@@ -535,14 +498,16 @@ When you scaffold a new app with `create-twenty-app`, a post-install function is

 ```typescript
 // src/logic-functions/post-install.ts
-import { definePostInstallLogicFunction, type InstallLogicFunctionPayload } from 'twenty-sdk';
+import { defineLogicFunction } from 'twenty-sdk';

-const handler = async (payload: InstallLogicFunctionPayload): Promise<void> => {
-  console.log('Post install logic function executed successfully!', payload.previousVersion);
+export const POST_INSTALL_UNIVERSAL_IDENTIFIER = '<generated-uuid>';
+
+const handler = async (): Promise<void> => {
+  console.log('Post install logic function executed successfully!');
 };

-export default definePostInstallLogicFunction({
-  universalIdentifier: '<generated-uuid>',
+export default defineLogicFunction({
+  universalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
  name: 'post-install',
  description: 'Runs after installation to set up the application.',
  timeoutSeconds: 300,
@@ -550,6 +515,17 @@ export default definePostInstallLogicFunction({
 });
 ```

+The function is wired into your app by referencing its universal identifier in `application-config.ts`:
+
+```typescript
+import { POST_INSTALL_UNIVERSAL_IDENTIFIER } from 'src/logic-functions/post-install';
+
+export default defineApplication({
+  // ...
+  postInstallLogicFunctionUniversalIdentifier: POST_INSTALL_UNIVERSAL_IDENTIFIER,
+});
+```
+
 You can also manually execute the post-install function at any time using the CLI:

 ```bash filename="Terminal"
@@ -557,10 +533,8 @@ yarn twenty function:execute --postInstall
 ```

 Key points:
- Post-install functions use `definePostInstallLogicFunction()` — a specialized variant that omits trigger settings (`cronTriggerSettings`, `databaseEventTriggerSettings`, `httpRouteTriggerSettings`, `isTool`).
- The handler receives an `InstallLogicFunctionPayload` with `{ previousVersion: string }` — the version of the app that was previously installed (or an empty string for fresh installs).
- Only one post-install function is allowed per application. The manifest build will error if more than one is detected.
- The function's `universalIdentifier` is automatically set as `postInstallLogicFunctionUniversalIdentifier` on the application manifest during the build — you do not need to reference it in `defineApplication()`.
+- Post-install functions are standard logic functions — they use `defineLogicFunction()` like any other function.
+- The `postInstallLogicFunctionUniversalIdentifier` field in `defineApplication()` is optional. If omitted, no function runs after installation.
 - The default timeout is set to 300 seconds (5 minutes) to allow for longer setup tasks like data seeding.
 - Post-install functions do not need triggers — they are invoked by the platform during installation or manually via `function:execute --postInstall`.

@@ -668,10 +642,10 @@ To mark a logic function as a tool, set `isTool: true` and provide a `toolInputS
 ```typescript
 // src/logic-functions/enrich-company.logic-function.ts
 import { defineLogicFunction } from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-sdk/generated';
+import Twenty from '~/generated';

 const handler = async (params: { companyName: string; domain?: string }) => {
-  const client = new CoreApiClient();
+  const client = new Twenty();

  const result = await client.mutation({
    createTask: {
@@ -729,7 +703,7 @@ Key points:
 Front components let you build custom React components that render within Twenty's UI. Use `defineFrontComponent()` to define components with built-in validation:

 ```typescript
-// src/front-components/my-widget.tsx
+// src/my-widget.front-component.tsx
 import { defineFrontComponent } from 'twenty-sdk';

 const MyWidget = () => {
@@ -751,13 +725,14 @@ export default defineFrontComponent({

 Key points:
 - Front components are React components that render in isolated contexts within Twenty.
+- Use the `*.front-component.tsx` file suffix for automatic detection.
 - The `component` field references your React component.
 - Components are built and synced automatically during `yarn twenty app:dev`.

 You can create new front components in two ways:

 - **Scaffolded**: Run `yarn twenty entity:add` and choose the option to add a new front component.
- **Manual**: Create a new `.tsx` file and use `defineFrontComponent()`, following the same pattern.
+- **Manual**: Create a new `*.front-component.tsx` file and use `defineFrontComponent()`.

 ### Skills

@@ -793,24 +768,18 @@ You can create new skills in two ways:
 - **Scaffolded**: Run `yarn twenty entity:add` and choose the option to add a new skill.
 - **Manual**: Create a new file and use `defineSkill()`, following the same pattern.

-### Generated typed clients
+### Generated typed client

-Two typed clients are auto-generated by `yarn twenty app:dev` and stored in `node_modules/twenty-sdk/generated` based on your workspace schema:
-
- **`CoreApiClient`** — queries the `/graphql` endpoint for workspace data
- **`MetadataApiClient`** — queries the `/metadata` endpoint for workspace configuration and file uploads
+The typed client is auto-generated by `yarn twenty app:dev` and stored in `node_modules/twenty-sdk/generated` based on your workspace schema. Use it in your functions:

 ```typescript
-import { CoreApiClient, MetadataApiClient } from 'twenty-sdk/generated';
+import Twenty from '~/generated';

-const client = new CoreApiClient();
+const client = new Twenty();
 const { me } = await client.query({ me: { id: true, displayName: true } });
-
-const metadataClient = new MetadataApiClient();
-const { currentWorkspace } = await metadataClient.query({ currentWorkspace: { id: true } });
 ```

-Both clients are re-generated automatically by `yarn twenty app:dev` whenever your objects or fields change.
+The client is re-generated automatically by `yarn twenty app:dev` whenever your objects or fields change.

 #### Runtime credentials in logic functions

@@ -826,17 +795,17 @@ Notes:

 #### Uploading files

-The generated `MetadataApiClient` includes an `uploadFile` method for attaching files to file-type fields on your workspace objects. Because standard GraphQL clients do not support multipart file uploads natively, the client provides this dedicated method that implements the [GraphQL multipart request specification](https://github.com/jaydenseric/graphql-multipart-request-spec) under the hood.
+The generated `Twenty` client includes an `uploadFile` method for attaching files to file-type fields on your workspace objects. Because standard GraphQL clients do not support multipart file uploads natively, the client provides this dedicated method that implements the [GraphQL multipart request specification](https://github.com/jaydenseric/graphql-multipart-request-spec) under the hood.

 ```typescript
-import { MetadataApiClient } from 'twenty-sdk/generated';
+import Twenty from '~/generated';
 import * as fs from 'fs';

-const metadataClient = new MetadataApiClient();
+const client = new Twenty();

 const fileBuffer = fs.readFileSync('./invoice.pdf');

-const uploadedFile = await metadataClient.uploadFile(
+const uploadedFile = await client.uploadFile(
  fileBuffer,                                         // file contents as a Buffer
  'invoice.pdf',                                      // filename
  'application/pdf',                                  // MIME type (defaults to 'application/octet-stream')
@@ -866,7 +835,7 @@ uploadFile(
 | `fieldMetadataUniversalIdentifier` | `string` | The `universalIdentifier` of the file-type field on your object |

 Key points:
- The `uploadFile` method is available on `MetadataApiClient` because the upload mutation is resolved by the `/metadata` endpoint.
+- The method sends the file to the **metadata endpoint** (not the main GraphQL endpoint), where the upload mutation is resolved.
 - It uses the field's `universalIdentifier` (not its workspace-specific ID), so your upload code works across any workspace where your app is installed — consistent with how apps reference fields everywhere else.
 - The returned `url` is a signed URL you can use to access the uploaded file.

@@ -11,7 +11,7 @@ title: كائنات مخصصة
 ## مخطط على مستوى عالي

 <div style={{textAlign: 'center'}}>
-    <img src="/images/docs/server/custom-object-schema.png" alt="مخطط على مستوى عالي" />
+  <img src="/images/docs/server/custom-object-schema.png" alt="مخطط على مستوى عالي" />
 </div>

 <br />
@@ -27,7 +27,7 @@ title: كائنات مخصصة
 لإضافة كائن مخصص، سيقوم عضو مساحة العمل بالاستعلام عن واجهة برمجة التطبيقات /metadata. يقوم هذا بتحديث البيانات الوصفية وفقًا لذلك ويحسب مخطط GraphQL استنادًا إلى البيانات الوصفية، ويخزنها في ذاكرة GQL للاستخدام لاحقًا.

 <div style={{textAlign: 'center'}}>
-    <img src="/images/docs/server/add-custom-objects.jpeg" alt="استعلام واجهة برمجة التطبيقات /metadata لإضافة الكائنات المخصصة" />
+  <img src="/images/docs/server/add-custom-objects.jpeg" alt="استعلام واجهة برمجة التطبيقات /metadata لإضافة الكائنات المخصصة" />
 </div>

 <br />
@@ -35,5 +35,5 @@ title: كائنات مخصصة
 لجلب البيانات، تتضمن العملية إجراء استعلامات من خلال نقطة النهاية /graphql وتمريرها من خلال محلل الاستعلام.

 <div style={{textAlign: 'center'}}>
-    <img src="/images/docs/server/custom-object-schema.png" alt="استعلام نقطة النهاية /graphql لجلب البيانات" />
+  <img src="/images/docs/server/custom-object-schema.png" alt="استعلام نقطة النهاية /graphql لجلب البيانات" />
 </div>
@@ -60,11 +60,9 @@ npx nx run twenty-server:command workspace:sync-metadata -f
 ```

 <Warning>
+  سيؤدي هذا إلى إسقاط قاعدة البيانات وإعادة تشغيل الهجرات والبذور.

-سيؤدي هذا إلى إسقاط قاعدة البيانات وإعادة تشغيل الهجرات والبذور.
-
-تأكد من عمل نسخة احتياطية لأي بيانات تريد الاحتفاظ بها قبل تشغيل هذا الأمر.
-
+  تأكد من عمل نسخة احتياطية لأي بيانات تريد الاحتفاظ بها قبل تشغيل هذا الأمر.
 </Warning>

 ## "التقنية المستخدمة"
@@ -43,9 +43,7 @@ cp .env.example .env
 ## التطوير

 <Warning>
-
-تأكد من تشغيل `yarn build` قبل أي أمر `zapier`.
-
+  تأكد من تشغيل `yarn build` قبل أي أمر `zapier`.
 </Warning>

 ### تجربة
@@ -6,29 +6,24 @@ title: أفضل الممارسات

 ## إدارة الحالة

-تقوم React و Jotai بإدارة الحالة في قاعدة الشيفرة.
+تقوم React و Recoil بإدارة الحالة في قاعدة الشيفرة.

-### استخدم `useAtomState` لتخزين الحالة
+### استخدم `useRecoilState` لتخزين الحالة

 من الجيد إنشاء أكبر عدد ممكن من الذرات لتخزين الحالة الخاصة بك.

 <Warning>
-
-من الأفضل استخدام ذرات إضافية بدلاً من محاولة أن تكون مقتضبًا باستخدام تمرير الخصائص.
-
+  من الأفضل استخدام ذرات إضافية بدلاً من محاولة أن تكون مقتضبًا باستخدام تمرير الخصائص.
 </Warning>

 ```tsx
-import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
-import { useAtomState } from '@/ui/utilities/state/jotai/hooks/useAtomState';
-
-export const myAtomState = createAtomState<string>({
+export const myAtomState = atom({
  key: 'myAtomState',
-  defaultValue: 'default value',
+  default: 'default value',
 });

 export const MyComponent = () => {
-  const [myAtom, setMyAtom] = useAtomState(myAtomState);
+  const [myAtom, setMyAtom] = useRecoilState(myAtomState);

  return (
    <div>
@@ -45,7 +40,7 @@ export const MyComponent = () => {

 تجنب استخدام `useRef` لتخزين الحالة.

-If you want to store state, you should use `useState` or `useAtomState`.
+If you want to store state, you should use `useState` or `useRecoilState`.

 انظر [كيفية إدارة إعادة العرض](#managing-re-renders) إذا شعرت أنك بحاجة إلى `useRef` لمنع بعض إعادة العرض من الحدوث.

@@ -85,8 +80,8 @@ If you feel like you need to add a `useEffect` in your root component, you shoul
 // ❌ سيّئ، سيتسبب في إعادة التصيير حتى إذا لم تتغير البيانات،
 //    لأن useEffect يحتاج إلى إعادة التقييم
 export const PageComponent = () => {
-  const [data, setData] = useAtomState(dataState);
-  const [someDependency] = useAtomState(someDependencyState);
+  const [data, setData] = useRecoilState(dataState);
+  const [someDependency] = useRecoilState(someDependencyState);

  useEffect(() => {
    if(someDependency !== data) {
@@ -98,7 +93,9 @@ export const PageComponent = () => {
 };

 export const App = () => (
-  <PageComponent />
+  <RecoilRoot>
+    <PageComponent />
+  </RecoilRoot>
 );
 ```

@@ -106,14 +103,14 @@ export const App = () => (
 // ✅ جيّد، لن يتسبب في إعادة التصيير إذا لم تتغير البيانات،
 //   لأن useEffect يُعاد تقييمه في مكوّن شقيق آخر
 export const PageComponent = () => {
-  const [data, setData] = useAtomState(dataState);
+  const [data, setData] = useRecoilState(dataState);

  return <div>{data}</div>;
 };

 export const PageData = () => {
-  const [data, setData] = useAtomState(dataState);
-  const [someDependency] = useAtomState(someDependencyState);
+  const [data, setData] = useRecoilState(dataState);
+  const [someDependency] = useRecoilState(someDependencyState);

  useEffect(() => {
    if(someDependency !== data) {
@@ -125,16 +122,16 @@ export const PageData = () => {
 };

 export const App = () => (
-  <>
+  <RecoilRoot>
    <PageData />
    <PageComponent />
-  </>
+  </RecoilRoot>
 );
 ```

-### استخدم حالات عائلة Jotai ومحددات عائلة Jotai
+### استخدم حالات عائلة Recoil ومحددات عائلة Recoil

-حالات عائلة Jotai والمحددات تعتبر طريقة رائعة لتجنب إعادة العرض.
+حالات عائلة Recoil والمحددات تعتبر طريقة رائعة لتجنب إعادة العرض.

 إنها مفيدة عندما تحتاج إلى تخزين قائمة من العناصر.

@@ -82,9 +82,9 @@ module1

 ### الحالات

-تشمل منطق إدارة الحالة. [Jotai](https://jotai.org) يتولّى ذلك.
+تشمل منطق إدارة الحالة. [RecoilJS](https://recoiljs.org) يتولّى ذلك.

-* المحددات: الذرات المشتقة (باستخدام `createAtomSelector`) تحسب القيم من ذرات أخرى ويتم تخزينها تلقائيًا.
+* المحددات: انظر [RecoilJS Selectors](https://recoiljs.org/docs/basic-tutorial/selectors) لمزيد من التفاصيل.

 لا تزال إدارة الحالة المدمجة في React تتولّى الحالة داخل المكوّن.

@@ -49,7 +49,7 @@ title: أوامر الواجهة الأمامية
 * "[React](https://react.dev/)"
 * "[Apollo](https://www.apollographql.com/docs/)"
 * "[GraphQL Codegen](https://the-guild.dev/graphql/codegen)"
-* "[Jotai](https://jotai.org/)"
+* "[Recoil](https://recoiljs.org/docs/introduction/core-concepts)"
 * "[TypeScript](https://www.typescriptlang.org/)"

 **الاختبار**
@@ -73,7 +73,7 @@ To avoid unnecessary [re-renders](/l/ar/developers/contribute/capabilities/front

 ### "إدارة الحالة"

-"[Jotai](https://jotai.org/) يتعامل مع إدارة الحالة."
+"[Recoil](https://recoiljs.org/docs/introduction/core-concepts) يتعامل مع إدارة الحالة."

 "راجع [أفضل الممارسات](/l/ar/developers/contribute/capabilities/frontend-development/best-practices-front#state-management) لمزيد من المعلومات حول إدارة الحالة."

@@ -160,7 +160,7 @@ export enum PageHotkeyScope {
 }
 ```

-داخليًا، يتم تخزين النطاق المحدد حاليًا في حالة Jotai مشتركة عبر التطبيق:
+داخليًا، يتم تخزين النطاق المحدد حاليًا في حالة Recoil مشتركة عبر التطبيق:

 ```tsx
 export const currentHotkeyScopeState = createState<HotkeyScope>({
@@ -169,10 +169,10 @@ export const currentHotkeyScopeState = createState<HotkeyScope>({
 });
 ```

-لكن لا يجب التعامل مع هذه الحالة Jotai يدويًا! سنرى كيف يمكن استخدامها في القسم التالي.
+لكن لا يجب التعامل مع هذه الحالة Recoil يدويًا! سنرى كيف يمكن استخدامها في القسم التالي.

 ## كيف يعمل داخليًا؟

 قمنا بإنشاء غلاف رقيق فوق [react-hotkeys-hook](https://react-hotkeys-hook.vercel.app/docs/intro) والذي يجعله أكثر كفاءة ويتجنب عمليات إعادة التقديم غير الضرورية.

-ونقوم أيضًا بإنشاء حالة Jotai للتعامل مع حالة نطاق المفتاح وجعلها متاحة في جميع أنحاء التطبيق.
+ونقوم أيضًا بإنشاء حالة Recoil للتعامل مع حالة نطاق المفتاح وجعلها متاحة في جميع أنحاء التطبيق.
@@ -13,9 +13,7 @@ info: تعرّف على كيفية التعاون باستخدام Figma الخ
   تتوفر المميزات الرئيسية فقط للمستخدمين الذين قاموا بتسجيل الدخول، مثل وضع المطور والقدرة على اختيار إطار مخصص.

 <Warning>
-
-لن تتمكن من التعاون بفعالية بدون حساب.
-
+  لن تتمكن من التعاون بفعالية بدون حساب.
 </Warning>

 ## هيكل فيجما
@@ -6,66 +6,66 @@ description: الدليل للمساهمين (أو المطورين الفضول
 ## المتطلبات الأساسية

 <Tabs>
-<Tab title="Linux و MacOS">
+  <Tab title="Linux و MacOS">
+    قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:

-قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:
-* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
-* [Node v24.5.0](https://nodejs.org/en/download)
-* [yarn v4](https://yarnpkg.com/getting-started/install)
-* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)
+    * [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+    * [Node v24.5.0](https://nodejs.org/en/download)
+    * [yarn v4](https://yarnpkg.com/getting-started/install)
+    * [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)

-<Warning>
-لن يعمل `npm` ، يجب عليك استخدام `yarn` بدلًا من ذلك. يأتي Yarn الآن مع Node.js، لذا لست بحاجة إلى تثبيته بشكل منفصل.
-عليك فقط تشغيل `corepack enable` لتفعيل Yarn إذا لم تقم بذلك بعد.
-</Warning>
+    <Warning>
+      لن يعمل `npm` ، يجب عليك استخدام `yarn` بدلًا من ذلك. يأتي Yarn الآن مع Node.js، لذا لست بحاجة إلى تثبيته بشكل منفصل.
+      عليك فقط تشغيل `corepack enable` لتفعيل Yarn إذا لم تقم بذلك بعد.
+    </Warning>
+  </Tab>

-</Tab>
+  <Tab title="ويندوز (WSL)">
+    1. ثبّت WSL
+       افتح PowerShell كمسؤول ثم نفّذ:

-<Tab title="ويندوز (WSL)">
+    ```powershell
+    wsl --install
+    ```

-1. ثبّت WSL
-   افتح PowerShell كمسؤول ثم نفّذ:
-```powershell
-wsl --install
-```
-يجب أن ترى الآن مطالبة لإعادة تشغيل جهاز الكمبيوتر الخاص بك. إذا لم يكن كذلك، فأعد تشغيله يدويًا.
+    يجب أن ترى الآن مطالبة لإعادة تشغيل جهاز الكمبيوتر الخاص بك. إذا لم يكن كذلك، فأعد تشغيله يدويًا.

-عند إعادة التشغيل، ستُفتح نافذة PowerShell وسيتم تثبيت Ubuntu. قد يستغرق هذا وقتًا طويلاً.
-سترى مطالبة لإنشاء اسم المستخدم وكلمة المرور لتثبيت Ubuntu الخاص بك.
+    عند إعادة التشغيل، ستُفتح نافذة PowerShell وسيتم تثبيت Ubuntu. قد يستغرق هذا وقتًا طويلاً.
+    سترى مطالبة لإنشاء اسم المستخدم وكلمة المرور لتثبيت Ubuntu الخاص بك.

-2. تثبيت وإعداد git
+    2. تثبيت وإعداد git

-```bash
-sudo apt-get install git
+    ```bash
+    sudo apt-get install git

-git config --global user.name "Your Name"
+    git config --global user.name "Your Name"

-git config --global user.email "youremail@domain.com"
-```
+    git config --global user.email "youremail@domain.com"
+    ```

-3. تثبيت nvm و node.js و yarn
+    3. تثبيت nvm و node.js و yarn

-<Warning>
-استخدم `nvm` لتثبيت نسخة `node` الصحيحة. الملف `.nvmrc` يضمن استخدام جميع المشاركين لنفس النسخة.
-</Warning>
+    <Warning>
+      استخدم `nvm` لتثبيت نسخة `node` الصحيحة. الملف `.nvmrc` يضمن استخدام جميع المشاركين لنفس النسخة.
+    </Warning>

-```bash
-sudo apt-get install curl
+    ```bash
+    sudo apt-get install curl

-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
-```
-أغلق وأعد فتح برنامجك الطرفي لاستخدام nvm. ثم قم بتشغيل الأوامر التالية.
+    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
+    ```

-```bash
+    أغلق وأعد فتح برنامجك الطرفي لاستخدام nvm. ثم قم بتشغيل الأوامر التالية.

-nvm install # يثبت إصدار node الموصى به
+    ```bash

-nvm use # استخدم إصدار node الموصى به
+    nvm install # يثبت إصدار node الموصى به

-corepack enable
-```
+    nvm use # استخدم إصدار node الموصى به

-</Tab>
+    corepack enable
+    ```
+  </Tab>
 </Tabs>

 ---
@@ -75,19 +75,19 @@ corepack enable
 في الطرفية الخاصة بك، قم بتشغيل الأمر التالي.

 <Tabs>
-<Tab title="SSH (موصى به)">
-إذا لم تكن قد أعددت مفاتيح SSH بالفعل، يمكنك معرفة كيفية القيام بذلك [هنا](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
-```bash
-git clone git@github.com:twentyhq/twenty.git
-```
-</Tab>
-<Tab title="HTTPS">
+  <Tab title="SSH (موصى به)">
+    إذا لم تكن قد أعددت مفاتيح SSH بالفعل، يمكنك معرفة كيفية القيام بذلك [هنا](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).

-```bash
-git clone https://github.com/twentyhq/twenty.git
-```
+    ```bash
+    git clone git@github.com:twentyhq/twenty.git
+    ```
+  </Tab>

-</Tab>
+  <Tab title="HTTPS">
+    ```bash
+    git clone https://github.com/twentyhq/twenty.git
+    ```
+  </Tab>
 </Tabs>

 ## الخطوة 2: انتقل إلى جذر المشروع
@@ -104,16 +104,20 @@ cd twenty
  <Tab title="Linux">
    **الخيار 1 (المفضل):** لتوفير قاعدة بياناتك محليًا:
    استخدم الرابط التالي لتثبيت Postgresql على جهاز Linux الخاص بك: [تثبيت Postgresql](https://www.postgresql.org/download/linux/)
+
    ```bash
      psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
    ```
+
    ملاحظة: قد تحتاج إلى إضافة `sudo -u postgres` إلى الأمر قبل `psql` لتجنب أخطاء الإذن.

    **الخيار 2:** إذا كنت قد قمت بتثبيت docker:
+
    ```bash
      make -C packages/twenty-docker postgres-on-docker
    ```
  </Tab>
+
  <Tab title="نظام Mac OS">
    **الخيار 1 (المفضل):** لتوفير قاعدة بياناتك محليًا مع `brew`:

@@ -125,6 +129,7 @@ cd twenty
    ```

    يمكنك التحقق مما إذا كان خادم PostgreSQL يعمل بتنفيذ:
+
    ```bash
    brew services list
    ```
@@ -133,6 +138,7 @@ cd twenty
    عبر Homebrew على MacOS. بدلاً من ذلك، فإنه ينشئ دور PostgreSQL يطابق
    اسم المستخدم الخاص بك في MacOS (مثل "john").
    للتحقق وإنشاء المستخدم `postgres` إذا لزم الأمر، اتبع هذه الخطوات:
+
    ```bash
    # قم بالاتصال بPostgreSQL
    psql postgres
@@ -141,48 +147,59 @@ cd twenty
    ```

    بمجرد أن تكون عند مطالبة psql (postgres=#)، قم بتشغيل:
-     ```bash
-     # قائمة الأدوار الموجودة في PostgreSQL
-     \du
-     ```
+
+    ```bash
+    # قائمة الأدوار الموجودة في PostgreSQL
+    \du
+    ```
+
    سترى مخرجات مشابهة ل:
-     ```bash
-     اسم الأدوار | الخصائص | عضو في
-     -----------+-------------+-----------
-     john | مشرف نظام | {}
-     ```
+
+    ```bash
+    اسم الأدوار | الخصائص | عضو في
+    -----------+-------------+-----------
+    john | مشرف نظام | {}
+    ```

    إذا لم ترَ دور `postgres` مدرجًا، انتقل إلى الخطوة التالية.
    قم بإنشاء دور `postgres` يدويًا:
-     ```bash
-     CREATE ROLE postgres WITH SUPERUSER LOGIN;
-     ```
+
+    ```bash
+    CREATE ROLE postgres WITH SUPERUSER LOGIN;
+    ```
+
    يقوم هذا بإنشاء دور مشرف نظام باسم `postgres` مع إمكانية تسجيل الدخول.
-      ```bash
-      اسم الدور | الخصائص  | عضو في
-      -----------+-------------+-----------
-      postgres  | مشرف نظام   | {}
-      john      | مشرف نظام   | {}
-      ```
+
+    ```bash
+    اسم الدور | الخصائص  | عضو في
+    -----------+-------------+-----------
+    postgres  | مشرف نظام   | {}
+    john      | مشرف نظام   | {}
+    ```

    **الخيار 2:** إذا كنت قد قمت بتثبيت docker:
+
    ```bash
      make -C packages/twenty-docker postgres-on-docker
    ```
  </Tab>
+
  <Tab title="ويندوز (WSL)">
    يجب أن تُنفذ جميع الخطوات التالية في تيرمينال WSL (داخل جهازك الافتراضي)

    **الخيار 1:** لتوفير قاعدة بيانات Postgresql الخاصة بك محليًا:
    استخدم الرابط التالي لتثبيت Postgresql على جهاز Linux الافتراضي الخاص بك: [تثبيت Postgresql](https://www.postgresql.org/download/linux/)
+
    ```bash
      psql postgres -c "CREATE DATABASE \"default\";" -c "CREATE DATABASE test;"
    ```
+
    ملاحظة: قد تحتاج إلى إضافة `sudo -u postgres` إلى الأمر قبل `psql` لتجنب أخطاء الإذن.

    **الخيار 2:** إذا كنت قد قمت بتثبيت docker:
    تشغيل Docker على WSL يضيف طبقة إضافية من التعقيد.
    استخدم هذا الخيار فقط إذا كنت مرتاحًا مع الخطوات الإضافية المتضمنة، بما في ذلك تشغيل [Docker Desktop WSL2](https://docs.docker.com/desktop/wsl).
+
    ```bash
      make -C packages/twenty-docker postgres-on-docker
    ```
@@ -201,28 +218,35 @@ cd twenty
    استخدم الرابط التالي لتثبيت Redis على جهاز Linux: [تثبيت Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)

    **الخيار 2:** إذا كنت قد قمت بتثبيت docker:
+
    ```bash
      make -C packages/twenty-docker redis-on-docker
    ```
  </Tab>
+
  <Tab title="Mac OS">
    **الخيار 1 (المفضل):** لتوفير Redis الخاص بك محليًا مع `brew`:
+
    ```bash
    brew install redis
    ```
+
    ابدأ خادم redis الخاص بك:
    `brew services start redis`

    **الخيار 2:** إذا كنت قد قمت بتثبيت docker:
+
    ```bash
      make -C packages/twenty-docker redis-on-docker
    ```
  </Tab>
+
  <Tab title="ويندوز (WSL)">
    **الخيار 1:** لتوفير Redis الخاص بك محليًا:
    استخدم الرابط التالي لتثبيت Redis على جهاز Linux الافتراضي الخاص بك: [تثبيت Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-linux/)

    **الخيار 2:** إذا كنت قد قمت بتثبيت docker:
+
    ```bash
      make -C packages/twenty-docker redis-on-docker
    ```
@@ -243,7 +267,7 @@ cp ./packages/twenty-server/.env.example ./packages/twenty-server/.env
 ```

 <Info>
-**وضع تعدد مساحات العمل:** بشكل افتراضي، يعمل Twenty في وضع مساحة عمل واحدة حيث يمكن إنشاء مساحة عمل واحدة فقط. لتمكين دعم تعدد مساحات العمل (مفيد لاختبار الميزات المعتمدة على النطاقات الفرعية)، عيّن `IS_MULTIWORKSPACE_ENABLED=true` في ملف الخادم `.env`. راجع [وضع تعدد مساحات العمل](/l/ar/developers/self-host/capabilities/setup#multi-workspace-mode) للحصول على التفاصيل.
+  **وضع تعدد مساحات العمل:** بشكل افتراضي، يعمل Twenty في وضع مساحة عمل واحدة حيث يمكن إنشاء مساحة عمل واحدة فقط. لتمكين دعم تعدد مساحات العمل (مفيد لاختبار الميزات المعتمدة على النطاقات الفرعية)، عيّن `IS_MULTIWORKSPACE_ENABLED=true` في ملف الخادم `.env`. راجع [وضع تعدد مساحات العمل](/l/ar/developers/self-host/capabilities/setup#multi-workspace-mode) للحصول على التفاصيل.
 </Info>

 ## الخطوة 6: تثبيت التبعيات
@@ -263,12 +287,15 @@ yarn
    اعتمادًا على توزيعة Linux الخاصة بك، قد يتم بدء خادم Redis تلقائيًا.
    إذا لم يكن كذلك، تحقق من [دليل تثبيت Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) لتوزيعتك.
  </Tab>
+
  <Tab title="نظام Mac OS">
-  من المفترض أن يكون Redis قد تم تشغيله بالفعل. إذا لم يكن كذلك، قم بتشغيل:
+    من المفترض أن يكون Redis قد تم تشغيله بالفعل. إذا لم يكن كذلك، قم بتشغيل:
+
    ```bash
    brew services start redis
    ```
  </Tab>
+
  <Tab title="ويندوز (WSL)">
    اعتمادًا على توزيعة Linux الخاصة بك، قد يتم بدء خادم Redis تلقائيًا.
    إذا لم يكن كذلك، تحقق من [دليل تثبيت ريديس](https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/) لتوزيعتك.
@@ -25,6 +25,7 @@ Twenty مفتوح المصدر ويرحب بمساهمات المجتمع. سو
  <Card title="تقارير الأخطاء والطلبات" icon="bug" href="/l/ar/developers/contribute/capabilities/bug-and-requests">
    أبلغ عن المشكلات أو اطلب ميزات
  </Card>
+
  <Card title="تطوير الواجهة الأمامية" icon="browser" href="/l/ar/developers/contribute/capabilities/frontend-development">
    ساهم في واجهة المستخدم
  </Card>
@@ -17,7 +17,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
 * **وثائق مخصصة**: يتم إنشاؤها خصيصًا لنموذج بيانات مساحة عملك

 <Note>
-وثائق واجهة برمجة التطبيقات المخصصة لك متاحة ضمن **الإعدادات → API & Webhooks** بعد إنشاء مفتاح API. نظرًا لأن Twenty تُنشئ واجهات برمجة تطبيقات تتطابق مع نموذج البيانات المخصص لديك، فإن الوثائق فريدة لمساحة عملك.
+  وثائق واجهة برمجة التطبيقات المخصصة لك متاحة ضمن **الإعدادات → API & Webhooks** بعد إنشاء مفتاح API. نظرًا لأن Twenty تُنشئ واجهات برمجة تطبيقات تتطابق مع نموذج البيانات المخصص لديك، فإن الوثائق فريدة لمساحة عملك.
 </Note>

 ## نوعا واجهات برمجة التطبيقات
@@ -81,7 +81,7 @@ Authorization: Bearer YOUR_API_KEY
 <VimeoEmbed videoId="928786722" title="إنشاء مفتاح API" />

 <Warning>
-يمنح مفتاح API الخاص بك الوصول إلى بيانات حساسة. لا تشاركه مع خدمات غير موثوقة. إذا تم اختراقه، عطّلْه فوراً وأنشئ مفتاحاً جديداً.
+  يمنح مفتاح API الخاص بك الوصول إلى بيانات حساسة. لا تشاركه مع خدمات غير موثوقة. إذا تم اختراقه، عطّلْه فوراً وأنشئ مفتاحاً جديداً.
 </Warning>

 ### تعيين دور لمفتاح API
@@ -143,5 +143,5 @@ Authorization: Bearer YOUR_API_KEY
 | **حجم الدفعة** | 60 سجل لكل استدعاء     |

 <Tip>
-استخدم عمليات الدفعات لزيادة الإنتاجية — عالج ما يصل إلى 60 سجلًا في استدعاء API واحد بدلاً من إجراء طلبات فردية.
+  استخدم عمليات الدفعات لزيادة الإنتاجية — عالج ما يصل إلى 60 سجلًا في استدعاء API واحد بدلاً من إجراء طلبات فردية.
 </Tip>
@@ -4,7 +4,7 @@ description: أنشئ وأدِر تخصيصات Twenty على هيئة كود.
 ---

 <Warning>
-التطبيقات حاليًا في مرحلة الاختبار الألفا. الميزة تعمل لكنها لا تزال قيد التطور.
+  التطبيقات حاليًا في مرحلة الاختبار الألفا. الميزة تعمل لكنها لا تزال قيد التطور.
 </Warning>

 ## ما هي التطبيقات؟
@@ -32,6 +32,13 @@ description: أنشئ وأدِر تخصيصات Twenty على هيئة كود.
 npx create-twenty-app@latest my-twenty-app
 cd my-twenty-app

+# إذا كنت لا تستخدم yarn@4
+corepack enable
+yarn install
+
+# قم بالمصادقة باستخدام مفتاح واجهة برمجة التطبيقات الخاص بك (سيُطلب منك ذلك)
+yarn twenty auth:login
+
 # ابدأ وضع التطوير: يُزامن التغييرات المحلية تلقائيًا مع مساحة العمل الخاصة بك
 yarn twenty app:dev
 ```
@@ -147,7 +154,7 @@ my-twenty-app/
 | `defineSkill()`              | تعريفات مهارات وكيل الذكاء الاصطناعي |

 <Note>
-**تسمية الملفات مرنة.** يعتمد اكتشاف الكيانات على بنية الشجرة المجردة (AST) — إذ يقوم SDK بفحص ملفات المصدر لديك بحثًا عن النمط `export default define<Entity>({...})`. يمكنك تنظيم ملفاتك ومجلداتك كيفما تشاء. التجميع حسب نوع الكيان (مثلًا، `logic-functions/` و`roles/`) هو مجرد عرف لتنظيم الشيفرة، وليس مطلبًا إلزاميًا.
+  **تسمية الملفات مرنة.** يعتمد اكتشاف الكيانات على بنية الشجرة المجردة (AST) — إذ يقوم SDK بفحص ملفات المصدر لديك بحثًا عن النمط `export default define<Entity>({...})`. يمكنك تنظيم ملفاتك ومجلداتك كيفما تشاء. التجميع حسب نوع الكيان (مثلًا، `logic-functions/` و`roles/`) هو مجرد عرف لتنظيم الشيفرة، وليس مطلبًا إلزاميًا.
 </Note>

 مثال على كيان تم اكتشافه:
@@ -165,7 +172,7 @@ export default defineObject({

 ستضيف الأوامر اللاحقة مزيدًا من الملفات والمجلدات:

-* سيقوم `yarn twenty app:dev` بتوليد عميلين API مضبوطي الأنواع تلقائيًا في `node_modules/twenty-sdk/generated`: `CoreApiClient` (لبيانات مساحة العمل عبر `/graphql`) و`MetadataApiClient` (لتكوين مساحة العمل وتحميل الملفات عبر `/metadata`).
+* `yarn twenty app:dev` سيولّد تلقائيًا عميل API مضبوط الأنواع في `node_modules/twenty-sdk/generated` (عميل Twenty مضبوط الأنواع + أنواع مساحة العمل).
 * `yarn twenty entity:add` سيضيف ملفات تعريف الكيانات ضمن `src/` لكائناتك المخصّصة، والوظائف، ومكوّنات الواجهة الأمامية، والأدوار، والمهارات، وغير ذلك.

 ## المصادقة
@@ -305,11 +312,11 @@ export default defineObject({
 * يمكنك إنشاء كائنات جديدة باستخدام `yarn twenty entity:add`، والذي يرشدك خلال التسمية والحقول والعلاقات.

 <Note>
-**يتم إنشاء الحقول الأساسية تلقائيًا.** عند تعريف كائن مخصص، يضيف Twenty تلقائيًا حقولًا قياسية
-مثل `id` و`name` و`createdAt` و`updatedAt` و`createdBy` و`updatedBy` و`deletedAt`.
-لا تحتاج إلى تعريف هذه في مصفوفة `fields` — أضف فقط حقولك المخصصة.
-يمكنك تجاوز الحقول الافتراضية من خلال تعريف حقل بالاسم نفسه في مصفوفة `fields` الخاصة بك،
-لكن هذا غير مستحسن.
+  **يتم إنشاء الحقول الأساسية تلقائيًا.** عند تعريف كائن مخصص، يضيف Twenty تلقائيًا حقولًا قياسية
+  مثل `id` و`name` و`createdAt` و`updatedAt` و`createdBy` و`updatedBy` و`deletedAt`.
+  لا تحتاج إلى تعريف هذه في مصفوفة `fields` — أضف فقط حقولك المخصصة.
+  يمكنك تجاوز الحقول الافتراضية من خلال تعريف حقل بالاسم نفسه في مصفوفة `fields` الخاصة بك،
+  لكن هذا غير مستحسن.
 </Note>

 ### تكوين التطبيق (application-config.ts)
@@ -426,10 +433,10 @@ export default defineRole({
 // src/app/createPostCard.logic-function.ts
 import { defineLogicFunction } from 'twenty-sdk';
 import type { DatabaseEventPayload, ObjectRecordCreateEvent, CronPayload, RoutePayload } from 'twenty-sdk';
-import { CoreApiClient, type Person } from 'twenty-sdk/generated';
+import Twenty, { type Person } from '~/generated';

 const handler = async (params: RoutePayload) => {
-  const client = new CoreApiClient();
+  const client = new Twenty(); // generated typed client
  const name = 'name' in params.queryStringParameters
    ? params.queryStringParameters.name ?? process.env.DEFAULT_RECIPIENT_NAME ?? 'Hello world'
    : 'Hello world';
@@ -543,25 +550,27 @@ yarn twenty function:execute --postInstall
 ### حمولة مشغل المسار

 <Warning>
-**تغيير غير متوافق (v1.16، يناير 2026):** لقد تغير تنسيق حمولة مشغل المسار. قبل v1.16، كانت معلمات الاستعلام، ومعلمات المسار، وجسم الطلب تُرسل مباشرةً كحمولة. بدءًا من v1.16، أصبحت متداخلة داخل كائن منظَّم `RoutePayload`.
+  **تغيير غير متوافق (v1.16، يناير 2026):** لقد تغير تنسيق حمولة مشغل المسار. قبل v1.16، كانت معلمات الاستعلام، ومعلمات المسار، وجسم الطلب تُرسل مباشرةً كحمولة. بدءًا من v1.16، أصبحت متداخلة داخل كائن منظَّم `RoutePayload`.

-**قبل v1.16:**
-```typescript
-const handler = async (params) => {
-  const { param1, param2 } = params; // Direct access
-};
-```
+  **قبل v1.16:**

-**بعد v1.16:**
-```typescript
-const handler = async (event: RoutePayload) => {
-  const { param1, param2 } = event.body; // Access via .body
-  const { queryParam } = event.queryStringParameters;
-  const { id } = event.pathParameters;
-};
-```
+  ```typescript
+  const handler = async (params) => {
+    const { param1, param2 } = params; // Direct access
+  };
+  ```

-**لترحيل الدوال الحالية:** حدّث المعالج لديك لفكّ البنية من `event.body` أو `event.queryStringParameters` أو `event.pathParameters` بدلاً من القراءة مباشرةً من كائن params.
+  **بعد v1.16:**
+
+  ```typescript
+  const handler = async (event: RoutePayload) => {
+    const { param1, param2 } = event.body; // Access via .body
+    const { queryParam } = event.queryStringParameters;
+    const { id } = event.pathParameters;
+  };
+  ```
+
+  **لترحيل الدوال الحالية:** حدّث المعالج لديك لفكّ البنية من `event.body` أو `event.queryStringParameters` أو `event.pathParameters` بدلاً من القراءة مباشرةً من كائن params.
 </Warning>

 عندما يستدعي مشغّل المسار وظيفتك المنطقية، يتلقى كائنًا من النوع `RoutePayload` يتبع تنسيق AWS HTTP API v2. استورد النوع من `twenty-sdk`:
@@ -644,10 +653,10 @@ const handler = async (event: RoutePayload) => {
 ```typescript
 // src/logic-functions/enrich-company.logic-function.ts
 import { defineLogicFunction } from 'twenty-sdk';
-import { CoreApiClient } from 'twenty-sdk/generated';
+import Twenty from '~/generated';

 const handler = async (params: { companyName: string; domain?: string }) => {
-  const client = new CoreApiClient();
+  const client = new Twenty();

  const result = await client.mutation({
    createTask: {
@@ -697,7 +706,7 @@ export default defineLogicFunction({
 * يمكنك دمج `isTool` مع المشغِّلات — إذ يمكن للدالة أن تكون أداة (قابلة للاستدعاء من قِبل وكلاء الذكاء الاصطناعي) وأن تُشغَّل بواسطة أحداث (cron، وأحداث قاعدة البيانات، والمسارات) في الوقت نفسه.

 <Note>
-**اكتب `description` جيدًا.** يعتمد وكلاء الذكاء الاصطناعي على حقل `description` الخاص بالدالة لتحديد وقت استخدام الأداة. كن محددًا بشأن ما تفعله الأداة ومتى ينبغي استدعاؤها.
+  **اكتب `description` جيدًا.** يعتمد وكلاء الذكاء الاصطناعي على حقل `description` الخاص بالدالة لتحديد وقت استخدام الأداة. كن محددًا بشأن ما تفعله الأداة ومتى ينبغي استدعاؤها.
 </Note>

 ### المكوّنات الأمامية
@@ -705,7 +714,7 @@ export default defineLogicFunction({
 تتيح لك المكوّنات الأمامية إنشاء مكوّنات React مخصّصة تُعرَض داخل واجهة مستخدم Twenty. استخدم `defineFrontComponent()` لتعريف مكوّنات مع تحقّق مدمج:

 ```typescript
-// src/front-components/my-widget.tsx
+// src/my-widget.front-component.tsx
 import { defineFrontComponent } from 'twenty-sdk';

 const MyWidget = () => {
@@ -728,13 +737,14 @@ export default defineFrontComponent({
 النقاط الرئيسية:

 * المكوّنات الأمامية هي مكوّنات React تُعرَض ضمن سياقات معزولة داخل Twenty.
+* استخدم لاحقة الملف `*.front-component.tsx` للاكتشاف التلقائي.
 * يشير الحقل `component` إلى مكوّن React الخاص بك.
 * يتم بناء المكوّنات ومزامنتها تلقائيًا أثناء `yarn twenty app:dev`.

 يمكنك إنشاء مكوّنات أمامية جديدة بطريقتين:

 * **مُنشأ بالقالب**: شغّل `yarn twenty entity:add` واختر خيار إضافة مكوّن أمامي جديد.
-* **Manual**: Create a new `.tsx` file and use `defineFrontComponent()`, following the same pattern.
+* **يدوي**: أنشئ ملفًا جديدًا `*.front-component.tsx` واستخدم `defineFrontComponent()`.

 ### المهارات

@@ -771,24 +781,18 @@ export default defineSkill({
 * **مُنشأ بالقالب**: شغِّل `yarn twenty entity:add` واختر خيار إضافة مهارة جديدة.
 * **يدوي**: أنشئ ملفًا جديدًا واستخدم `defineSkill()` مع اتباع النمط نفسه.

-### عملاء مُولَّدون مضبوطو الأنواع
+### عميل مُولَّد مضبوط الأنواع

-يتم توليد عميلين مضبوطي الأنواع تلقائيًا بواسطة `yarn twenty app:dev` وتخزينهما في `node_modules/twenty-sdk/generated` استنادًا إلى مخطط مساحة العمل لديك:
-
-* **`CoreApiClient`** — يُجري استعلامات إلى نقطة النهاية `/graphql` للحصول على بيانات مساحة العمل
-* **`MetadataApiClient`** — queries the `/metadata` endpoint for workspace configuration and file uploads
+يُولَّد العميل مضبوط الأنواع تلقائيًا بواسطة `yarn twenty app:dev` ويُخزَّن في `node_modules/twenty-sdk/generated` استنادًا إلى مخطط مساحة العمل لديك. استخدمه في وظائفك:

 ```typescript
-import { CoreApiClient, MetadataApiClient } from 'twenty-sdk/generated';
+import Twenty from '~/generated';

-const client = new CoreApiClient();
+const client = new Twenty();
 const { me } = await client.query({ me: { id: true, displayName: true } });
-
-const metadataClient = new MetadataApiClient();
-const { currentWorkspace } = await metadataClient.query({ currentWorkspace: { id: true } });
 ```

-Both clients are re-generated automatically by `yarn twenty app:dev` whenever your objects or fields change.
+يُعاد توليد العميل تلقائيًا بواسطة `yarn twenty app:dev` كلما تغيّرت كائناتك أو حقولك.

 #### بيانات الاعتماد وقت التشغيل في الوظائف المنطقية

@@ -805,17 +809,17 @@ Both clients are re-generated automatically by `yarn twenty app:dev` whenever yo

 #### رفع الملفات

-The generated `MetadataApiClient` includes an `uploadFile` method for attaching files to file-type fields on your workspace objects. نظرًا لأن عملاء GraphQL القياسيون لا يدعمون تحميل الملفات متعددة الأجزاء افتراضيًا، يوفر العميل هذه الطريقة المخصصة التي تطبق [مواصفة طلب GraphQL متعدد الأجزاء](https://github.com/jaydenseric/graphql-multipart-request-spec) في الخلفية.
+يتضمن العميل `Twenty` المُولَّد طريقة `uploadFile` لإرفاق الملفات بالحقول من نوع ملف ضمن كائنات مساحة العمل الخاصة بك. نظرًا لأن عملاء GraphQL القياسيون لا يدعمون تحميل الملفات متعددة الأجزاء افتراضيًا، يوفر العميل هذه الطريقة المخصصة التي تطبق [مواصفة طلب GraphQL متعدد الأجزاء](https://github.com/jaydenseric/graphql-multipart-request-spec) في الخلفية.

 ```typescript
-import { MetadataApiClient } from 'twenty-sdk/generated';
+import Twenty from '~/generated';
 import * as fs from 'fs';

-const metadataClient = new MetadataApiClient();
+const client = new Twenty();

 const fileBuffer = fs.readFileSync('./invoice.pdf');

-const uploadedFile = await metadataClient.uploadFile(
+const uploadedFile = await client.uploadFile(
  fileBuffer,                                         // file contents as a Buffer
  'invoice.pdf',                                      // filename
  'application/pdf',                                  // MIME type (defaults to 'application/octet-stream')
@@ -846,7 +850,7 @@ uploadFile(

 النقاط الرئيسية:

-* The `uploadFile` method is available on `MetadataApiClient` because the upload mutation is resolved by the `/metadata` endpoint.
+* ترسل هذه الطريقة الملف إلى **نقطة نهاية البيانات الوصفية** (وليست نقطة النهاية الرئيسية لـ GraphQL)، حيث تُنفَّذ عملية الرفع.
 * تستخدم `universalIdentifier` الخاص بالحقل (وليس المعرّف الخاص بمساحة العمل)، ليعمل كود الرفع لديك عبر أي مساحة عمل مُثبَّت فيها تطبيقك — بما يتماشى مع كيفية إشارة التطبيقات إلى الحقول في كل مكان آخر.
 * العنوان `url` المُعاد هو عنوان URL موقّع يمكنك استخدامه للوصول إلى الملف المرفوع.

@@ -62,7 +62,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
 | `الطابع الزمني` | وقت حدوث الحدث (UTC)                            |

 <Note>
-استجب بحالة **HTTP 2xx** ‏(200-299) لتأكيد الاستلام. تُسجَّل الاستجابات غير 2xx كإخفاقات في التسليم.
+  استجب بحالة **HTTP 2xx** ‏(200-299) لتأكيد الاستلام. تُسجَّل الاستجابات غير 2xx كإخفاقات في التسليم.
 </Note>

 ## التحقق من صحة خطاف الويب
@@ -23,9 +23,11 @@ description: وسّع وظائف Twenty باستخدام واجهات برمجة
  <Card title="واجهات برمجة التطبيقات" icon="كود" href="/l/ar/developers/extend/capabilities/apis">
    اتصل بـ Twenty برمجياً
  </Card>
+
  <Card title="الويب هوكس" icon="bell" href="/l/ar/developers/extend/capabilities/webhooks">
    احصل على إشعارات بالأحداث في الوقت الفعلي
  </Card>
+
  <Card title="التطبيقات" icon="puzzle-piece" href="/l/ar/developers/extend/capabilities/apps">
    أنشئ تخصيصات كرمز برمجي (ألفا)
  </Card>
@@ -3,7 +3,7 @@ title: بنقرة واحدة مع Docker Compose
 ---

 <Warning>
-الحاويات الخاصة بدوكر مخصصة للاستضافة الإنتاجية أو الاستضافة الذاتية، للتحقيق يرجى التحقق من [الإعداد المحلي](/l/ar/developers/contribute/capabilities/local-setup).
+  الحاويات الخاصة بدوكر مخصصة للاستضافة الإنتاجية أو الاستضافة الذاتية، للتحقيق يرجى التحقق من [الإعداد المحلي](/l/ar/developers/contribute/capabilities/local-setup).
 </Warning>

 ## نظرة عامة
@@ -5,7 +5,7 @@ title: إعداد
 # إدارة الإعدادات

 <Warning>
-**هل هي المرة الأولى التي تقوم فيها بالتثبيت؟** اتبع [دليل تثبيت Docker Compose](/l/ar/developers/self-host/capabilities/docker-compose) لتشغيل Twenty، ثم عد هنا للإعداد.
+  **هل هي المرة الأولى التي تقوم فيها بالتثبيت؟** اتبع [دليل تثبيت Docker Compose](/l/ar/developers/self-host/capabilities/docker-compose) لتشغيل Twenty، ثم عد هنا للإعداد.
 </Warning>

 يوفر Twenty **وضعين للإعداد** ليلائم احتياجات النشر المختلفة:
@@ -26,7 +26,7 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # افتراضي
 4. تسري التغييرات على الفور (خلال 15 ثانية لعمليات النشر متعددة الحاويات)

 <Warning>
-**نشرات متعددة الحاويات:** عند استخدام إعدادات قاعدة البيانات (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`)، يقوم كل من حاويات الخادم والعامل بالقراءة من نفس قاعدة البيانات. التغييرات في لوحة الإدارة تؤثر عليهما تلقائيًا، مما يلغي الحاجة إلى تكرار متغيرات البيئة بين الحاويات (باستثناء متغيرات البنية التحتية).
+  **نشرات متعددة الحاويات:** عند استخدام إعدادات قاعدة البيانات (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`)، يقوم كل من حاويات الخادم والعامل بالقراءة من نفس قاعدة البيانات. التغييرات في لوحة الإدارة تؤثر عليهما تلقائيًا، مما يلغي الحاجة إلى تكرار متغيرات البيئة بين الحاويات (باستثناء متغيرات البنية التحتية).
 </Warning>

 **ما يمكنك تكوينه عبر لوحة الإدارة:**
@@ -41,10 +41,10 @@ IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # افتراضي
 ![متغيرات تكوين لوحة الإدارة](/images/user-guide/setup/admin-panel-config-variables.png)

 <Warning>
-كل متغير موثق بوصف في لوحة الإدارة الخاصة بك في **الإعدادات → لوحة الإدارة → متغيرات التكوين**.
-بعض إعدادات البنية التحتية مثل اتصالات قاعدة البيانات (`PG_DATABASE_URL`)، عناوين الخوادم (`SERVER_URL`)، وأسرار التطبيقات (`APP_SECRET`) يمكن ضبطها فقط عبر ملف `.env`.
+  كل متغير موثق بوصف في لوحة الإدارة الخاصة بك في **الإعدادات → لوحة الإدارة → متغيرات التكوين**.
+  بعض إعدادات البنية التحتية مثل اتصالات قاعدة البيانات (`PG_DATABASE_URL`)، عناوين الخوادم (`SERVER_URL`)، وأسرار التطبيقات (`APP_SECRET`) يمكن ضبطها فقط عبر ملف `.env`.

-[مرجع تقني كامل →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
+  [مرجع تقني كامل →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
 </Warning>

 ## 2. إعداد بيئي فقط
@@ -93,7 +93,7 @@ DEFAULT_SUBDOMAIN=app  # default value
 * إعدادات خاصة بمساحة العمل مثل النطاق الفرعي والنطاق المخصص تصبح متاحة ضمن إعدادات مساحة العمل

 <Warning>
-**إعداد خاص بالبيئة فقط:** لا يمكن تكوين `IS_MULTIWORKSPACE_ENABLED` إلا عبر ملف `.env` ويتطلب إعادة تشغيل. لا يمكن تغييره عبر لوحة الإدارة.
+  **إعداد خاص بالبيئة فقط:** لا يمكن تكوين `IS_MULTIWORKSPACE_ENABLED` إلا عبر ملف `.env` ويتطلب إعادة تشغيل. لا يمكن تغييره عبر لوحة الإدارة.
 </Warning>

 ### تكوين DNS لوضع تعدد مساحات العمل
@@ -149,7 +149,7 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
   * `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`

 <Warning>
-**وضع بيئي فقط:** إذا كنت قد ضبطت `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`، فأضف هذه المتغيرات إلى ملف `.env` الخاص بك بدلاً من ذلك.
+  **وضع بيئي فقط:** إذا كنت قد ضبطت `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`، فأضف هذه المتغيرات إلى ملف `.env` الخاص بك بدلاً من ذلك.
 </Warning>

 **النطاقات المطلوبة** (يتم تكوينها تلقائيًا):
@@ -168,7 +168,7 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
 ## تكامل Microsoft 365

 <Warning>
-يجب على المستخدمين الحصول على [ترخيص Microsoft 365](https://admin.microsoft.com/Adminportal/Home) ليتمكنوا من استخدام تقويم API ورسائل. لن يتمكنوا من مزامنة حسابهم في Twenty دون واحد منها.
+  يجب على المستخدمين الحصول على [ترخيص Microsoft 365](https://admin.microsoft.com/Adminportal/Home) ليتمكنوا من استخدام تقويم API ورسائل. لن يتمكنوا من مزامنة حسابهم في Twenty دون واحد منها.
 </Warning>

 ### إنشاء مشروع في Microsoft Azure
@@ -211,7 +211,7 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
   * `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`

 <Warning>
-**وضع بيئي فقط:** إذا كنت قد ضبطت `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`، فأضف هذه المتغيرات إلى ملف `.env` الخاص بك بدلاً من ذلك.
+  **وضع بيئي فقط:** إذا كنت قد ضبطت `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`، فأضف هذه المتغيرات إلى ملف `.env` الخاص بك بدلاً من ذلك.
 </Warning>

 ### تكوين النطاقات
@@ -256,45 +256,40 @@ yarn command:prod cron:workflow:automated-cron-trigger
 3. قم بضبط إعدادات SMTP الخاصة بك:

 <ArticleTabs label1="جيميل" label2="أوفيس 365" label3="Smtp4dev">
-
  <ArticleTab>
+    ستحتاج إلى توفير [كلمة مرور التطبيق](https://support.google.com/accounts/answer/185833).

-  ستحتاج إلى توفير [كلمة مرور التطبيق](https://support.google.com/accounts/answer/185833).
-  * EMAIL_DRIVER=smtp
-  * EMAIL_SMTP_HOST=smtp.gmail.com
-  * EMAIL_SMTP_PORT=465
-  * EMAIL_SMTP_USER=gmail_email_address
-  * EMAIL_SMTP_PASSWORD='gmail_app_password'
-
-  </ArticleTab>
-
-  <ArticleTab>
-
-  تذكر أنه إذا كنت تشغل التحقق بعاملين، ستحتاج إلى توفير [كلمة مرور التطبيق](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
-  * EMAIL_DRIVER=smtp
-  * EMAIL_SMTP_HOST=smtp.office365.com
-  * EMAIL_SMTP_PORT=587
-  * EMAIL_SMTP_USER=office365_email_address
-  * EMAIL_SMTP_PASSWORD='office365_password'
-
-  </ArticleTab>
-
-  <ArticleTab>
-
-  **smtp4dev** هو خادم بريد إلكتروني مزيف للتطوير والاختبار.
-  * قم بتشغيل صورة smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
-  * الوصول إلى واجهة المستخدم smtp4dev هنا: [http://localhost:8090](http://localhost:8090)
-  * حدد المتغيرات التالية:
    * EMAIL_DRIVER=smtp
-    * EMAIL_SMTP_HOST=localhost
-    * EMAIL_SMTP_PORT=2525
-
+    * EMAIL_SMTP_HOST=smtp.gmail.com
+    * EMAIL_SMTP_PORT=465
+    * EMAIL_SMTP_USER=gmail_email_address
+    * EMAIL_SMTP_PASSWORD='gmail_app_password'
  </ArticleTab>

+  <ArticleTab>
+    تذكر أنه إذا كنت تشغل التحقق بعاملين، ستحتاج إلى توفير [كلمة مرور التطبيق](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
+
+    * EMAIL_DRIVER=smtp
+    * EMAIL_SMTP_HOST=smtp.office365.com
+    * EMAIL_SMTP_PORT=587
+    * EMAIL_SMTP_USER=office365_email_address
+    * EMAIL_SMTP_PASSWORD='office365_password'
+  </ArticleTab>
+
+  <ArticleTab>
+    **smtp4dev** هو خادم بريد إلكتروني مزيف للتطوير والاختبار.
+
+    * قم بتشغيل صورة smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
+    * الوصول إلى واجهة المستخدم smtp4dev هنا: [http://localhost:8090](http://localhost:8090)
+    * حدد المتغيرات التالية:
+      * EMAIL_DRIVER=smtp
+      * EMAIL_SMTP_HOST=localhost
+      * EMAIL_SMTP_PORT=2525
+  </ArticleTab>
 </ArticleTabs>

 <Warning>
-**وضع بيئي فقط:** إذا كنت قد ضبطت `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`، فأضف هذه المتغيرات إلى ملف `.env` الخاص بك بدلاً من ذلك.
+  **وضع بيئي فقط:** إذا كنت قد ضبطت `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`، فأضف هذه المتغيرات إلى ملف `.env` الخاص بك بدلاً من ذلك.
 </Warning>

 ## الوظائف المنطقية
@@ -302,7 +297,7 @@ yarn command:prod cron:workflow:automated-cron-trigger
 تدعم Twenty الوظائف المنطقية لعمليات سير العمل والمنطق المخصص. يتم تكوين بيئة التنفيذ عبر متغير البيئة `SERVERLESS_TYPE`.

 <Warning>
-**ملاحظة أمنية:** يقوم برنامج التشغيل المحلي (`SERVERLESS_TYPE=LOCAL`) بتشغيل الشيفرة مباشرةً على المضيف ضمن عملية Node.js من دون عزل. يجب استخدامه فقط للشيفرة الموثوقة أثناء التطوير. بالنسبة لعمليات النشر الإنتاجية التي تتعامل مع شيفرة غير موثوق بها، نوصي بشدة باستخدام `SERVERLESS_TYPE=LAMBDA` أو `SERVERLESS_TYPE=DISABLED`.
+  **ملاحظة أمنية:** يقوم برنامج التشغيل المحلي (`SERVERLESS_TYPE=LOCAL`) بتشغيل الشيفرة مباشرةً على المضيف ضمن عملية Node.js من دون عزل. يجب استخدامه فقط للشيفرة الموثوقة أثناء التطوير. بالنسبة لعمليات النشر الإنتاجية التي تتعامل مع شيفرة غير موثوق بها، نوصي بشدة باستخدام `SERVERLESS_TYPE=LAMBDA` أو `SERVERLESS_TYPE=DISABLED`.
 </Warning>

 ### برامج التشغيل المتاحة
@@ -338,5 +333,5 @@ SERVERLESS_TYPE=DISABLED
 ```

 <Note>
-عند استخدام `SERVERLESS_TYPE=DISABLED`، ستؤدي أي محاولة لتنفيذ وظيفة منطقية إلى إرجاع خطأ. يكون هذا مفيدًا إذا كنت ترغب في تشغيل Twenty من دون إمكانات الوظائف المنطقية.
+  عند استخدام `SERVERLESS_TYPE=DISABLED`، ستؤدي أي محاولة لتنفيذ وظيفة منطقية إلى إرجاع خطأ. يكون هذا مفيدًا إذا كنت ترغب في تشغيل Twenty من دون إمكانات الوظائف المنطقية.
 </Note>
@@ -23,6 +23,7 @@ description: قم بنشر Twenty وإدارته على البنية التحت
  <Card title="Docker Compose" icon="docker" href="/l/ar/developers/self-host/capabilities/docker-compose">
    إعداد سريع باستخدام Docker
  </Card>
+
  <Card title="مزودو الخدمات السحابية" icon="cloud" href="/l/ar/developers/self-host/capabilities/cloud-providers">
    انشر على AWS أو GCP أو Azure
  </Card>
@@ -10,54 +10,46 @@ image: /images/user-guide/tips/light-bulb.png
 رسالة مختصرة تعرض معلومات إضافية عند تفاعل المستخدم مع عنصر.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";

-```jsx
-import { AppTooltip } from "@/ui/display/tooltip/AppTooltip";
-
-export const MyComponent = () => {
-  return (
-    <>
-      <p id="hoverText" style={{ display: "inline-block" }}>
-        رؤى العملاء
-      </p>
-      <AppTooltip
-        className
-        anchorSelect="#hoverText"
-        content="استكشاف سلوك العملاء وتفضيلاتهم"
-        delayHide={0}
-        offset={6}
-        noArrow={false}
-        isOpen={true}
-        place="bottom"
-        positionStrategy="absolute"
-      />
-    </>
-  );
-};
-```
-
-</Tab>
-
-<Tab title="المحددات">
-
-
-| المحددات           | النوع                                    | الوصف                                                                                                                                                                                |
-| ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| اسم الفئة          | نص                                       | فئة CSS اختيارية للتنسيق الإضافي                                                                                                                                                     |
-| اختيار الربط       | محدد CSS                                 | المحدِّد لمرساة التلميح (العنصر الذي يُفعّل التلميح)                                                                                                                                 |
-| المحتوى            | نص                                       | المحتوى الذي تريد عرضه داخل التلميح                                                                                                                                                  |
-| تأخير الإخفاء      | رقم                                      | التأخير بالثواني قبل إخفاء التلميح بعد مغادرة المؤشر للمرساة                                                                                                                         |
-| الإزاحة            | رقم                                      | الإزاحة بالبكسل لتحديد موضع التلميح                                                                                                                                                  |
-| بدون سهم           | قيمة منطقية                              | إذا كانت القيمة `صحيح`, سيتم إخفاء السهم في المربط التنبيهي                                                                                                                          |
-| مفتوح              | قيمة منطقية                              | إذا كانت القيمة `صحيح`, يكون المربط التنبيهي مفتوحًا افتراضيًا                                                                                                                       |
-| المكان             | نص `PlacesType` من `react-tooltip`       | يحدد موضع المربط التنبيهي. تتضمن القيم `bottom`، `left`، `right`، `top`، `top-start`، `top-end`، `right-start`، `right-end`، `bottom-start`، `bottom-end`، `left-start`، و`left-end` |
-| استراتيجية الوضعية | نص `PositionStrategy` من `react-tooltip` | استراتيجية وضعية للمربط التنبيهي. له قيمتان: `absolute` و`fixed`                                                                                                                     |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <>
+          <p id="hoverText" style={{ display: "inline-block" }}>
+            رؤى العملاء
+          </p>
+          <AppTooltip
+            className
+            anchorSelect="#hoverText"
+            content="استكشاف سلوك العملاء وتفضيلاتهم"
+            delayHide={0}
+            offset={6}
+            noArrow={false}
+            isOpen={true}
+            place="bottom"
+            positionStrategy="absolute"
+          />
+        </>
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="المحددات">
+    | المحددات           | النوع                                    | الوصف                                                                                                                                                                                |
+    | ------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+    | اسم الفئة          | نص                                       | فئة CSS اختيارية للتنسيق الإضافي                                                                                                                                                     |
+    | اختيار الربط       | محدد CSS                                 | المحدِّد لمرساة التلميح (العنصر الذي يُفعّل التلميح)                                                                                                                                 |
+    | المحتوى            | نص                                       | المحتوى الذي تريد عرضه داخل التلميح                                                                                                                                                  |
+    | تأخير الإخفاء      | رقم                                      | التأخير بالثواني قبل إخفاء التلميح بعد مغادرة المؤشر للمرساة                                                                                                                         |
+    | الإزاحة            | رقم                                      | الإزاحة بالبكسل لتحديد موضع التلميح                                                                                                                                                  |
+    | بدون سهم           | قيمة منطقية                              | إذا كانت القيمة `صحيح`, سيتم إخفاء السهم في المربط التنبيهي                                                                                                                          |
+    | مفتوح              | قيمة منطقية                              | إذا كانت القيمة `صحيح`, يكون المربط التنبيهي مفتوحًا افتراضيًا                                                                                                                       |
+    | المكان             | نص `PlacesType` من `react-tooltip`       | يحدد موضع المربط التنبيهي. تتضمن القيم `bottom`، `left`، `right`، `top`، `top-start`، `top-end`، `right-start`، `right-end`، `bottom-start`، `bottom-end`، `left-start`، و`left-end` |
+    | استراتيجية الوضعية | نص `PositionStrategy` من `react-tooltip` | استراتيجية وضعية للمربط التنبيهي. له قيمتان: `absolute` و`fixed`                                                                                                                     |
+  </Tab>
 </Tabs>

 ## نص متجاوز مع تلميح
@@ -65,30 +57,22 @@ export const MyComponent = () => {
 يعالج النص الزائد ويعرض مربط تنبيهي عند فيضان النص.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { OverflowingTextWithTooltip } from 'twenty-ui/display';

-```jsx
-import { OverflowingTextWithTooltip } from 'twenty-ui/display';
+    export const MyComponent = () => {
+      const crmTaskDescription =
+        'المتابعة مع العميل بشأن استفساره الأخير عن المنتج. مناقشة خيارات التسعير، ومعالجة أي مخاوف، وتقديم معلومات إضافية عن المنتج. تسجيل تفاصيل المحادثة في نظام إدارة علاقات العملاء (CRM) للرجوع إليها لاحقاً.';

-export const MyComponent = () => {
-  const crmTaskDescription =
-    'المتابعة مع العميل بشأن استفساره الأخير عن المنتج. مناقشة خيارات التسعير، ومعالجة أي مخاوف، وتقديم معلومات إضافية عن المنتج. تسجيل تفاصيل المحادثة في نظام إدارة علاقات العملاء (CRM) للرجوع إليها لاحقاً.';
-
-  return <OverflowingTextWithTooltip text={crmTaskDescription} />;
-};
-```
-
-</Tab>
-
-<Tab title="الخصائص">
-
-
-| الخصائص | النوع  | الوصف                                         |
-| ------- | ------ | --------------------------------------------- |
-| نص      | string | المحتوى الذي تريد عرضه في منطقة النص المتجاوز |
-
-
-
-</Tab>
+      return <OverflowingTextWithTooltip text={crmTaskDescription} />;
+    };
+    ```
+  </Tab>

+  <Tab title="الخصائص">
+    | الخصائص | النوع  | الوصف                                         |
+    | ------- | ------ | --------------------------------------------- |
+    | نص      | string | المحتوى الذي تريد عرضه في منطقة النص المتجاوز |
+  </Tab>
 </Tabs>
@@ -10,25 +10,19 @@ image: /images/user-guide/tasks/tasks_header.png
 يمثل إجراءً ناجحًا أو مكتملًا.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { Checkmark } from 'twenty-ui/display';

-```jsx
-import { Checkmark } from 'twenty-ui/display';
-
-export const MyComponent = () => {
-  return <Checkmark />;
-};
-```
-
-
-</Tab>
-
-<Tab title="المحددات">
-
-يمتد `React.ComponentPropsWithoutRef<'div'>` و يقبل جميع خصائص عنصر `div` العادي.
-
-</Tab>
+    export const MyComponent = () => {
+      return <Checkmark />;
+    };
+    ```
+  </Tab>

+  <Tab title="المحددات">
+    يمتد `React.ComponentPropsWithoutRef<'div'>` و يقبل جميع خصائص عنصر `div` العادي.
+  </Tab>
 </Tabs>

 ## علامة صحيح متحركة
@@ -36,38 +30,29 @@ export const MyComponent = () => {
 يمثل رمز علامة صحيح مع ميزة الإضافة للحركة.

 <Tabs>
+  <Tab title="استخدام">
+    ```jsx
+    import { AnimatedCheckmark } from 'twenty-ui/display';

-<Tab title="استخدام">
-
-```jsx
-import { AnimatedCheckmark } from 'twenty-ui/display';
-
-export const MyComponent = () => {
-  return (
-    <AnimatedCheckmark
-      isAnimating={true}
-      color="green"
-      duration={0.5}
-      size={30}
-    />
-  );
-};
-```
-
-</Tab>
-
-<Tab title="الخصائص">
-
-
-| الخصائص     | النوع       | الوصف                                 | الإعداد الافتراضي |
-| ----------- | ----------- | ------------------------------------- | ----------------- |
-| isAnimating | قيمة منطقية | يتحكم فيما إذا كانت علامة صحيح متحركة | خاطئ              |
-| اللون       | string      | لون علامة الاختيار                    |                   |
-| المدة       | رقم         | مدة الحركة بالثواني                   | 0.5 ثانية         |
-| الحجم       | رقم         | حجم علامة الاختيار                    | 28 بكسل           |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <AnimatedCheckmark
+          isAnimating={true}
+          color="green"
+          duration={0.5}
+          size={30}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="الخصائص">
+    | الخصائص     | النوع       | الوصف                                 | الإعداد الافتراضي |
+    | ----------- | ----------- | ------------------------------------- | ----------------- |
+    | isAnimating | قيمة منطقية | يتحكم فيما إذا كانت علامة صحيح متحركة | خاطئ              |
+    | اللون       | string      | لون علامة الاختيار                    |                   |
+    | المدة       | رقم         | مدة الحركة بالثواني                   | 0.5 ثانية         |
+    | الحجم       | رقم         | حجم علامة الاختيار                    | 28 بكسل           |
+  </Tab>
 </Tabs>
@@ -10,48 +10,40 @@ image: /images/user-guide/github/github-header.png
 عنصر مرئي يمكن استخدامه كحاوية قابلة للنقر أو غير قابلة للنقر، مع علامة وعناصر اختيارية يسار ويمين، وخيارات تصميم متنوعة لعرض العلامات والبطاقات.

 <Tabs>
+  <Tab title="استخدام">
+    ```jsx
+    import { Chip } from 'twenty-ui/components';

-<Tab title="استخدام">
+    export const MyComponent = () => {
+      return (
+        <Chip
+          size="large"
+          label="Clickable Chip"
+          clickable={true}
+          variant="highlighted"
+          accent="text-primary"
+          leftComponent
+          rightComponent
+          maxWidth="200px"
+          className
+        />
+      );
+    };

-```jsx
-import { Chip } from 'twenty-ui/components';
+    ```
+  </Tab>

-export const MyComponent = () => {
-  return (
-    <Chip
-      size="large"
-      label="Clickable Chip"
-      clickable={true}
-      variant="highlighted"
-      accent="text-primary"
-      leftComponent
-      rightComponent
-      maxWidth="200px"
-      className
-    />
-  );
-};
-
-```
-
-</Tab>
-
-<Tab title="المحددات">
-
-
-| المحددات           | النوع                   | الوصف                                                                  |
-| ------------------ | ----------------------- | ---------------------------------------------------------------------- |
-| linkToEntity       | نص                      | الرابط إلى الكيان                                                      |
-| معرف الكيان        | نص                      | المعرف الفريد للكيان                                                   |
-| الاسم              | نص                      | اسم الكيان                                                             |
-| رابط الصورة        | نص                      | s picture",                                                            |
-| نوع الصورة الرمزية | نوع الصورة الرمزية      | نوع الصورة الرمزية التي تريد عرضها. لديه خياران: `مستدير` و `مربع`     |
-| التنوع             | تعداد EntityChipVariant | تنوع الرقاقة الكيانية التي ترغب في عرضها. لديه خياران: `عادي` و `شفاف` |
-| الأيقونة اليسرى    | مكون رمز                | مكون React يمثل رمزًا. يظهر على الجانب الأيسر من الرقاقة               |
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات           | النوع                   | الوصف                                                                  |
+    | ------------------ | ----------------------- | ---------------------------------------------------------------------- |
+    | linkToEntity       | نص                      | الرابط إلى الكيان                                                      |
+    | معرف الكيان        | نص                      | المعرف الفريد للكيان                                                   |
+    | الاسم              | نص                      | اسم الكيان                                                             |
+    | رابط الصورة        | نص                      | s picture",                                                            |
+    | نوع الصورة الرمزية | نوع الصورة الرمزية      | نوع الصورة الرمزية التي تريد عرضها. لديه خياران: `مستدير` و `مربع`     |
+    | التنوع             | تعداد EntityChipVariant | تنوع الرقاقة الكيانية التي ترغب في عرضها. لديه خياران: `عادي` و `شفاف` |
+    | الأيقونة اليسرى    | مكون رمز                | مكون React يمثل رمزًا. يظهر على الجانب الأيسر من الرقاقة               |
+  </Tab>
 </Tabs>

 ## الأمثلة
@@ -108,47 +100,39 @@ export const MyComponent = () => {
 عنصر يشبه الرقاقة لعرض معلومات عن كيان.

 <Tabs>
+  <Tab title="الاستخدام">
+    ```jsx
+    import { BrowserRouter as Router } from 'react-router-dom';
+    import { IconTwentyStar } from 'twenty-ui/display';
+    import { Chip } from 'twenty-ui/components';

-<Tab title="الاستخدام">
+    export const MyComponent = () => {
+      return (
+        <Router>
+          <Chip
+            linkToEntity="/entity-link"
+            entityId="entityTest"
+            name="Entity name"
+            pictureUrl=""
+            avatarType="rounded"
+            variant="regular"
+            LeftIcon={IconTwentyStar}
+          />
+        </Router>
+      );
+    };
+    ```
+  </Tab>

-```jsx
-import { BrowserRouter as Router } from 'react-router-dom';
-import { IconTwentyStar } from 'twenty-ui/display';
-import { Chip } from 'twenty-ui/components';
-
-export const MyComponent = () => {
-  return (
-    <Router>
-      <Chip
-        linkToEntity="/entity-link"
-        entityId="entityTest"
-        name="Entity name"
-        pictureUrl=""
-        avatarType="rounded"
-        variant="regular"
-        LeftIcon={IconTwentyStar}
-      />
-    </Router>
-  );
-};
-```
-
-</Tab>
-
-<Tab title="الخصائص">
-
-
-| الخصائص            | النوع                   | الوصف                                                                  |
-| ------------------ | ----------------------- | ---------------------------------------------------------------------- |
-| linkToEntity       | نص                      | الرابط إلى الكيان                                                      |
-| معرف الكيان        | نص                      | المعرف الفريد للكيان                                                   |
-| الاسم              | نص                      | اسم الكيان                                                             |
-| رابط الصورة        | نص                      | s picture",                                                            |
-| نوع الصورة الرمزية | نوع الصورة الرمزية      | نوع الصورة الرمزية التي تريد عرضها. لديه خياران: `مستدير` و `مربع`     |
-| التنوع             | تعداد EntityChipVariant | تنوع الرقاقة الكيانية التي ترغب في عرضها. لديه خياران: `عادي` و `شفاف` |
-| الأيقونة اليسرى    | مكون رمز                | مكون React يمثل رمزًا. يظهر على الجانب الأيسر من الرقاقة               |
-
-
-
-</Tab>
+  <Tab title="الخصائص">
+    | الخصائص            | النوع                   | الوصف                                                                  |
+    | ------------------ | ----------------------- | ---------------------------------------------------------------------- |
+    | linkToEntity       | نص                      | الرابط إلى الكيان                                                      |
+    | معرف الكيان        | نص                      | المعرف الفريد للكيان                                                   |
+    | الاسم              | نص                      | اسم الكيان                                                             |
+    | رابط الصورة        | نص                      | s picture",                                                            |
+    | نوع الصورة الرمزية | نوع الصورة الرمزية      | نوع الصورة الرمزية التي تريد عرضها. لديه خياران: `مستدير` و `مربع`     |
+    | التنوع             | تعداد EntityChipVariant | تنوع الرقاقة الكيانية التي ترغب في عرضها. لديه خياران: `عادي` و `شفاف` |
+    | الأيقونة اليسرى    | مكون رمز                | مكون React يمثل رمزًا. يظهر على الجانب الأيسر من الرقاقة               |
+  </Tab>
 </Tabs>
@@ -14,44 +14,35 @@ image: /images/user-guide/objects/objects.png
 نستخدم أيقونات Tabler لـ React في جميع أنحاء التطبيق.

 <Tabs>
+  <Tab title="التثبيت">
+    <br />

-<Tab title="التثبيت">
-<br />
+    ```
+    yarn add @tabler/icons-react
+    ```
+  </Tab>

-```
-yarn add @tabler/icons-react
-```
+  <Tab title="الإزاحة">
+    يمكنك استيراد كل أيقونة كمكون. إليك مثال:

-</Tab>
+    <br />

-<Tab title="الإزاحة">
+    ```jsx
+    import { IconArrowLeft } from "@tabler/icons-react";

-يمكنك استيراد كل أيقونة كمكون. إليك مثال:
-<br />
-
-```jsx
-import { IconArrowLeft } from "@tabler/icons-react";
-
-export const MyComponent = () => {
-  return <IconArrowLeft color="red" size={48} />;
-};
-```
-
-</Tab>
-
-<Tab title="الإزاحة">
-
-
-| الإزاحة     | النوع  | الوصف                            | الإعداد الافتراضي |
-| ----------- | ------ | -------------------------------- | ----------------- |
-| الحجم       | رقم    | ارتفاع وعرض الأيقونة بالبكسل     | 24                |
-| اللون       | string | لون الأيقونات                    | اللون الحالي      |
-| الخط العريض | رقم    | عرض الخط العريض للأيقونة بالبكسل | 2                 |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return <IconArrowLeft color="red" size={48} />;
+    };
+    ```
+  </Tab>

+  <Tab title="الإزاحة">
+    | الإزاحة     | النوع  | الوصف                            | الإعداد الافتراضي |
+    | ----------- | ------ | -------------------------------- | ----------------- |
+    | الحجم       | رقم    | ارتفاع وعرض الأيقونة بالبكسل     | 24                |
+    | اللون       | string | لون الأيقونات                    | اللون الحالي      |
+    | الخط العريض | رقم    | عرض الخط العريض للأيقونة بالبكسل | 2                 |
+  </Tab>
 </Tabs>

 ## أيقونات مخصصة
@@ -63,29 +54,20 @@ export const MyComponent = () => {
 يعرض أيقونة دفتر العناوين.

 <Tabs>
+  <Tab title="الاستخدام">
+    ```jsx
+    import { IconAddressBook } from 'twenty-ui/display';

-<Tab title="الاستخدام">
-
-```jsx
-import { IconAddressBook } from 'twenty-ui/display';
-
-export const MyComponent = () => {
-  return <IconAddressBook size={24} stroke={2} />;
-};
-```
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص       | النوع | الوصف                            | الإعداد الافتراضي |
-| ----------- | ----- | -------------------------------- | ----------------- |
-| الحجم       | رقم   | ارتفاع وعرض الأيقونة بالبكسل     | 24                |
-| الخط العريض | رقم   | عرض الخط العريض للأيقونة بالبكسل | 2                 |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return <IconAddressBook size={24} stroke={2} />;
+    };
+    ```
+  </Tab>

+  <Tab title="خصائص">
+    | خصائص       | النوع | الوصف                            | الإعداد الافتراضي |
+    | ----------- | ----- | -------------------------------- | ----------------- |
+    | الحجم       | رقم   | ارتفاع وعرض الأيقونة بالبكسل     | 24                |
+    | الخط العريض | رقم   | عرض الخط العريض للأيقونة بالبكسل | 2                 |
+  </Tab>
 </Tabs>
@@ -10,38 +10,29 @@ image: /images/user-guide/table-views/table.png
 مكوّن لتصنيف المحتوى أو وسمه بصريًا.

 <Tabs>
+  <Tab title="استخدام">
+    ```jsx
+    import { Tag } from "@/ui/display/tag/components/Tag";

-<Tab title="استخدام">
-
-```jsx
-import { Tag } from "@/ui/display/tag/components/Tag";
-
-export const MyComponent = () => {
-  return (
-    <Tag
-      className
-      color="red"
-      text="Urgent"
-      onClick={() => console.log("click")}
-    />
-  );
-};
-```
-
-</Tab>
-
-<Tab title="المحددات">
-
-
-| المحددات  | النوع | الوصف                                                                                                                 |
-| --------- | ----- | --------------------------------------------------------------------------------------------------------------------- |
-| اسم الفئة | نص    | اسم اختياري لتنسيقات إضافية                                                                                           |
-| اللون     | نص    | لون العلامة. الخيارات تشمل: `أخضر`, `تركواز`, `سماوي`, `أزرق`, `أرجواني`, `وردي`, `أحمر`, `برتقالي`, `أصفر`, `رمادي`. |
-| نص        | نص    | محتوى العلامة                                                                                                         |
-| عند_النقر | دالة  | دالة اختيارية تُستدعى عند نقر المستخدم على العلامة                                                                    |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <Tag
+          className
+          color="red"
+          text="Urgent"
+          onClick={() => console.log("click")}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="المحددات">
+    | المحددات  | النوع | الوصف                                                                                                                 |
+    | --------- | ----- | --------------------------------------------------------------------------------------------------------------------- |
+    | اسم الفئة | نص    | اسم اختياري لتنسيقات إضافية                                                                                           |
+    | اللون     | نص    | لون العلامة. الخيارات تشمل: `أخضر`, `تركواز`, `سماوي`, `أزرق`, `أرجواني`, `وردي`, `أحمر`, `برتقالي`, `أصفر`, `رمادي`. |
+    | نص        | نص    | محتوى العلامة                                                                                                         |
+    | عند_النقر | دالة  | دالة اختيارية تُستدعى عند نقر المستخدم على العلامة                                                                    |
+  </Tab>
 </Tabs>
@@ -10,28 +10,22 @@ image: /images/user-guide/api/api.png
 يستخدم محرر نصوص غني يعتمد على الكتل من [BlockNote](https://www.blocknotejs.org/) للسماح للمستخدمين بتحرير وعرض كتل المحتوى.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { useBlockNote } from "@blocknote/react";
+    import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";

-```jsx
-import { useBlockNote } from "@blocknote/react";
-import { BlockEditor } from "@/ui/input/editor/components/BlockEditor";
+    export const MyComponent = () => {
+      const BlockNoteEditor = useBlockNote();

-export const MyComponent = () => {
-  const BlockNoteEditor = useBlockNote();
+      return <BlockEditor editor={BlockNoteEditor} />;
+    };
+    ```
+  </Tab>

-  return <BlockEditor editor={BlockNoteEditor} />;
-};
-```
-
-</Tab>
-<Tab title="المحددات">
-
-
-| المحددات | النوع             | الوصف                    |
-| -------- | ----------------- | ------------------------ |
-| محرر     | `BlockNoteEditor` | مثيل أو تكوين محرر الكتل |
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات | النوع             | الوصف                    |
+    | -------- | ----------------- | ------------------------ |
+    | محرر     | `BlockNoteEditor` | مثيل أو تكوين محرر الكتل |
+  </Tab>
 </Tabs>
@@ -12,511 +12,428 @@ image: /images/user-guide/views/filter.png
 ## زر

 <Tabs>
+  <Tab title="27332A2E2F2745">
+    ```jsx
+    import { Button } from "@/ui/input/button/components/Button";

-<Tab title="27332A2E2F2745">
-
-```jsx
-import { Button } from "@/ui/input/button/components/Button";
-
-export const MyComponent = () => {
-  return (
-    <Button
-      className
-      Icon={null}
-      title="Title"
-      fullWidth={false}
-      variant="primary"
-      size="medium"
-      position="standalone"
-      accent="default"
-      soon={false}
-      disabled={false}
-      focus={true}
-      onClick={() => console.log("click")}
-    />
-  );
-};
-```
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص     | النوع                 | الوصف                                                                              |
-| --------- | --------------------- | ---------------------------------------------------------------------------------- |
-| className | string                | اسم فئة اختياري لتنسيقات إضافية                                                    |
-| أيقونة    | `React.ComponentType` | مكون رمز اختياري يُعرض داخل الزر                                                   |
-| العنوان   | string                | محتوى نص الزر                                                                      |
-| عرض كامل  | قيمة منطقية           | يُحدد إذا كان الزر يجب أن يمتد ليغطي العرض الكامل للحاوية الخاصة به                |
-| التنوع    | string                | النمط المرئي للزر. تشمل الخيارات `primary`، `secondary`، و`tertiary`.              |
-| الحجم     | string                | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                            |
-| الموقع    | string                | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `standalone`، `left`، `right`، و`middle`. |
-| accent    | string                | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `default`، `blue`، `danger`               |
-| قريباً    | قيمة منطقية           | يشير إلى ما إذا كان الزر معلمًا "قريبًا" (مثل الميزات القادمة)                     |
-| معطل      | قيمة منطقية           | يحدد إذا كان الزر معطل أم لا                                                       |
-| تركيز     | قيمة منطقية           | يحدد إذا كان الزر في وضع التركيز                                                   |
-| عند النقر | وظيفة                 | وظيفة رد فعل تنطلق عند نقر المستخدم على الزر                                       |
-
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <Button
+          className
+          Icon={null}
+          title="Title"
+          fullWidth={false}
+          variant="primary"
+          size="medium"
+          position="standalone"
+          accent="default"
+          soon={false}
+          disabled={false}
+          focus={true}
+          onClick={() => console.log("click")}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="خصائص">
+    | خصائص     | النوع                 | الوصف                                                                              |
+    | --------- | --------------------- | ---------------------------------------------------------------------------------- |
+    | className | string                | اسم فئة اختياري لتنسيقات إضافية                                                    |
+    | أيقونة    | `React.ComponentType` | مكون رمز اختياري يُعرض داخل الزر                                                   |
+    | العنوان   | string                | محتوى نص الزر                                                                      |
+    | عرض كامل  | قيمة منطقية           | يُحدد إذا كان الزر يجب أن يمتد ليغطي العرض الكامل للحاوية الخاصة به                |
+    | التنوع    | string                | النمط المرئي للزر. تشمل الخيارات `primary`، `secondary`، و`tertiary`.              |
+    | الحجم     | string                | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                            |
+    | الموقع    | string                | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `standalone`، `left`، `right`، و`middle`. |
+    | accent    | string                | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `default`، `blue`، `danger`               |
+    | قريباً    | قيمة منطقية           | يشير إلى ما إذا كان الزر معلمًا "قريبًا" (مثل الميزات القادمة)                     |
+    | معطل      | قيمة منطقية           | يحدد إذا كان الزر معطل أم لا                                                       |
+    | تركيز     | قيمة منطقية           | يحدد إذا كان الزر في وضع التركيز                                                   |
+    | عند النقر | وظيفة                 | وظيفة رد فعل تنطلق عند نقر المستخدم على الزر                                       |
+  </Tab>
 </Tabs>

 ## مجموعة الأزرار

 <Tabs>
-<Tab title="استخدام">
-```jsx
-import { Button } from "@/ui/input/button/components/Button";
-import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";
+  <Tab title="استخدام">
+    ```jsx
+    import { Button } from "@/ui/input/button/components/Button";
+    import { ButtonGroup } from "@/ui/input/button/components/ButtonGroup";

-export const MyComponent = () => {
-  return (
-    <ButtonGroup variant="primary" size="large" accent="blue" className>
-      <Button
-        className
-        Icon={null}
-        title="Button 1"
-        fullWidth={false}
-        variant="primary"
-        size="medium"
-        position="standalone"
-        accent="blue"
-        soon={false}
-        disabled={false}
-        focus={false}
-        onClick={() => console.log("click")}
-      />
-      <Button
-        className
-        Icon={null}
-        title="Button 2"
-        fullWidth={false}
-        variant="secondary"
-        size="medium"
-        position="left"
-        accent="blue"
-        soon={false}
-        disabled={false}
-        focus={false}
-        onClick={() => console.log("click")}
-      />
-      <Button
-        className
-        Icon={null}
-        title="Button 3"
-        fullWidth={false}
-        variant="tertiary"
-        size="medium"
-        position="right"
-        accent="blue"
-        soon={false}
-        disabled={false}
-        focus={false}
-        onClick={() => console.log("click")}
-      />
-    </ButtonGroup>
-  );
-};
+    export const MyComponent = () => {
+      return (
+        <ButtonGroup variant="primary" size="large" accent="blue" className>
+          <Button
+            className
+            Icon={null}
+            title="Button 1"
+            fullWidth={false}
+            variant="primary"
+            size="medium"
+            position="standalone"
+            accent="blue"
+            soon={false}
+            disabled={false}
+            focus={false}
+            onClick={() => console.log("click")}
+          />
+          <Button
+            className
+            Icon={null}
+            title="Button 2"
+            fullWidth={false}
+            variant="secondary"
+            size="medium"
+            position="left"
+            accent="blue"
+            soon={false}
+            disabled={false}
+            focus={false}
+            onClick={() => console.log("click")}
+          />
+          <Button
+            className
+            Icon={null}
+            title="Button 3"
+            fullWidth={false}
+            variant="tertiary"
+            size="medium"
+            position="right"
+            accent="blue"
+            soon={false}
+            disabled={false}
+            focus={false}
+            onClick={() => console.log("click")}
+          />
+        </ButtonGroup>
+      );
+    };

-```
-</Tab>
+    ```
+  </Tab>

-<Tab title="الخصائص">
-
-
-| الخصائص   | النوع     | الوصف                                                                                  |
-| --------- | --------- | -------------------------------------------------------------------------------------- |
-| التنوع    | string    | النمط المرئي للأزرار داخل المجموعة. تشمل الخيارات `primary`، `secondary`، و`tertiary`. |
-| الحجم     | string    | حجم الأزرار داخل المجموعة. يوجد خياران: `medium` و`small`.                             |
-| accent    | نص        | لون تمييز الأزرار داخل المجموعة. تشمل الخيارات `default`، `blue` و`danger`.            |
-| className | string    | اسم فئة اختياري لتنسيقات إضافية                                                        |
-| الأبناء   | ReactNode | مجموعة من عناصر React تمثل الأزرار الفردية داخل المجموعة                               |
-
-
-
-</Tab>
+  <Tab title="الخصائص">
+    | الخصائص   | النوع     | الوصف                                                                                  |
+    | --------- | --------- | -------------------------------------------------------------------------------------- |
+    | التنوع    | string    | النمط المرئي للأزرار داخل المجموعة. تشمل الخيارات `primary`، `secondary`، و`tertiary`. |
+    | الحجم     | string    | حجم الأزرار داخل المجموعة. يوجد خياران: `medium` و`small`.                             |
+    | accent    | نص        | لون تمييز الأزرار داخل المجموعة. تشمل الخيارات `default`، `blue` و`danger`.            |
+    | className | string    | اسم فئة اختياري لتنسيقات إضافية                                                        |
+    | الأبناء   | ReactNode | مجموعة من عناصر React تمثل الأزرار الفردية داخل المجموعة                               |
+  </Tab>
 </Tabs>

 ## زر عائم

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+    import { IconSearch } from "@tabler/icons-react";

-```jsx
-import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
-import { IconSearch } from "@tabler/icons-react";
+    export const MyComponent = () => {
+      return (
+        <FloatingButton
+          className
+          Icon={IconSearch}
+          title="Title"
+          size="medium"
+          position="standalone"
+          applyShadow={true}
+          applyBlur={true}
+          disabled={false}
+          focus={true}
+        />
+      );
+    };
+    ```
+  </Tab>

-export const MyComponent = () => {
-  return (
-    <FloatingButton
-      className
-      Icon={IconSearch}
-      title="Title"
-      size="medium"
-      position="standalone"
-      applyShadow={true}
-      applyBlur={true}
-      disabled={false}
-      focus={true}
-    />
-  );
-};
-```
-
-</Tab>
-
-<Tab title="الخصائص">
-
-
-| الخصائص      | النوع                 | الوصف                                                                             |
-| ------------ | --------------------- | --------------------------------------------------------------------------------- |
-| className    | string                | اسم اختياري لتنسيقات إضافية                                                       |
-| أيقونة       | `React.ComponentType` | مكون أيقونة اختياري يظهر داخل الزر                                                |
-| العنوان      | string                | محتوى نص الزر                                                                     |
-| الحجم        | string                | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                           |
-| الموقع       | string                | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `standalone`، `left`، `middle`، `right`. |
-| تطبيق الظل   | قيمة منطقية           | يحدد إذا ما سيتم تطبيق الظلال على الزر                                            |
-| تطبيق الضباب | قيمة منطقية           | يحدد ما إذا كان ينبغي تطبيق تأثير الضباب على الزر                                 |
-| معطل         | قيمة منطقية           | يحدد ما إذا كان الزر معطل                                                         |
-| تركيز        | قيمة منطقية           | يحدد إذا كان الزر في وضع التركيز                                                  |
-
-
-
-</Tab>
+  <Tab title="الخصائص">
+    | الخصائص      | النوع                 | الوصف                                                                             |
+    | ------------ | --------------------- | --------------------------------------------------------------------------------- |
+    | className    | string                | اسم اختياري لتنسيقات إضافية                                                       |
+    | أيقونة       | `React.ComponentType` | مكون أيقونة اختياري يظهر داخل الزر                                                |
+    | العنوان      | string                | محتوى نص الزر                                                                     |
+    | الحجم        | string                | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                           |
+    | الموقع       | string                | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `standalone`، `left`، `middle`، `right`. |
+    | تطبيق الظل   | قيمة منطقية           | يحدد إذا ما سيتم تطبيق الظلال على الزر                                            |
+    | تطبيق الضباب | قيمة منطقية           | يحدد ما إذا كان ينبغي تطبيق تأثير الضباب على الزر                                 |
+    | معطل         | قيمة منطقية           | يحدد ما إذا كان الزر معطل                                                         |
+    | تركيز        | قيمة منطقية           | يحدد إذا كان الزر في وضع التركيز                                                  |
+  </Tab>
 </Tabs>

 ## مجموعة الأزرار العائمة

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
+    import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
+    import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";

-```jsx
-import { FloatingButton } from "@/ui/input/button/components/FloatingButton";
-import { FloatingButtonGroup } from "@/ui/input/button/components/FloatingButtonGroup";
-import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
-
-export const MyComponent = () => {
-  return (
-    <FloatingButtonGroup size="small">
-      <FloatingButton
-        className
-        Icon={IconClipboardText}
-        title
-        size="small"
-        position="standalone"
-        applyShadow={true}
-        applyBlur={true}
-        disabled={false}
-        focus={true}
-      />
-      <FloatingButton
-        className
-        Icon={IconCheckbox}
-        title
-        size="small"
-        position="standalone"
-        applyShadow={true}
-        applyBlur={true}
-        disabled={false}
-      />
-    </FloatingButtonGroup>
-  );
-};
-```
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص   | النوع     | الوصف                                                    | الإعداد الافتراضي |
-| ------- | --------- | -------------------------------------------------------- | ----------------- |
-| الحجم   | string    | حجم الزر. يوجد خياران: `صغير` و `متوسط`                  | صغير              |
-| الأبناء | ReactNode | مجموعة من عناصر React تمثل الأزرار الفردية داخل المجموعة |                   |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <FloatingButtonGroup size="small">
+          <FloatingButton
+            className
+            Icon={IconClipboardText}
+            title
+            size="small"
+            position="standalone"
+            applyShadow={true}
+            applyBlur={true}
+            disabled={false}
+            focus={true}
+          />
+          <FloatingButton
+            className
+            Icon={IconCheckbox}
+            title
+            size="small"
+            position="standalone"
+            applyShadow={true}
+            applyBlur={true}
+            disabled={false}
+          />
+        </FloatingButtonGroup>
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="خصائص">
+    | خصائص   | النوع     | الوصف                                                    | الإعداد الافتراضي |
+    | ------- | --------- | -------------------------------------------------------- | ----------------- |
+    | الحجم   | string    | حجم الزر. يوجد خياران: `صغير` و `متوسط`                  | صغير              |
+    | الأبناء | ReactNode | مجموعة من عناصر React تمثل الأزرار الفردية داخل المجموعة |                   |
+  </Tab>
 </Tabs>

 ## زر رمز عائم

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
+    import { IconSearch } from "@tabler/icons-react";

-```jsx
-import { FloatingIconButton } from "@/ui/input/button/components/FloatingIconButton";
-import { IconSearch } from "@tabler/icons-react";
-
-export const MyComponent = () => {
-  return (
-    <FloatingIconButton
-      className
-      Icon={IconSearch}
-      size="small"
-      position="standalone"
-      applyShadow={true}
-      applyBlur={true}
-      disabled={false}
-      focus={false}
-      onClick={() => console.log("click")}
-      isActive={true}
-    />
-  );
-};
-```
-
-</Tab>
-
-<Tab title="الخصائص">
-
-
-| الخصائص      | النوع                 | الوصف                                                                              |
-| ------------ | --------------------- | ---------------------------------------------------------------------------------- |
-| className    | نص                    | اسم اختياري لتنسيقات إضافية                                                        |
-| أيقونة       | `React.ComponentType` | مكون أيقونة اختياري يظهر داخل الزر                                                 |
-| الحجم        | نص                    | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                            |
-| الموقع       | نص                    | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `standalone`، `left`، `right`، و`middle`. |
-| تطبيق الظل   | قيمة منطقية           | يحدد إذا ما سيتم تطبيق الظلال على الزر                                             |
-| تطبيق الضباب | قيمة منطقية           | يحدد ما إذا كان ينبغي تطبيق تأثير الضباب على الزر                                  |
-| معطل         | قيمة منطقية           | يحدد ما إذا كان الزر معطل                                                          |
-| تركيز        | قيمة منطقية           | يحدد إذا كان الزر في وضع التركيز                                                   |
-| عند النقر    | وظيفة                 | وظيفة رد فعل تنطلق عند نقر المستخدم على الزر                                       |
-| فعّال        | قيمة منطقية           | يحدد إذا كان الزر في وضع فعّال                                                     |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <FloatingIconButton
+          className
+          Icon={IconSearch}
+          size="small"
+          position="standalone"
+          applyShadow={true}
+          applyBlur={true}
+          disabled={false}
+          focus={false}
+          onClick={() => console.log("click")}
+          isActive={true}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="الخصائص">
+    | الخصائص      | النوع                 | الوصف                                                                              |
+    | ------------ | --------------------- | ---------------------------------------------------------------------------------- |
+    | className    | نص                    | اسم اختياري لتنسيقات إضافية                                                        |
+    | أيقونة       | `React.ComponentType` | مكون أيقونة اختياري يظهر داخل الزر                                                 |
+    | الحجم        | نص                    | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                            |
+    | الموقع       | نص                    | موقع الزر بالنسبة لأخوته. تشمل الخيارات: `standalone`، `left`، `right`، و`middle`. |
+    | تطبيق الظل   | قيمة منطقية           | يحدد إذا ما سيتم تطبيق الظلال على الزر                                             |
+    | تطبيق الضباب | قيمة منطقية           | يحدد ما إذا كان ينبغي تطبيق تأثير الضباب على الزر                                  |
+    | معطل         | قيمة منطقية           | يحدد ما إذا كان الزر معطل                                                          |
+    | تركيز        | قيمة منطقية           | يحدد إذا كان الزر في وضع التركيز                                                   |
+    | عند النقر    | وظيفة                 | وظيفة رد فعل تنطلق عند نقر المستخدم على الزر                                       |
+    | فعّال        | قيمة منطقية           | يحدد إذا كان الزر في وضع فعّال                                                     |
+  </Tab>
 </Tabs>

 ## مجموعة أزرار الرموز العائمة

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
+    import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";

-```jsx
-import { FloatingIconButtonGroup } from "@/ui/input/button/components/FloatingIconButtonGroup";
-import { IconClipboardText, IconCheckbox } from "@tabler/icons-react";
+    export const MyComponent = () => {
+      const iconButtons = [
+        {
+          Icon: IconClipboardText,
+          onClick: () => console.log("Button 1 clicked"),
+          isActive: true,
+        },
+        {
+          Icon: IconCheckbox,
+          onClick: () => console.log("Button 2 clicked"),
+          isActive: true,
+        },
+      ];

-export const MyComponent = () => {
-  const iconButtons = [
-    {
-      Icon: IconClipboardText,
-      onClick: () => console.log("Button 1 clicked"),
-      isActive: true,
-    },
-    {
-      Icon: IconCheckbox,
-      onClick: () => console.log("Button 2 clicked"),
-      isActive: true,
-    },
-  ];
+      return (
+        <FloatingIconButtonGroup
+        className
+        size="small"
+        iconButtons={iconButtons} />
+      );
+    };

-  return (
-    <FloatingIconButtonGroup
-    className
-    size="small"
-    iconButtons={iconButtons} />
-  );
-};
-
-```
-
-</Tab>
-
-<Tab title="الخصائص">
-
-
-| الخصائص      | النوع  | الوصف                                                                                                                                                                                                             |
-| ------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| className    | string | اسم اختياري لتنسيقات إضافية                                                                                                                                                                                       |
-| الحجم        | string | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                                                                                                                                                           |
-| أزرار الرموز | array  | مجموعة من الكائنات، يمثل كل منها زر رمز في المجموعة. يجب أن يشمل كل كائن مكون الرمز الذي تريد عرضه في الزر، الوظيفة التي ترغب في استدعائها عند نقر المستخدم على الزر، وما إذا كان الزر ينبغي أن يكون نشطًا أم لا. |
-
-
-
-</Tab>
+    ```
+  </Tab>

+  <Tab title="الخصائص">
+    | الخصائص      | النوع  | الوصف                                                                                                                                                                                                             |
+    | ------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+    | className    | string | اسم اختياري لتنسيقات إضافية                                                                                                                                                                                       |
+    | الحجم        | string | حجم الزر. يوجد خياران: `صغير` و `متوسط`                                                                                                                                                                           |
+    | أزرار الرموز | array  | مجموعة من الكائنات، يمثل كل منها زر رمز في المجموعة. يجب أن يشمل كل كائن مكون الرمز الذي تريد عرضه في الزر، الوظيفة التي ترغب في استدعائها عند نقر المستخدم على الزر، وما إذا كان الزر ينبغي أن يكون نشطًا أم لا. |
+  </Tab>
 </Tabs>

 ## زر خفيف

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { LightButton } from "@/ui/input/button/components/LightButton";

-```jsx
-import { LightButton } from "@/ui/input/button/components/LightButton";
-
-export const MyComponent = () => {
-  return <LightButton
-  className
-  icon={null}
-  title="Title"
-  accent="secondary"
-  active={false}
-  disabled={false}
-  focus={true}
-  onClick={()=>console.log('click')}
-  />;
-};
-```
-
-
-</Tab>
-
-<Tab title="الإزاحة">
-
-
-| الإزاحة   | النوع             | الوصف                                                                      |
-| --------- | ----------------- | -------------------------------------------------------------------------- |
-| className | string            | اسم اختياري لتنسيقات إضافية                                                |
-| أيقونة    | `React.ReactNode` | الرمز الذي تريد عرضه في الزر                                               |
-| العنوان   | string            | محتوى نص الزر                                                              |
-| accent    | string            | موقع الزر بالنسبة لأخوته. لون الزر المميز تشمل الخيارات: `ثانوي` و `ثالثي` |
-| نشط       | قيمة منطقية       | يحدد إذا كان الزر في وضع فعّال                                             |
-| معطل      | قيمة منطقية       | يحدد ما إذا كان الزر معطل                                                  |
-| تركيز     | قيمة منطقية       | يحدد إذا كان الزر في وضع التركيز                                           |
-| عند النقر | وظيفة             | وظيفة رد فعل تنطلق عند نقر المستخدم على الزر                               |
-
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return <LightButton
+      className
+      icon={null}
+      title="Title"
+      accent="secondary"
+      active={false}
+      disabled={false}
+      focus={true}
+      onClick={()=>console.log('click')}
+      />;
+    };
+    ```
+  </Tab>

+  <Tab title="الإزاحة">
+    | الإزاحة   | النوع             | الوصف                                                                      |
+    | --------- | ----------------- | -------------------------------------------------------------------------- |
+    | className | string            | اسم اختياري لتنسيقات إضافية                                                |
+    | أيقونة    | `React.ReactNode` | الرمز الذي تريد عرضه في الزر                                               |
+    | العنوان   | string            | محتوى نص الزر                                                              |
+    | accent    | string            | موقع الزر بالنسبة لأخوته. لون الزر المميز تشمل الخيارات: `ثانوي` و `ثالثي` |
+    | نشط       | قيمة منطقية       | يحدد إذا كان الزر في وضع فعّال                                             |
+    | معطل      | قيمة منطقية       | يحدد ما إذا كان الزر معطل                                                  |
+    | تركيز     | قيمة منطقية       | يحدد إذا كان الزر في وضع التركيز                                           |
+    | عند النقر | وظيفة             | وظيفة رد فعل تنطلق عند نقر المستخدم على الزر                               |
+  </Tab>
 </Tabs>

 ## زر أيقونة خفيف

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
+    import { IconSearch } from "@tabler/icons-react";

-```jsx
-import { LightIconButton } from "@/ui/input/button/components/LightIconButton";
-import { IconSearch } from "@tabler/icons-react";
-
-export const MyComponent = () => {
-  return (
-    <LightIconButton
-      className
-      testId="test1"
-      Icon={IconSearch}
-      title="Title"
-      size="small"
-      accent="secondary"
-      active={true}
-      disabled={false}
-      focus={true}
-      onClick={() => console.log("click")}
-    />
-  );
-};
-```
-
-
-</Tab>
-
-<Tab title="العناصر">
-
-
-| العناصر   | النوع                 | الوصف                                            |
-| --------- | --------------------- | ------------------------------------------------ |
-| className | string                | اسم اختياري لتنسيقات إضافية                      |
-| testId    | string                | معرف اختبار للزر                                 |
-| أيقونة    | `React.ComponentType` | مكون أيقونة اختياري يظهر داخل الزر               |
-| العنوان   | string                | محتوى نصي للزر                                   |
-| الحجم     | string                | حجم الزر. يوجد خياران: `صغير` و `متوسط`          |
-| accent    | string                | لون الزر المميز تشمل الخيارات: `ثانوي` و `ثالثي` |
-| نشط       | قيمة منطقية           | يحدد ما إذا كان الزر في حالة نشطة                |
-| معطل      | قيمة منطقية           | يحدد ما إذا كان الزر معطلاً                      |
-| التركيز   | قيمة منطقية           | يشير إلى ما إذا كان الزر لديه تركيز              |
-| عند النقر | function              | وظيفة رد اتصال تتفعّل عند نقر المستخدم على الزر  |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <LightIconButton
+          className
+          testId="test1"
+          Icon={IconSearch}
+          title="Title"
+          size="small"
+          accent="secondary"
+          active={true}
+          disabled={false}
+          focus={true}
+          onClick={() => console.log("click")}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="العناصر">
+    | العناصر   | النوع                 | الوصف                                            |
+    | --------- | --------------------- | ------------------------------------------------ |
+    | className | string                | اسم اختياري لتنسيقات إضافية                      |
+    | testId    | string                | معرف اختبار للزر                                 |
+    | أيقونة    | `React.ComponentType` | مكون أيقونة اختياري يظهر داخل الزر               |
+    | العنوان   | string                | محتوى نصي للزر                                   |
+    | الحجم     | string                | حجم الزر. يوجد خياران: `صغير` و `متوسط`          |
+    | accent    | string                | لون الزر المميز تشمل الخيارات: `ثانوي` و `ثالثي` |
+    | نشط       | قيمة منطقية           | يحدد ما إذا كان الزر في حالة نشطة                |
+    | معطل      | قيمة منطقية           | يحدد ما إذا كان الزر معطلاً                      |
+    | التركيز   | قيمة منطقية           | يشير إلى ما إذا كان الزر لديه تركيز              |
+    | عند النقر | function              | وظيفة رد اتصال تتفعّل عند نقر المستخدم على الزر  |
+  </Tab>
 </Tabs>

 ## الزر الرئيسي

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { MainButton } from "@/ui/input/button/components/MainButton";
+    import { IconCheckbox } from "@tabler/icons-react";

-```jsx
-import { MainButton } from "@/ui/input/button/components/MainButton";
-import { IconCheckbox } from "@tabler/icons-react";
-
-export const MyComponent = () => {
-  return (
-    <MainButton
-      title="Checkbox"
-      fullWidth={false}
-      variant="primary"
-      soon={false}
-      Icon={IconCheckbox}
-    />
-  );
-};
-```
-
-
-</Tab>
-
-<Tab title="العناصر">
-
-
-| العناصر        | النوع                            | الوصف                                                          |
-| -------------- | -------------------------------- | -------------------------------------------------------------- |
-| العنوان        | string                           | محتوى نصي للزر                                                 |
-| عرض كامل       | قيمة منطقية                      | يحدد ما إذا كان الزر يجب أن يمتد على كامل عرض الحاوية          |
-| التنوع         | string                           | النمط البصري للزر. تشمل الخيارات `أساسي` و `ثانوي`             |
-| قريباً         | قيمة منطقية                      | يشير إلى ما إذا كان الزر معلمًا "قريبًا" (مثل الميزات القادمة) |
-| أيقونة         | `React.ComponentType`            | مكون أيقونة اختياري يظهر داخل الزر                             |
-| خصائص زر React | `React.ComponentProps<'button'>` | كل خصائص زر HTML القياسية مدعومة                               |
-
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <MainButton
+          title="Checkbox"
+          fullWidth={false}
+          variant="primary"
+          soon={false}
+          Icon={IconCheckbox}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="العناصر">
+    | العناصر        | النوع                            | الوصف                                                          |
+    | -------------- | -------------------------------- | -------------------------------------------------------------- |
+    | العنوان        | string                           | محتوى نصي للزر                                                 |
+    | عرض كامل       | قيمة منطقية                      | يحدد ما إذا كان الزر يجب أن يمتد على كامل عرض الحاوية          |
+    | التنوع         | string                           | النمط البصري للزر. تشمل الخيارات `أساسي` و `ثانوي`             |
+    | قريباً         | قيمة منطقية                      | يشير إلى ما إذا كان الزر معلمًا "قريبًا" (مثل الميزات القادمة) |
+    | أيقونة         | `React.ComponentType`            | مكون أيقونة اختياري يظهر داخل الزر                             |
+    | خصائص زر React | `React.ComponentProps<'button'>` | كل خصائص زر HTML القياسية مدعومة                               |
+  </Tab>
 </Tabs>

 ## زر أيقونة دائري

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
+    import { IconSearch } from "@tabler/icons-react";

-```jsx
-import { RoundedIconButton } from "@/ui/input/button/components/RoundedIconButton";
-import { IconSearch } from "@tabler/icons-react";
-
-export const MyComponent = () => {
-  return (
-    <RoundedIconButton
-      Icon={IconSearch}
-    />
-  );
-};
-```
-
-
-</Tab>
-
-<Tab title="العناصر">
-
-
-| العناصر        | النوع                                           | الوصف |
-| -------------- | ----------------------------------------------- | ----- |
-| أيقونة         | `React.ComponentType`                           |       |
-| خصائص زر React | `React.ButtonHTMLAttributes<HTMLButtonElement>` |       |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <RoundedIconButton
+          Icon={IconSearch}
+        />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="العناصر">
+    | العناصر        | النوع                                           | الوصف |
+    | -------------- | ----------------------------------------------- | ----- |
+    | أيقونة         | `React.ComponentType`                           |       |
+    | خصائص زر React | `React.ButtonHTMLAttributes<HTMLButtonElement>` |       |
+  </Tab>
 </Tabs>
@@ -10,41 +10,35 @@ image: /images/user-guide/tasks/tasks_header.png
 يُستخدم عندما يحتاج المستخدم إلى اختيار قيم متعددة من بين عدة خيارات.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { Checkbox } from "twenty-ui/display";

-```jsx
-import { Checkbox } from "twenty-ui/display";
+    export const MyComponent = () => {
+      return (
+        <Checkbox
+          checked={true}
+          indeterminate={false}
+          onChange={() => console.log("onChange function fired")}
+          onCheckedChange={() => console.log("onCheckedChange function fired")}
+          variant="primary"
+          size="small"
+          shape="squared"
+        />
+      );
+    };
+    ```
+  </Tab>

-export const MyComponent = () => {
-  return (
-    <Checkbox
-      checked={true}
-      indeterminate={false}
-      onChange={() => console.log("onChange function fired")}
-      onCheckedChange={() => console.log("onCheckedChange function fired")}
-      variant="primary"
-      size="small"
-      shape="squared"
-    />
-  );
-};
-```
-
-</Tab>
-<Tab title="المحددات">
-
-
-| المحددات                 | النوع       | الوصف                                                                         |
-| ------------------------ | ----------- | ----------------------------------------------------------------------------- |
-| مختار                    | قيمة منطقية | يشير إلى ما إذا كان مربع الاختيار محددًا                                      |
-| غير محدد                 | قيمة منطقية | يشير إلى ما إذا كان مربع الاختيار في حالة غير محددة (لا هو محدد ولا غير محدد) |
-| عند التغيير              | دالة        | الدالة التي ترغب في تفعيلها عند تغيير حالة مربع الاختيار                      |
-| عند تغيير الحالة المحددة | دالة        | الدالة التي ترغب في تفعيلها عند تغيّر حالة `checked`                          |
-| نموذج                    | نص          | النمط البصري للصندوق. تتضمن الخيارات: 'أساسي'، 'ثانوي'، و 'ثالثي'             |
-| الحجم                    | نص          | حجم مربع الاختيار. له خياران: `small` و `large`                               |
-| الشكل                    | نص          | شكل مربع الاختيار. لديه خياران: 'مربع' و 'مدور'                               |
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات                 | النوع       | الوصف                                                                         |
+    | ------------------------ | ----------- | ----------------------------------------------------------------------------- |
+    | مختار                    | قيمة منطقية | يشير إلى ما إذا كان مربع الاختيار محددًا                                      |
+    | غير محدد                 | قيمة منطقية | يشير إلى ما إذا كان مربع الاختيار في حالة غير محددة (لا هو محدد ولا غير محدد) |
+    | عند التغيير              | دالة        | الدالة التي ترغب في تفعيلها عند تغيير حالة مربع الاختيار                      |
+    | عند تغيير الحالة المحددة | دالة        | الدالة التي ترغب في تفعيلها عند تغيّر حالة `checked`                          |
+    | نموذج                    | نص          | النمط البصري للصندوق. تتضمن الخيارات: 'أساسي'، 'ثانوي'، و 'ثالثي'             |
+    | الحجم                    | نص          | حجم مربع الاختيار. له خياران: `small` و `large`                               |
+    | الشكل                    | نص          | شكل مربع الاختيار. لديه خياران: 'مربع' و 'مدور'                               |
+  </Tab>
 </Tabs>
@@ -12,36 +12,28 @@ image: /images/user-guide/fields/field.png
 يمثل مخططات ألوان مختلفة ومخصص بشكل خاص للمواضيع الفاتحة والداكنة.

 <Tabs>
-<Tab title="27332A2E2F2745">
+  <Tab title="27332A2E2F2745">
+    ```jsx
+    import { ColorSchemeCard } from "twenty-ui/display";

-```jsx
-import { ColorSchemeCard } from "twenty-ui/display";
-
-export const MyComponent = () => {
-  return (
-      <ColorSchemeCard
-      variant="Dark"
-      selected={true}
-      />
-  );
-};
-```
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص        | النوع                                   | الوصف                                                                  | الإعداد الافتراضي |
-| ------------ | --------------------------------------- | ---------------------------------------------------------------------- | ----------------- |
-| التنوع       | string                                  | نوع مخطط الألوان. تشمل الخيارات `داكنة`, `فاتحة`, و `النظام`           | فاتح              |
-| المحدد       | قيمة منطقية                             | إذا كان `صحيح`, يتم عرض علامة الاختيار للدلالة على مخطط الألوان المحدد |                   |
-| خصائص إضافية | `React.ComponentPropsWithoutRef<'div'>` | خصائص عنصر `div` العادي في HTML                                        |                   |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+          <ColorSchemeCard
+          variant="Dark"
+          selected={true}
+          />
+      );
+    };
+    ```
+  </Tab>

+  <Tab title="خصائص">
+    | خصائص        | النوع                                   | الوصف                                                                  | الإعداد الافتراضي |
+    | ------------ | --------------------------------------- | ---------------------------------------------------------------------- | ----------------- |
+    | التنوع       | string                                  | نوع مخطط الألوان. تشمل الخيارات `داكنة`, `فاتحة`, و `النظام`           | فاتح              |
+    | المحدد       | قيمة منطقية                             | إذا كان `صحيح`, يتم عرض علامة الاختيار للدلالة على مخطط الألوان المحدد |                   |
+    | خصائص إضافية | `React.ComponentPropsWithoutRef<'div'>` | خصائص عنصر `div` العادي في HTML                                        |                   |
+  </Tab>
 </Tabs>

 ## منتقي مخطط الألوان
@@ -49,31 +41,23 @@ export const MyComponent = () => {
 يتيح للمستخدمين اختيار بين مخططات الألوان المختلفة.

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { ColorSchemePicker } from "twenty-ui/display";

-```jsx
-import { ColorSchemePicker } from "twenty-ui/display";
-
-export const MyComponent = () => {
-  return <ColorSchemePicker
-  value="Dark"
-  onChange
-  />;
-};
-```
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص       | النوع               | الوصف                                                         |
-| ----------- | ------------------- | ------------------------------------------------------------- |
-| القيمة      | `طريقة عرض الألوان` | مخطط الألوان المحدد حاليًا                                    |
-| عند التغيير | function            | الدالة التي ترغب في تفعيلها عندما يختار المستخدم نظام الألوان |
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return <ColorSchemePicker
+      value="Dark"
+      onChange
+      />;
+    };
+    ```
+  </Tab>

+  <Tab title="خصائص">
+    | خصائص       | النوع               | الوصف                                                         |
+    | ----------- | ------------------- | ------------------------------------------------------------- |
+    | القيمة      | `طريقة عرض الألوان` | مخطط الألوان المحدد حاليًا                                    |
+    | عند التغيير | function            | الدالة التي ترغب في تفعيلها عندما يختار المستخدم نظام الألوان |
+  </Tab>
 </Tabs>
@@ -10,49 +10,43 @@ image: /images/user-guide/github/github-header.png
 منتقى الأيقونات المعتمد على القائمة المنسدلة الذي يتيح للمستخدمين اختيار أيقونة من قائمة.

 <Tabs>
+  <Tab title="استخدام">
+    ```jsx
+    import { RecoilRoot } from "recoil";
+    import React, { useState } from "react";
+    import { IconPicker } from "@/ui/input/components/IconPicker";

-<Tab title="استخدام">
+    export const MyComponent = () => {

-```jsx
-import React, { useState } from "react";
-import { IconPicker } from "@/ui/input/components/IconPicker";
+       const [selectedIcon, setSelectedIcon] = useState("");
+       const handleIconChange = ({ iconKey, Icon }) => {
+         console.log("Selected Icon:", iconKey);
+         setSelectedIcon(iconKey);
+       };

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

-   const [selectedIcon, setSelectedIcon] = useState("");
-   const handleIconChange = ({ iconKey, Icon }) => {
-     console.log("Selected Icon:", iconKey);
-     setSelectedIcon(iconKey);
-   };
-
-  return (
-      <IconPicker
-        disabled={false}
-        onChange={handleIconChange}
-        selectedIconKey={selectedIcon}
-        variant="primary"
-      />
-  );
-};
-```
-
-
-</Tab>
-<Tab title="المحددات">
-
-
-| المحددات                | النوع       | الوصف                                                                                                        |
-| ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
-| معطل                    | قيمة منطقية | يقوم بتعطيل منتقى الأيقونات إذا تم تعيينه إلى `true`                                                         |
-| عند التغيير             | دالة        | الدالة الارتجاعية التي تُفعل عندما يختار المستخدم أيقونة. يستقبل كائنًا يحتوي على الخصائص `iconKey` و `Icon` |
-| مفتاح الأيقونة المختارة | نص          | مفتاح الأيقونة المختارة في البداية                                                                           |
-| النقر بالخارج           | دالة        | الدالة الارتجاعية التي تُفعل عندما ينقر المستخدم خارج القائمة المنسدلة                                       |
-| عند الإغلاق             | دالة        | الدالة الارتجاعية التي تُفعل عند إغلاق القائمة المنسدلة                                                      |
-| عند الفتح               | دالة        | الدالة الارتجاعية التي تُفعل عند فتح القائمة المنسدلة                                                        |
-| التنوع                  | نص          | متغير النمط البصري للأيقونة القابلة للنقر. تشمل الخيارات: `رئيسي`, `ثانوي`, و `ثالثي`                        |
-
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات                | النوع       | الوصف                                                                                                        |
+    | ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
+    | معطل                    | قيمة منطقية | يقوم بتعطيل منتقى الأيقونات إذا تم تعيينه إلى `true`                                                         |
+    | عند التغيير             | دالة        | الدالة الارتجاعية التي تُفعل عندما يختار المستخدم أيقونة. يستقبل كائنًا يحتوي على الخصائص `iconKey` و `Icon` |
+    | مفتاح الأيقونة المختارة | نص          | مفتاح الأيقونة المختارة في البداية                                                                           |
+    | النقر بالخارج           | دالة        | الدالة الارتجاعية التي تُفعل عندما ينقر المستخدم خارج القائمة المنسدلة                                       |
+    | عند الإغلاق             | دالة        | الدالة الارتجاعية التي تُفعل عند إغلاق القائمة المنسدلة                                                      |
+    | عند الفتح               | دالة        | الدالة الارتجاعية التي تُفعل عند فتح القائمة المنسدلة                                                        |
+    | التنوع                  | نص          | متغير النمط البصري للأيقونة القابلة للنقر. تشمل الخيارات: `رئيسي`, `ثانوي`, و `ثالثي`                        |
+  </Tab>
 </Tabs>
@@ -10,32 +10,25 @@ image: /images/user-guide/objects/objects.png
 4A4F33452D 44445245332A2E2F454A46 28452F 482532274429 35483129.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { ImageInput } from "@/ui/input/components/ImageInput";

-```jsx
-import { ImageInput } from "@/ui/input/components/ImageInput";
+    export const MyComponent = () => {
+      return <ImageInput/>;
+    };
+    ```
+  </Tab>

-export const MyComponent = () => {
-  return <ImageInput/>;
-};
-```
-
-</Tab>
-<Tab title="المحددات">
-
-
-| المحددات     | النوع       | الوصف                                                                             |
-| ------------ | ----------- | --------------------------------------------------------------------------------- |
-| صورة         | نص          | 3946482746 45352F31 274435483129 27442544432A3148464A    |
-| onUpload     | دالة        | الدالة التي تُستدعى عند قيام المستخدم بتحميل صورة جديدة. تستقبل كائن `File` كوسيط |
-| onRemove     | دالة        | الدالة التي تُستدعى عند نقر المستخدم على زر الإزالة                               |
-| onAbort      | دالة        | الدالة التي تُستدعى عند نقر المستخدم على زر الإلغاء أثناء تحميل الصورة            |
-| isUploading  | قيمة منطقية | يشير إلى ما إذا كان يتم تحميل صورة حاليًا                                         |
-| errorMessage | نص          | رسالة خطأ اختيارية لعرضها أسفل حقل إدخال الصورة                                   |
-| معطل         | قيمة منطقية | إذا كانت `true`، فسيكون حقل الإدخال بأكمله معطلاً، ولن تكون الأزرار قابلة للنقر   |
-
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات     | النوع       | الوصف                                                                             |
+    | ------------ | ----------- | --------------------------------------------------------------------------------- |
+    | صورة         | نص          | 3946482746 45352F31 274435483129 27442544432A3148464A    |
+    | onUpload     | دالة        | الدالة التي تُستدعى عند قيام المستخدم بتحميل صورة جديدة. تستقبل كائن `File` كوسيط |
+    | onRemove     | دالة        | الدالة التي تُستدعى عند نقر المستخدم على زر الإزالة                               |
+    | onAbort      | دالة        | الدالة التي تُستدعى عند نقر المستخدم على زر الإلغاء أثناء تحميل الصورة            |
+    | isUploading  | قيمة منطقية | يشير إلى ما إذا كان يتم تحميل صورة حاليًا                                         |
+    | errorMessage | نص          | رسالة خطأ اختيارية لعرضها أسفل حقل إدخال الصورة                                   |
+    | معطل         | قيمة منطقية | إذا كانت `true`، فسيكون حقل الإدخال بأكمله معطلاً، ولن تكون الأزرار قابلة للنقر   |
+  </Tab>
 </Tabs>
@@ -10,58 +10,50 @@ image: /images/user-guide/create-workspace/workspace-cover.png
 تستخدم عندما يمكن للمستخدمين اختيار خيار واحد فقط من سلسلة من الخيارات.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { Radio } from "twenty-ui/display";

-```jsx
-import { Radio } from "twenty-ui/display";
+    export const MyComponent = () => {

-export const MyComponent = () => {
+      const handleRadioChange = (event) => {
+        console.log("Radio button changed:", event.target.checked);
+      };

-  const handleRadioChange = (event) => {
-    console.log("Radio button changed:", event.target.checked);
-  };
-
-  const handleCheckedChange = (checked) => {
-    console.log("Checked state changed:", checked);
-  };
+      const handleCheckedChange = (checked) => {
+        console.log("Checked state changed:", checked);
+      };


-  return (
-    <Radio
-      checked={true}
-      value="Option 1"
-      onChange={handleRadioChange}
-      onCheckedChange={handleCheckedChange}
-      size="large"
-      disabled={false}
-      labelPosition="right"
-    />
-  );
-};
-},{
-```
+      return (
+        <Radio
+          checked={true}
+          value="Option 1"
+          onChange={handleRadioChange}
+          onCheckedChange={handleCheckedChange}
+          size="large"
+          disabled={false}
+          labelPosition="right"
+        />
+      );
+    };
+    },{
+    ```
+  </Tab>

-
-</Tab>
-<Tab title="المحددات">
-
-
-| المحددات                 | النوع             | الوصف                                                              |
-| ------------------------ | ----------------- | ------------------------------------------------------------------ |
-| النمط                    | خصائص `React.CSS` | أنماط إضافية مضمنة للمكون                                          |
-| اسم الفئة                | نص                | فئة CSS اختيارية لتصميم إضافي                                      |
-| مختار                    | قيمة منطقية       | يشير إلى ما إذا كان زر الراديو محددًا                              |
-| القيمة                   | نص                | التسمية أو النص المرتبط بزر الراديو                                |
-| عند التغيير              | دالة              | الدالة التي تُستدعى عند تغيير زر الاختيار المحدد.                  |
-| عند تغيير الحالة المحددة | دالة              | الدالة التي تُستدعى عند تغيير حالة `checked` لزر الاختيار.         |
-| الحجم                    | نص                | حجم زر الراديو. تشمل الخيارات: `large` و `small`                   |
-| معطل                     | قيمة منطقية       | إذا كانت `true`، فسيكون زر الاختيار معطلاً وغير قابل للنقر         |
-| موضع التسمية             | نص                | موضع نص التسمية بالنسبة لزر الراديو. يوجد خياران: `left` و `right` |
-
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات                 | النوع             | الوصف                                                              |
+    | ------------------------ | ----------------- | ------------------------------------------------------------------ |
+    | النمط                    | خصائص `React.CSS` | أنماط إضافية مضمنة للمكون                                          |
+    | اسم الفئة                | نص                | فئة CSS اختيارية لتصميم إضافي                                      |
+    | مختار                    | قيمة منطقية       | يشير إلى ما إذا كان زر الراديو محددًا                              |
+    | القيمة                   | نص                | التسمية أو النص المرتبط بزر الراديو                                |
+    | عند التغيير              | دالة              | الدالة التي تُستدعى عند تغيير زر الاختيار المحدد.                  |
+    | عند تغيير الحالة المحددة | دالة              | الدالة التي تُستدعى عند تغيير حالة `checked` لزر الاختيار.         |
+    | الحجم                    | نص                | حجم زر الراديو. تشمل الخيارات: `large` و `small`                   |
+    | معطل                     | قيمة منطقية       | إذا كانت `true`، فسيكون زر الاختيار معطلاً وغير قابل للنقر         |
+    | موضع التسمية             | نص                | موضع نص التسمية بالنسبة لزر الراديو. يوجد خياران: `left` و `right` |
+  </Tab>
 </Tabs>

 ## مجموعة الراديو
@@ -69,45 +61,37 @@ export const MyComponent = () => {
 يجمع أزرار الراديو ذات الصلة معًا.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import React, { useState } from "react";
+    import { Radio, RadioGroup } from "twenty-ui/display";

-```jsx
-import React, { useState } from "react";
-import { Radio, RadioGroup } from "twenty-ui/display";
+    export const MyComponent = () => {

-export const MyComponent = () => {
+      const [selectedValue, setSelectedValue] = useState("Option 1");

-  const [selectedValue, setSelectedValue] = useState("Option 1");
+      const handleChange = (event) => {
+        setSelectedValue(event.target.value);
+      };
+      
+      return (
+        <RadioGroup value={selectedValue} onChange={handleChange}>
+          <Radio value="Option 1" />
+          <Radio value="Option 2" />
+          <Radio value="Option 3" />
+        </RadioGroup>
+      );
+    };

-  const handleChange = (event) => {
-    setSelectedValue(event.target.value);
-  };
-  
-  return (
-    <RadioGroup value={selectedValue} onChange={handleChange}>
-      <Radio value="Option 1" />
-      <Radio value="Option 2" />
-      <Radio value="Option 3" />
-    </RadioGroup>
-  );
-};
-
-```
-
-</Tab>
-<Tab title="الخصائص">
-
-
-| الخصائص       | النوع             | الوصف                                                                 |
-| ------------- | ----------------- | --------------------------------------------------------------------- |
-| القيمة        | string            | قيمة زر الراديو المحدد حاليًا                                         |
-| عند التغيير   | دالة              | دالة الاستدعاء التي يتم تشغيلها عند تغيير زر الاختيار.                |
-| onValueChange | دالة              | دالة الاستدعاء التي يتم تشغيلها عند تغيير القيمة المحددة في المجموعة. |
-| الأبناء       | `React.ReactNode` | يتيح لك تمرير مكوّنات React (مثل Radio) كعناصر فرعية إلى Radio Group  |
-
-
-
-
-</Tab>
+    ```
+  </Tab>

+  <Tab title="الخصائص">
+    | الخصائص       | النوع             | الوصف                                                                 |
+    | ------------- | ----------------- | --------------------------------------------------------------------- |
+    | القيمة        | string            | قيمة زر الراديو المحدد حاليًا                                         |
+    | عند التغيير   | دالة              | دالة الاستدعاء التي يتم تشغيلها عند تغيير زر الاختيار.                |
+    | onValueChange | دالة              | دالة الاستدعاء التي يتم تشغيلها عند تغيير القيمة المحددة في المجموعة. |
+    | الأبناء       | `React.ReactNode` | يتيح لك تمرير مكوّنات React (مثل Radio) كعناصر فرعية إلى Radio Group  |
+  </Tab>
 </Tabs>
@@ -10,46 +10,42 @@ image: /images/user-guide/what-is-twenty/20.png
 يتيح للمستخدمين اختيار قيمة من قائمة من الخيارات المحددة مسبقًا.

 <Tabs>
-<Tab title="استخدام">
+  <Tab title="استخدام">
+    ```jsx
+    import { RecoilRoot } from 'recoil';
+    import { IconTwentyStar } from 'twenty-ui/display';

-```jsx
-import { IconTwentyStar } from 'twenty-ui/display';
+    import { Select } from '@/ui/input/components/Select';

-import { Select } from '@/ui/input/components/Select';
+    export const MyComponent = () => {

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

-  return (
-      <Select
-        className
-        disabled={false}
-        label="Select an option"
-        options={[
-          { value: 'option1', label: 'Option A', Icon: IconTwentyStar },
-          { value: 'option2', label: 'Option B', Icon: IconTwentyStar },
-        ]}
-        value="option1"
-      />
-  );
-};
+    ```
+  </Tab>

-```
-
-</Tab>
-<Tab title="المحددات">
-
-
-| المحددات    | النوع       | الوصف                                                                                                                                               |
-| ----------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
-| اسم الفئة   | نص          | فئة CSS اختيارية للتنسيق الإضافي                                                                                                                    |
-| معطل        | قيمة منطقية | عند ضبطها على `true`، يتم تعطيل تفاعل المستخدم مع المكون                                                                                            |
-| التسمية     | نص          | التسمية التي تصف غرض مكوّن `Select`                                                                                                                 |
-| عند التغيير | دالة        | الدالة التي تُستدعى عند تغيير القيم المحددة                                                                                                         |
-| خيارات      | مصفوفة      | تمثل الخيارات المتاحة في مكون `الاختيار`. إنها مصفوفة من الكائنات حيث يحتوي كل كائن على `قيمة` (معرف فريد)، `تسمية` (معرف فريد)، و`أيقونة` اختيارية |
-| القيمة      | نص          | تمثل القيمة المحددة حاليًا. يجب أن تطابق إحدى خصائص `القيمة` في مصفوفة `الخيارات`                                                                   |
-
-
-
-
-</Tab>
+  <Tab title="المحددات">
+    | المحددات    | النوع       | الوصف                                                                                                                                               |
+    | ----------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+    | اسم الفئة   | نص          | فئة CSS اختيارية للتنسيق الإضافي                                                                                                                    |
+    | معطل        | قيمة منطقية | عند ضبطها على `true`، يتم تعطيل تفاعل المستخدم مع المكون                                                                                            |
+    | التسمية     | نص          | التسمية التي تصف غرض مكوّن `Select`                                                                                                                 |
+    | عند التغيير | دالة        | الدالة التي تُستدعى عند تغيير القيم المحددة                                                                                                         |
+    | خيارات      | مصفوفة      | تمثل الخيارات المتاحة في مكون `الاختيار`. إنها مصفوفة من الكائنات حيث يحتوي كل كائن على `قيمة` (معرف فريد)، `تسمية` (معرف فريد)، و`أيقونة` اختيارية |
+    | القيمة      | نص          | تمثل القيمة المحددة حاليًا. يجب أن تطابق إحدى خصائص `القيمة` في مصفوفة `الخيارات`                                                                   |
+  </Tab>
 </Tabs>
@@ -12,61 +12,53 @@ image: /images/user-guide/notes/notes_header.png
 يسمح للمستخدمين بإدخال وتحرير النص.

 <Tabs>
+  <Tab title="27332A2E2F2745">
+    ```jsx
+    import { RecoilRoot } from "recoil";
+    import { TextInput } from "@/ui/input/components/TextInput";

-<Tab title="27332A2E2F2745">
+    export const MyComponent = () => {
+      const handleChange = (text) => {
+        console.log("تم تغيير الإدخال:", text);
+      };

-```jsx
-import { TextInput } from "@/ui/input/components/TextInput";
+      const handleKeyDown = (event) => {
+        console.log("تم ضغط المفتاح:", event.key);
+      };

-export const MyComponent = () => {
-  const handleChange = (text) => {
-    console.log("تم تغيير الإدخال:", text);
-  };
+      return (
+        <RecoilRoot>
+          <TextInput
+            className
+            label="اسم المستخدم"
+            onChange={handleChange}
+            fullWidth={false}
+            disableHotkeys={false}
+            error="اسم مستخدم غير صالح"
+            onKeyDown={handleKeyDown}
+            RightIcon={null}
+          />
+        </RecoilRoot>
+      );
+    };
+    },{
+    ```
+  </Tab>

-  const handleKeyDown = (event) => {
-    console.log("تم ضغط المفتاح:", event.key);
-  };
-
-  return (
-      <TextInput
-        className
-        label="اسم المستخدم"
-        onChange={handleChange}
-        fullWidth={false}
-        disableHotkeys={false}
-        error="اسم مستخدم غير صالح"
-        onKeyDown={handleKeyDown}
-        RightIcon={null}
-      />
-  );
-};
-},{
-```
-
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص            | النوع         | الوصف                                                                                                   |
-| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
-| className        | string        | اسم اختياري للتنسيق الإضافي.                                                                            |
-| التسمية          | نص            | يمثل التسمية للإدخال.                                                                                   |
-| onChange         | وظيفة         | الدالة التي تُستدعى عند تغيير قيمة الإدخال.                                                             |
-| عرض كامل         | قيمة منطقية   | يشير إلى ما إذا كان الإدخال يجب أن يشغل 100% من العرض.                                                  |
-| تعطيل الإختصارات | قيمة منطقية   | يشير إلى ما إذا كانت الاختصارات ممكنة للإدخال.                                                          |
-| خطأ              | string        | يمثل رسالة الخطأ التي سيتم عرضها. عند توفرها، تضيف رمز خطأ على الجانب الأيمن من الإدخال.                |
-| onKeyDown        | دالة          | يتم الاستدعاء عندما يتم الضغط على مفتاح عند التركيز على حقل الإدخال. يتلقى `React.KeyboardEvent` كمعلمة |
-| أيقونة يمين      | مكون الأيقونة | مكون أيقونة اختياري معروض على الجانب الأيمن من الإدخال.                                                 |
-
-
-
-
-يقبل المكون أيضًا دعم خصائص HTML أخرى لعناصر الإدخال.
-
-</Tab>
+  <Tab title="خصائص">
+    | خصائص            | النوع         | الوصف                                                                                                   |
+    | ---------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
+    | className        | string        | اسم اختياري للتنسيق الإضافي.                                                                            |
+    | التسمية          | نص            | يمثل التسمية للإدخال.                                                                                   |
+    | onChange         | وظيفة         | الدالة التي تُستدعى عند تغيير قيمة الإدخال.                                                             |
+    | عرض كامل         | قيمة منطقية   | يشير إلى ما إذا كان الإدخال يجب أن يشغل 100% من العرض.                                                  |
+    | تعطيل الإختصارات | قيمة منطقية   | يشير إلى ما إذا كانت الاختصارات ممكنة للإدخال.                                                          |
+    | خطأ              | string        | يمثل رسالة الخطأ التي سيتم عرضها. عند توفرها، تضيف رمز خطأ على الجانب الأيمن من الإدخال.                |
+    | onKeyDown        | دالة          | يتم الاستدعاء عندما يتم الضغط على مفتاح عند التركيز على حقل الإدخال. يتلقى `React.KeyboardEvent` كمعلمة |
+    | أيقونة يمين      | مكون الأيقونة | مكون أيقونة اختياري معروض على الجانب الأيمن من الإدخال.                                                 |

+    يقبل المكون أيضًا دعم خصائص HTML أخرى لعناصر الإدخال.
+  </Tab>
 </Tabs>

 ## إدخال نص بالحجم التلقائي
@@ -74,48 +66,40 @@ export const MyComponent = () => {
 مكون إدخال نصي يعدل ارتفاعه تلقائيًا بناءً على المحتوى.

 <Tabs>
+  <Tab title="الاستخدام">
+    ```jsx
+    import { RecoilRoot } from "recoil";
+    import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";

-<Tab title="الاستخدام">
-
-```jsx
-import { AutosizeTextInput } from "@/ui/input/components/AutosizeTextInput";
-
-export const MyComponent = () => {
-  return (
-      <AutosizeTextInput
-        onValidate={() => console.log("تم تشغيل الدالة onValidate")}
-        minRows={1}
-        placeholder="اكتب تعليقًا"
-        onFocus={() => console.log("تم تشغيل الدالة onFocus")}
-        variant="icon"
-        buttonTitle
-        value="المهمة: "
-      />
-  );
-};},{
-```
-
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص              | النوع | الوصف                                                         |
-| ------------------ | ----- | ------------------------------------------------------------- |
-| onValidate         | دالة  | الدالة التي ترغب في تفعيلها عند تصديق المستخدم الإدخال.       |
-| الحد الأدنى للأسطر | رقم   | عدد الأسطر الأدنى للمساحة النصية.                             |
-| النص التوضيحي      | نص    | النص التوضيحي الذي ترغب في عرضه عند كون المساحة النصية فارغة. |
-| onFocus            | دالة  | الدالة التي ترغب في تفعيلها عند تركيز المساحة النصية.         |
-| البديل             | نص    | البديل للإدخال. تشمل الخيارات: `افتراضي`، `أيقونة`، و`زر`.    |
-| عنوان الزر         | نص    | العنوان للزر (فقط للبديل الزر).                               |
-| القيمة             | نص    | القيمة الأولية للمساحة النصية.                                |
-
-
-
-
-</Tab>
+    export const MyComponent = () => {
+      return (
+        <RecoilRoot>
+          <AutosizeTextInput
+            onValidate={() => console.log("تم تشغيل الدالة onValidate")}
+            minRows={1}
+            placeholder="اكتب تعليقًا"
+            onFocus={() => console.log("تم تشغيل الدالة onFocus")}
+            variant="icon"
+            buttonTitle
+            value="المهمة: "
+          />
+        </RecoilRoot>
+      );
+    };},{
+    ```
+  </Tab>

+  <Tab title="خصائص">
+    | خصائص              | النوع | الوصف                                                         |
+    | ------------------ | ----- | ------------------------------------------------------------- |
+    | onValidate         | دالة  | الدالة التي ترغب في تفعيلها عند تصديق المستخدم الإدخال.       |
+    | الحد الأدنى للأسطر | رقم   | عدد الأسطر الأدنى للمساحة النصية.                             |
+    | النص التوضيحي      | نص    | النص التوضيحي الذي ترغب في عرضه عند كون المساحة النصية فارغة. |
+    | onFocus            | دالة  | الدالة التي ترغب في تفعيلها عند تركيز المساحة النصية.         |
+    | البديل             | نص    | البديل للإدخال. تشمل الخيارات: `افتراضي`، `أيقونة`، و`زر`.    |
+    | عنوان الزر         | نص    | العنوان للزر (فقط للبديل الزر).                               |
+    | القيمة             | نص    | القيمة الأولية للمساحة النصية.                                |
+  </Tab>
 </Tabs>

 ## مساحة نصية
@@ -123,40 +107,31 @@ export const MyComponent = () => {
 تتيح لك إنشاء إدخالات نصية متعددة الأسطر.

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { TextArea } from "@/ui/input/components/TextArea";

-```jsx
-import { TextArea } from "@/ui/input/components/TextArea";
+    export const MyComponent = () => {
+      return (
+        <TextArea
+        disabled={false}
+        minRows={4}
+        onChange={()=>console.log('تم تشغيل الدالة onChange')}
+        placeholder="أدخل النص هنا"
+        value=""
+        />
+      );
+    };
+    ```
+  </Tab>

-export const MyComponent = () => {
-  return (
-    <TextArea
-    disabled={false}
-    minRows={4}
-    onChange={()=>console.log('تم تشغيل الدالة onChange')}
-    placeholder="أدخل النص هنا"
-    value=""
-    />
-  );
-};
-```
-
-
-</Tab>
-
-<Tab title="خصائص">
-
-
-| خصائص              | النوع       | الوصف                                            |
-| ------------------ | ----------- | ------------------------------------------------ |
-| تعطيل              | قيمة منطقية | يشير إلى ما إذا كانت المساحة النصية معطلة.       |
-| الحد الأدنى للأسطر | رقم         | العدد الأدنى للأسطر الظاهرة للمساحة النصية.      |
-| onChange           | وظيفة       | دالة الاستدعاء تُشغّل عند تغيّر محتوى منطقة النص |
-| نص توضيحي          | نص          | النص المُوضّح عندما تكون منطقة النص فارغة        |
-| القيمة             | نص          | القيمة الحالية لمنطقة النص                       |
-
-
-
-
-</Tab>
+  <Tab title="خصائص">
+    | خصائص              | النوع       | الوصف                                            |
+    | ------------------ | ----------- | ------------------------------------------------ |
+    | تعطيل              | قيمة منطقية | يشير إلى ما إذا كانت المساحة النصية معطلة.       |
+    | الحد الأدنى للأسطر | رقم         | العدد الأدنى للأسطر الظاهرة للمساحة النصية.      |
+    | onChange           | وظيفة       | دالة الاستدعاء تُشغّل عند تغيّر محتوى منطقة النص |
+    | نص توضيحي          | نص          | النص المُوضّح عندما تكون منطقة النص فارغة        |
+    | القيمة             | نص          | القيمة الحالية لمنطقة النص                       |
+  </Tab>
 </Tabs>
@@ -8,35 +8,29 @@ image: /images/user-guide/table-views/table.png
 </Frame>

 <Tabs>
-<Tab title="الاستخدام">
+  <Tab title="الاستخدام">
+    ```jsx
+    import { Toggle } from "twenty-ui/input";

-```jsx
-import { Toggle } from "twenty-ui/input";
+    export const MyComponent = () => {
+      return (
+        <Toggle
+        value = {true}
+        onChange = {()=>console.log('تم تشغيل حدث onChange')}
+        color="green"
+        toggleSize = "medium"
+        />
+      );
+    };
+    ```
+  </Tab>

-export const MyComponent = () => {
-  return (
-    <Toggle
-    value = {true}
-    onChange = {()=>console.log('تم تشغيل حدث onChange')}
-    color="green"
-    toggleSize = "medium"
-    />
-  );
-};
-```
-
-</Tab>
-<Tab title="الخصائص">
-
-
-| الخصائص     | النوع       | الوصف                                                                       | الإعداد الافتراضي |
-| ----------- | ----------- | --------------------------------------------------------------------------- | ----------------- |
-| القيمة      | قيمة منطقية | الحالة الحالية لمفتاح التبديل                                               | `خاطئ`            |
-| عند التغيير | دالة        | دالة الاستدعاء التي يتم تحفيزها عند تغيير حالة مفتاح التبديل                |                   |
-| اللون       | string      | لون التبديل عند كونه                                                        | لون أزرق          |
-| حجم التبديل | نص          | حجم التبديل الذي يؤثر على كل من الطول والوزن. لديها خياران: `صغير` و`متوسط` | متوسط             |
-
-
-
-</Tab>
+  <Tab title="الخصائص">
+    | الخصائص     | النوع       | الوصف                                                                       | الإعداد الافتراضي |
+    | ----------- | ----------- | --------------------------------------------------------------------------- | ----------------- |
+    | القيمة      | قيمة منطقية | الحالة الحالية لمفتاح التبديل                                               | `خاطئ`            |
+    | عند التغيير | دالة        | دالة الاستدعاء التي يتم تحفيزها عند تغيير حالة مفتاح التبديل                |                   |
+    | اللون       | string      | لون التبديل عند كونه                                                        | لون أزرق          |
+    | حجم التبديل | نص          | حجم التبديل الذي يؤثر على كل من الطول والوزن. لديها خياران: `صغير` و`متوسط` | متوسط             |
+  </Tab>
 </Tabs>
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Devessier	2a784d2e24	feat: create workspaces and user workspaces	2026-02-26 18:31:59 +01:00
Devessier	cddf40468f	feat: batch updates	2026-02-26 16:46:37 +01:00
Devessier	b68a8c6886	fix: send id correctly	2026-02-26 16:29:26 +01:00
Devessier	cdd2bb2b37	feat: add missing relation fields + add insertion in function	2026-02-26 16:15:31 +01:00
Devessier	fed7f1b57e	Merge remote-tracking branch 'origin/main' into twenty-for-twenty-app	2026-02-26 13:41:17 +01:00
Devessier	a2d7e18dce	feat: manually create a bunch of things	2026-02-25 17:51:12 +01:00
Devessier	00105454b8	feat: create all cloud user objects	2026-02-25 15:30:59 +01:00
Devessier	e68b9c7062	feat: wip	2026-02-25 11:04:45 +01:00
Devessier	b8d798f302	feat: finish clickhouse user validation and fetch people	2026-02-24 20:17:47 +01:00
Devessier	a1deb09503	feat: fetch users from clickhouse	2026-02-24 19:37:42 +01:00
Devessier	d873a5972f	fix: fix fetching	2026-02-24 18:27:34 +01:00
Devessier	2dc94f2f68	feat: set up env var	2026-02-24 18:14:55 +01:00
Devessier	6d05beb64e	feat: clean	2026-02-24 17:14:41 +01:00
Devessier	453f3d7f91	feat: scaffold	2026-02-24 17:13:26 +01:00