Add syncable NavigationMenuItem entity to core schema (#17232)

Implements a new syncable `navigationMenuItem` entity in the core schema
to replace the workspace `favorite` entity.

## Next Steps
- Frontend integration ([separate
PR](https://github.com/twentyhq/twenty/pull/17268))
- Data migration (separate PR)

packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-flat-entity-properties-to-compare-and-stringify.constant.ts

@@ -7,6 +7,7 @@ import { FLAT_COMMAND_MENU_ITEM_EDITABLE_PROPERTIES } from 'src/engine/metadata-
 import { type MetadataFlatEntity } from 'src/engine/metadata-modules/flat-entity/types/metadata-flat-entity.type';
 import { FLAT_FIELD_METADATA_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-field-metadata/constants/flat-field-metadata-editable-properties.constant';
 import { FLAT_FRONT_COMPONENT_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-front-component/constants/flat-front-component-editable-properties.constant';
+import { FLAT_NAVIGATION_MENU_ITEM_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-navigation-menu-item/constants/flat-navigation-menu-item-editable-properties.constant';
 import { FLAT_OBJECT_METADATA_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-object-metadata/constants/flat-object-metadata-editable-properties.constant';
 import { FLAT_PAGE_LAYOUT_TAB_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-page-layout-tab/constants/flat-page-layout-tab-editable-properties.constant';
 import { FLAT_PAGE_LAYOUT_WIDGET_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-page-layout-widget/constants/flat-page-layout-widget-editable-properties.constant';
@@ -148,6 +149,10 @@ export const ALL_FLAT_ENTITY_PROPERTIES_TO_COMPARE_AND_STRINGIFY = {
     propertiesToCompare: [...FLAT_COMMAND_MENU_ITEM_EDITABLE_PROPERTIES],
     propertiesToStringify: [],
   },
+  navigationMenuItem: {
+    propertiesToCompare: [...FLAT_NAVIGATION_MENU_ITEM_EDITABLE_PROPERTIES],
+    propertiesToStringify: [],
+  },
   rowLevelPermissionPredicate: {
     propertiesToCompare: [
       ...FLAT_ROW_LEVEL_PERMISSION_PREDICATE_EDITABLE_PROPERTIES,

packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-entity-by-metadata-name.constant.ts

@@ -8,6 +8,7 @@ import { DatabaseEventTriggerEntity } from 'src/engine/metadata-modules/database
 import { FieldMetadataEntity } from 'src/engine/metadata-modules/field-metadata/field-metadata.entity';
 import { FrontComponentEntity } from 'src/engine/metadata-modules/front-component/entities/front-component.entity';
 import { IndexMetadataEntity } from 'src/engine/metadata-modules/index-metadata/index-metadata.entity';
+import { NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
 import { ObjectMetadataEntity } from 'src/engine/metadata-modules/object-metadata/object-metadata.entity';
 import { PageLayoutTabEntity } from 'src/engine/metadata-modules/page-layout-tab/entities/page-layout-tab.entity';
 import { PageLayoutWidgetEntity } from 'src/engine/metadata-modules/page-layout-widget/entities/page-layout-widget.entity';
@@ -49,4 +50,5 @@ export const ALL_METADATA_ENTITY_BY_METADATA_NAME = {
   role: RoleEntity,
   agent: AgentEntity,
   commandMenuItem: CommandMenuItemEntity,
+  navigationMenuItem: NavigationMenuItemEntity,
 } as const satisfies Record<AllMetadataName, EntityTarget<ObjectLiteral>>;

packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-relations.constant.ts

@@ -91,6 +91,24 @@ export const ALL_METADATA_RELATIONS = {
     },
     oneToMany: {},
   },
+  navigationMenuItem: {
+    manyToOne: {
+      workspace: null,
+      userWorkspace: null,
+      application: null,
+      targetObjectMetadata: {
+        metadataName: 'objectMetadata',
+        flatEntityForeignKeyAggregator: null,
+        foreignKey: 'targetObjectMetadataId',
+      },
+      folder: {
+        metadataName: 'navigationMenuItem',
+        flatEntityForeignKeyAggregator: null,
+        foreignKey: 'folderId',
+      },
+    },
+    oneToMany: {},
+  },
   fieldMetadata: {
     manyToOne: {
       object: {

packages/twenty-server/src/engine/metadata-modules/flat-entity/constant/all-metadata-required-metadata-for-validation.constant.ts

@@ -65,6 +65,10 @@ export const ALL_METADATA_REQUIRED_METADATA_FOR_VALIDATION = {
   commandMenuItem: {
     objectMetadata: true,
   },
+  navigationMenuItem: {
+    objectMetadata: true,
+    view: true,
+  },
   pageLayout: {
     objectMetadata: true,
   },

packages/twenty-server/src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type.ts

@@ -2,9 +2,12 @@ import { type AllFlatEntityTypesByMetadataName } from 'src/engine/metadata-modul
 import { type FlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-maps.type';
 import { type MetadataFlatEntity } from 'src/engine/metadata-modules/flat-entity/types/metadata-flat-entity.type';
 import { type MetadataToFlatEntityMapsKey } from 'src/engine/metadata-modules/flat-entity/types/metadata-to-flat-entity-maps-key';
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
 
 export type AllFlatEntityMaps = {
   [P in keyof AllFlatEntityTypesByMetadataName as MetadataToFlatEntityMapsKey<P>]: FlatEntityMaps<
     MetadataFlatEntity<P>
   >;
+} & {
+  flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
 };

packages/twenty-server/src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name.ts

@@ -6,6 +6,7 @@ import { type MetadataEntity } from 'src/engine/metadata-modules/flat-entity/typ
 import { type FlatFieldMetadata } from 'src/engine/metadata-modules/flat-field-metadata/types/flat-field-metadata.type';
 import { type FlatFrontComponent } from 'src/engine/metadata-modules/flat-front-component/types/flat-front-component.type';
 import { type FlatIndexMetadata } from 'src/engine/metadata-modules/flat-index-metadata/types/flat-index-metadata.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
 import { type FlatObjectMetadata } from 'src/engine/metadata-modules/flat-object-metadata/types/flat-object-metadata.type';
 import { type FlatPageLayoutTab } from 'src/engine/metadata-modules/flat-page-layout-tab/types/flat-page-layout-tab.type';
 import { type FlatPageLayoutWidget } from 'src/engine/metadata-modules/flat-page-layout-widget/types/flat-page-layout-widget.type';
@@ -18,6 +19,7 @@ import { type FlatViewFilterGroup } from 'src/engine/metadata-modules/flat-view-
 import { type FlatViewFilter } from 'src/engine/metadata-modules/flat-view-filter/types/flat-view-filter.type';
 import { type FlatViewGroup } from 'src/engine/metadata-modules/flat-view-group/types/flat-view-group.type';
 import { type FlatView } from 'src/engine/metadata-modules/flat-view/types/flat-view.type';
+import { type NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
 import { type FlatRouteTrigger } from 'src/engine/metadata-modules/route-trigger/types/flat-route-trigger.type';
 import { type FlatRowLevelPermissionPredicateGroup } from 'src/engine/metadata-modules/row-level-permission-predicate/types/flat-row-level-permission-predicate-group.type';
 import { type FlatRowLevelPermissionPredicate } from 'src/engine/metadata-modules/row-level-permission-predicate/types/flat-row-level-permission-predicate.type';
@@ -57,6 +59,11 @@ import {
   type DeleteIndexAction,
   type UpdateIndexAction,
 } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/index/types/workspace-migration-index-action';
+import {
+  type CreateNavigationMenuItemAction,
+  type DeleteNavigationMenuItemAction,
+  type UpdateNavigationMenuItemAction,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/types/workspace-migration-navigation-menu-item-action.type';
 import {
   type CreateObjectAction,
   type DeleteObjectAction,
@@ -310,6 +317,15 @@ export type AllFlatEntityTypesByMetadataName = {
     flatEntity: FlatCommandMenuItem;
     entity: MetadataEntity<'commandMenuItem'>;
   };
+  navigationMenuItem: {
+    actions: {
+      create: CreateNavigationMenuItemAction;
+      update: UpdateNavigationMenuItemAction;
+      delete: DeleteNavigationMenuItemAction;
+    };
+    flatEntity: FlatNavigationMenuItem;
+    entity: NavigationMenuItemEntity;
+  };
   pageLayout: {
     actions: {
       create: CreatePageLayoutAction;

packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/get-metadata-related-metadata-names.util.spec.ts.snap

@@ -38,6 +38,13 @@ exports[`getMetadataRelatedMetadataNames should return related metadata names fo
 ]
 `;
 
+exports[`getMetadataRelatedMetadataNames should return related metadata names for navigationMenuItem 1`] = `
+[
+  "objectMetadata",
+  "navigationMenuItem",
+]
+`;
+
 exports[`getMetadataRelatedMetadataNames should return related metadata names for objectMetadata 1`] = `
 [
   "fieldMetadata",

packages/twenty-server/src/engine/metadata-modules/flat-entity/utils/__tests__/__snapshots__/sort-metadata-names-children-first.util.spec.ts.snap

@@ -1,9 +1,10 @@
-// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+// Jest Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`sortMetadataNamesChildrenFirst should return metadata names sorted with children first (most manyToOne relations first) 1`] = `
 [
   "rowLevelPermissionPredicate",
   "viewFilter",
+  "navigationMenuItem",
   "pageLayoutWidget",
   "viewField",
   "commandMenuItem",

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/constants/flat-navigation-menu-item-editable-properties.constant.ts

@@ -0,0 +1,7 @@
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+
+export const FLAT_NAVIGATION_MENU_ITEM_EDITABLE_PROPERTIES = [
+  'position',
+  'folderId',
+  'name',
+] as const satisfies (keyof FlatNavigationMenuItem)[];

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/flat-navigation-menu-item.module.ts

@@ -0,0 +1,16 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+
+import { WorkspaceManyOrAllFlatEntityMapsCacheModule } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module';
+import { WorkspaceFlatNavigationMenuItemMapCacheService } from 'src/engine/metadata-modules/flat-navigation-menu-item/services/workspace-flat-navigation-menu-item-map-cache.service';
+import { NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+
+@Module({
+  imports: [
+    TypeOrmModule.forFeature([NavigationMenuItemEntity]),
+    WorkspaceManyOrAllFlatEntityMapsCacheModule,
+  ],
+  providers: [WorkspaceFlatNavigationMenuItemMapCacheService],
+  exports: [WorkspaceFlatNavigationMenuItemMapCacheService],
+})
+export class FlatNavigationMenuItemModule {}

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/services/workspace-flat-navigation-menu-item-map-cache.service.ts

@@ -0,0 +1,52 @@
+import { Injectable } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+
+import { Repository } from 'typeorm';
+
+import { WorkspaceCacheProvider } from 'src/engine/workspace-cache/interfaces/workspace-cache-provider.service';
+
+import { createEmptyFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/constant/create-empty-flat-entity-maps.constant';
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { addFlatNavigationMenuItemToMapsAndUpdateIndex } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/add-flat-navigation-menu-item-to-maps-and-update-index.util';
+import { fromNavigationMenuItemEntityToFlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/from-navigation-menu-item-entity-to-flat-navigation-menu-item.util';
+import { NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+import { WorkspaceCache } from 'src/engine/workspace-cache/decorators/workspace-cache.decorator';
+
+@Injectable()
+@WorkspaceCache('flatNavigationMenuItemMaps')
+export class WorkspaceFlatNavigationMenuItemMapCacheService extends WorkspaceCacheProvider<FlatNavigationMenuItemMaps> {
+  constructor(
+    @InjectRepository(NavigationMenuItemEntity)
+    private readonly navigationMenuItemRepository: Repository<NavigationMenuItemEntity>,
+  ) {
+    super();
+  }
+
+  async computeForCache(
+    workspaceId: string,
+  ): Promise<FlatNavigationMenuItemMaps> {
+    const navigationMenuItems = await this.navigationMenuItemRepository.find({
+      where: { workspaceId },
+      withDeleted: true,
+    });
+
+    const flatNavigationMenuItemMaps = {
+      ...createEmptyFlatEntityMaps(),
+      byUserWorkspaceIdAndFolderId: {},
+    };
+
+    for (const navigationMenuItemEntity of navigationMenuItems) {
+      const flatNavigationMenuItem =
+        fromNavigationMenuItemEntityToFlatNavigationMenuItem(
+          navigationMenuItemEntity,
+        );
+
+      addFlatNavigationMenuItemToMapsAndUpdateIndex({
+        flatNavigationMenuItem,
+        flatNavigationMenuItemMaps,
+      });
+    }
+
+    return flatNavigationMenuItemMaps;
+  }
+}

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type.ts

@@ -0,0 +1,9 @@
+import { type FlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/flat-entity-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+
+export type FlatNavigationMenuItemMaps =
+  FlatEntityMaps<FlatNavigationMenuItem> & {
+    byUserWorkspaceIdAndFolderId: Partial<
+      Record<string, Partial<Record<string, FlatNavigationMenuItem[]>>>
+    >;
+  };

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type.ts

@@ -0,0 +1,4 @@
+import { type FlatEntityFrom } from 'src/engine/metadata-modules/flat-entity/types/flat-entity.type';
+import { type NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+
+export type FlatNavigationMenuItem = FlatEntityFrom<NavigationMenuItemEntity>;

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/add-flat-navigation-menu-item-to-maps-and-update-index.util.ts

@@ -0,0 +1,41 @@
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { addFlatEntityToFlatEntityMapsThroughMutationOrThrow } from 'src/engine/workspace-manager/workspace-migration/utils/add-flat-entity-to-flat-entity-maps-through-mutation-or-throw.util';
+
+export const addFlatNavigationMenuItemToMapsAndUpdateIndex = ({
+  flatNavigationMenuItem,
+  flatNavigationMenuItemMaps,
+}: {
+  flatNavigationMenuItem: FlatNavigationMenuItem;
+  flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+}): void => {
+  addFlatEntityToFlatEntityMapsThroughMutationOrThrow({
+    flatEntity: flatNavigationMenuItem,
+    flatEntityMapsToMutate: flatNavigationMenuItemMaps,
+  });
+
+  const userWorkspaceIdKey = flatNavigationMenuItem.userWorkspaceId ?? 'null';
+  const folderIdKey = flatNavigationMenuItem.folderId ?? 'null';
+
+  if (
+    !flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[userWorkspaceIdKey]
+  ) {
+    flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+      userWorkspaceIdKey
+    ] = {};
+  }
+
+  if (
+    !flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+      userWorkspaceIdKey
+    ][folderIdKey]
+  ) {
+    flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[userWorkspaceIdKey][
+      folderIdKey
+    ] = [];
+  }
+
+  flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[userWorkspaceIdKey][
+    folderIdKey
+  ].push(flatNavigationMenuItem);
+};

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/delete-flat-navigation-menu-item-from-maps-and-index.util.ts

@@ -0,0 +1,22 @@
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { removeFlatNavigationMenuItemFromIndex } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/remove-flat-navigation-menu-item-from-index.util';
+import { deleteFlatEntityFromFlatEntityMapsThroughMutationOrThrow } from 'src/engine/workspace-manager/workspace-migration/utils/delete-flat-entity-from-flat-entity-maps-through-mutation-or-throw.util';
+
+export const deleteFlatNavigationMenuItemFromMapsAndIndex = ({
+  flatNavigationMenuItem,
+  flatNavigationMenuItemMaps,
+}: {
+  flatNavigationMenuItem: FlatNavigationMenuItem;
+  flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+}): void => {
+  removeFlatNavigationMenuItemFromIndex({
+    flatNavigationMenuItem,
+    flatNavigationMenuItemMaps,
+  });
+
+  deleteFlatEntityFromFlatEntityMapsThroughMutationOrThrow({
+    entityToDeleteId: flatNavigationMenuItem.id,
+    flatEntityMapsToMutate: flatNavigationMenuItemMaps,
+  });
+};

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/from-create-navigation-menu-item-input-to-flat-navigation-menu-item-to-create.util.ts

@@ -0,0 +1,59 @@
+import { isDefined } from 'twenty-shared/utils';
+import { v4 as uuidv4 } from 'uuid';
+
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { type CreateNavigationMenuItemInput } from 'src/engine/metadata-modules/navigation-menu-item/dtos/create-navigation-menu-item.input';
+
+export const fromCreateNavigationMenuItemInputToFlatNavigationMenuItemToCreate =
+  ({
+    createNavigationMenuItemInput,
+    workspaceId,
+    applicationId,
+    flatNavigationMenuItemMaps,
+  }: {
+    createNavigationMenuItemInput: CreateNavigationMenuItemInput;
+    workspaceId: string;
+    applicationId: string;
+    flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+  }): FlatNavigationMenuItem => {
+    const id = uuidv4();
+    const now = new Date().toISOString();
+
+    let position = createNavigationMenuItemInput.position;
+
+    if (!isDefined(position)) {
+      const userWorkspaceIdKey =
+        createNavigationMenuItemInput.userWorkspaceId ?? 'null';
+      const folderIdKey = createNavigationMenuItemInput.folderId ?? 'null';
+
+      const existingItems =
+        flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+          userWorkspaceIdKey
+        ]?.[folderIdKey] ?? [];
+
+      const maxPosition = existingItems.reduce(
+        (max, item) => Math.max(max, item.position),
+        0,
+      );
+
+      position = maxPosition + 1;
+    }
+
+    return {
+      id,
+      universalIdentifier: id,
+      userWorkspaceId: createNavigationMenuItemInput.userWorkspaceId ?? null,
+      targetRecordId: createNavigationMenuItemInput.targetRecordId ?? null,
+      targetObjectMetadataId:
+        createNavigationMenuItemInput.targetObjectMetadataId ?? null,
+      viewId: createNavigationMenuItemInput.viewId ?? null,
+      folderId: createNavigationMenuItemInput.folderId ?? null,
+      name: createNavigationMenuItemInput.name ?? null,
+      position,
+      workspaceId,
+      applicationId,
+      createdAt: now,
+      updatedAt: now,
+    };
+  };

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/from-delete-navigation-menu-item-input-to-flat-navigation-menu-item-or-throw.util.ts

@@ -0,0 +1,32 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import {
+  NavigationMenuItemException,
+  NavigationMenuItemExceptionCode,
+} from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception';
+
+export const fromDeleteNavigationMenuItemInputToFlatNavigationMenuItemOrThrow =
+  ({
+    flatNavigationMenuItemMaps,
+    navigationMenuItemId,
+  }: {
+    flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+    navigationMenuItemId: string;
+  }): FlatNavigationMenuItem => {
+    const existingFlatNavigationMenuItem = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: navigationMenuItemId,
+      flatEntityMaps: flatNavigationMenuItemMaps,
+    });
+
+    if (!isDefined(existingFlatNavigationMenuItem)) {
+      throw new NavigationMenuItemException(
+        'Navigation menu item not found',
+        NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+      );
+    }
+
+    return existingFlatNavigationMenuItem;
+  };

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/from-flat-navigation-menu-item-to-navigation-menu-item-dto.util.ts

@@ -0,0 +1,20 @@
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { type NavigationMenuItemDTO } from 'src/engine/metadata-modules/navigation-menu-item/dtos/navigation-menu-item.dto';
+
+export const fromFlatNavigationMenuItemToNavigationMenuItemDto = (
+  flatNavigationMenuItem: FlatNavigationMenuItem,
+): NavigationMenuItemDTO => ({
+  id: flatNavigationMenuItem.id,
+  userWorkspaceId: flatNavigationMenuItem.userWorkspaceId ?? undefined,
+  targetRecordId: flatNavigationMenuItem.targetRecordId ?? undefined,
+  targetObjectMetadataId:
+    flatNavigationMenuItem.targetObjectMetadataId ?? undefined,
+  viewId: flatNavigationMenuItem.viewId ?? undefined,
+  folderId: flatNavigationMenuItem.folderId ?? undefined,
+  name: flatNavigationMenuItem.name ?? undefined,
+  position: flatNavigationMenuItem.position,
+  workspaceId: flatNavigationMenuItem.workspaceId,
+  applicationId: flatNavigationMenuItem.applicationId ?? undefined,
+  createdAt: new Date(flatNavigationMenuItem.createdAt),
+  updatedAt: new Date(flatNavigationMenuItem.updatedAt),
+});

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/from-navigation-menu-item-entity-to-flat-navigation-menu-item.util.ts

@@ -0,0 +1,22 @@
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { type NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+
+export const fromNavigationMenuItemEntityToFlatNavigationMenuItem = (
+  navigationMenuItemEntity: NavigationMenuItemEntity,
+): FlatNavigationMenuItem => {
+  return {
+    id: navigationMenuItemEntity.id,
+    userWorkspaceId: navigationMenuItemEntity.userWorkspaceId,
+    targetRecordId: navigationMenuItemEntity.targetRecordId,
+    targetObjectMetadataId: navigationMenuItemEntity.targetObjectMetadataId,
+    viewId: navigationMenuItemEntity.viewId,
+    folderId: navigationMenuItemEntity.folderId,
+    name: navigationMenuItemEntity.name,
+    position: navigationMenuItemEntity.position,
+    workspaceId: navigationMenuItemEntity.workspaceId,
+    universalIdentifier: navigationMenuItemEntity.universalIdentifier,
+    applicationId: navigationMenuItemEntity.applicationId,
+    createdAt: navigationMenuItemEntity.createdAt.toISOString(),
+    updatedAt: navigationMenuItemEntity.updatedAt.toISOString(),
+  };
+};

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/from-update-navigation-menu-item-input-to-flat-navigation-menu-item-to-update-or-throw.util.ts

@@ -0,0 +1,46 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
+import { FLAT_NAVIGATION_MENU_ITEM_EDITABLE_PROPERTIES } from 'src/engine/metadata-modules/flat-navigation-menu-item/constants/flat-navigation-menu-item-editable-properties.constant';
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { type UpdateNavigationMenuItemInput } from 'src/engine/metadata-modules/navigation-menu-item/dtos/update-navigation-menu-item.input';
+import {
+  NavigationMenuItemException,
+  NavigationMenuItemExceptionCode,
+} from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception';
+import { mergeUpdateInExistingRecord } from 'src/utils/merge-update-in-existing-record.util';
+
+export const fromUpdateNavigationMenuItemInputToFlatNavigationMenuItemToUpdateOrThrow =
+  ({
+    flatNavigationMenuItemMaps,
+    updateNavigationMenuItemInput,
+  }: {
+    flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+    updateNavigationMenuItemInput: UpdateNavigationMenuItemInput & {
+      id: string;
+    };
+  }): FlatNavigationMenuItem => {
+    const existingFlatNavigationMenuItem = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: updateNavigationMenuItemInput.id,
+      flatEntityMaps: flatNavigationMenuItemMaps,
+    });
+
+    if (!isDefined(existingFlatNavigationMenuItem)) {
+      throw new NavigationMenuItemException(
+        'Navigation menu item not found',
+        NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+      );
+    }
+
+    const { id: _id, ...updates } = updateNavigationMenuItemInput;
+
+    return {
+      ...mergeUpdateInExistingRecord({
+        existing: existingFlatNavigationMenuItem,
+        properties: [...FLAT_NAVIGATION_MENU_ITEM_EDITABLE_PROPERTIES],
+        update: updates,
+      }),
+      updatedAt: new Date().toISOString(),
+    };
+  };

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/remove-flat-navigation-menu-item-from-index.util.ts

@@ -0,0 +1,51 @@
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+
+export const removeFlatNavigationMenuItemFromIndex = ({
+  flatNavigationMenuItem,
+  flatNavigationMenuItemMaps,
+}: {
+  flatNavigationMenuItem: FlatNavigationMenuItem;
+  flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+}): void => {
+  const userWorkspaceIdKey = flatNavigationMenuItem.userWorkspaceId ?? 'null';
+  const folderIdKey = flatNavigationMenuItem.folderId ?? 'null';
+
+  const itemsArray =
+    flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+      userWorkspaceIdKey
+    ]?.[folderIdKey];
+
+  if (!itemsArray) {
+    return;
+  }
+
+  const index = itemsArray.findIndex(
+    (item) => item.id === flatNavigationMenuItem.id,
+  );
+
+  if (index === -1) {
+    return;
+  }
+
+  itemsArray.splice(index, 1);
+
+  if (itemsArray.length > 0) {
+    return;
+  }
+
+  const userWorkspaceMap =
+    flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[userWorkspaceIdKey];
+
+  if (!userWorkspaceMap) {
+    return;
+  }
+
+  delete userWorkspaceMap[folderIdKey];
+
+  if (Object.keys(userWorkspaceMap).length === 0) {
+    delete flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+      userWorkspaceIdKey
+    ];
+  }
+};

packages/twenty-server/src/engine/metadata-modules/flat-navigation-menu-item/utils/replace-flat-navigation-menu-item-in-maps-and-update-index.util.ts

@@ -0,0 +1,91 @@
+import { isDefined } from 'twenty-shared/utils';
+
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { type FlatNavigationMenuItem } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item.type';
+import { removeFlatNavigationMenuItemFromIndex } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/remove-flat-navigation-menu-item-from-index.util';
+import { replaceFlatEntityInFlatEntityMapsThroughMutationOrThrow } from 'src/engine/workspace-manager/workspace-migration/utils/replace-flat-entity-in-flat-entity-maps-through-mutation-or-throw.util';
+
+export const replaceFlatNavigationMenuItemInMapsAndUpdateIndex = ({
+  fromFlatNavigationMenuItem,
+  toFlatNavigationMenuItem,
+  flatNavigationMenuItemMaps,
+}: {
+  fromFlatNavigationMenuItem: FlatNavigationMenuItem;
+  toFlatNavigationMenuItem: FlatNavigationMenuItem;
+  flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+}): void => {
+  const oldUserWorkspaceIdKey =
+    fromFlatNavigationMenuItem.userWorkspaceId ?? 'null';
+  const oldFolderIdKey = fromFlatNavigationMenuItem.folderId ?? 'null';
+  const newUserWorkspaceIdKey =
+    toFlatNavigationMenuItem.userWorkspaceId ?? 'null';
+  const newFolderIdKey = toFlatNavigationMenuItem.folderId ?? 'null';
+
+  const groupChanged =
+    oldUserWorkspaceIdKey !== newUserWorkspaceIdKey ||
+    oldFolderIdKey !== newFolderIdKey;
+
+  if (groupChanged) {
+    removeFlatNavigationMenuItemFromIndex({
+      flatNavigationMenuItem: fromFlatNavigationMenuItem,
+      flatNavigationMenuItemMaps,
+    });
+  }
+
+  replaceFlatEntityInFlatEntityMapsThroughMutationOrThrow({
+    flatEntity: toFlatNavigationMenuItem,
+    flatEntityMapsToMutate: flatNavigationMenuItemMaps,
+  });
+
+  if (groupChanged) {
+    if (
+      !flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+        newUserWorkspaceIdKey
+      ]
+    ) {
+      flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+        newUserWorkspaceIdKey
+      ] = {};
+    }
+
+    if (
+      !flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+        newUserWorkspaceIdKey
+      ][newFolderIdKey]
+    ) {
+      flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+        newUserWorkspaceIdKey
+      ][newFolderIdKey] = [];
+    }
+
+    flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+      newUserWorkspaceIdKey
+    ][newFolderIdKey].push(toFlatNavigationMenuItem);
+  } else {
+    const itemsArray =
+      flatNavigationMenuItemMaps.byUserWorkspaceIdAndFolderId[
+        newUserWorkspaceIdKey
+      ]?.[newFolderIdKey];
+
+    if (!itemsArray) {
+      return;
+    }
+
+    const index = itemsArray.findIndex(
+      (item) => item.id === toFlatNavigationMenuItem.id,
+    );
+
+    if (index === -1) {
+      return;
+    }
+
+    const updatedItem =
+      flatNavigationMenuItemMaps.byId[toFlatNavigationMenuItem.id];
+
+    if (!isDefined(updatedItem)) {
+      return;
+    }
+
+    itemsArray[index] = updatedItem;
+  }
+};

packages/twenty-server/src/engine/metadata-modules/metadata-engine.module.ts

@@ -4,6 +4,7 @@ import { AiAgentMonitorModule } from 'src/engine/metadata-modules/ai/ai-agent-mo
 import { AiAgentModule } from 'src/engine/metadata-modules/ai/ai-agent/ai-agent.module';
 import { AiChatModule } from 'src/engine/metadata-modules/ai/ai-chat/ai-chat.module';
 import { CommandMenuItemModule } from 'src/engine/metadata-modules/command-menu-item/command-menu-item.module';
+import { NavigationMenuItemModule } from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.module';
 import { CronTriggerModule } from 'src/engine/metadata-modules/cron-trigger/cron-trigger.module';
 import { DataSourceModule } from 'src/engine/metadata-modules/data-source/data-source.module';
 import { DatabaseEventTriggerModule } from 'src/engine/metadata-modules/database-event-trigger/database-event-trigger.module';
@@ -31,6 +32,7 @@ import { WorkspaceMetadataVersionModule } from 'src/engine/metadata-modules/work
     ServerlessFunctionLayerModule,
     SkillModule,
     CommandMenuItemModule,
+    NavigationMenuItemModule,
     AiAgentModule,
     AiAgentMonitorModule,
     AiChatModule,
@@ -52,6 +54,7 @@ import { WorkspaceMetadataVersionModule } from 'src/engine/metadata-modules/work
     ServerlessFunctionModule,
     SkillModule,
     CommandMenuItemModule,
+    NavigationMenuItemModule,
     AiAgentModule,
     AiChatModule,
     ViewModule,

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/dtos/create-navigation-menu-item.input.ts

@@ -0,0 +1,44 @@
+import { Field, InputType, Int } from '@nestjs/graphql';
+
+import { IsInt, IsOptional, IsString, IsUUID, Min } from 'class-validator';
+
+import { UUIDScalarType } from 'src/engine/api/graphql/workspace-schema-builder/graphql-types/scalars';
+
+@InputType()
+export class CreateNavigationMenuItemInput {
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  userWorkspaceId?: string;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  targetRecordId?: string | null;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  targetObjectMetadataId?: string | null;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  viewId?: string | null;
+
+  @IsOptional()
+  @IsString()
+  @Field(() => String, { nullable: true })
+  name?: string | null;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  folderId?: string;
+
+  @IsInt()
+  @Min(0)
+  @IsOptional()
+  @Field(() => Int, { nullable: true })
+  position?: number;
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/dtos/navigation-menu-item.dto.ts

@@ -0,0 +1,67 @@
+import { Field, HideField, ObjectType } from '@nestjs/graphql';
+
+import {
+  IsDateString,
+  IsNotEmpty,
+  IsNumber,
+  IsOptional,
+  IsUUID,
+} from 'class-validator';
+
+import { UUIDScalarType } from 'src/engine/api/graphql/workspace-schema-builder/graphql-types/scalars';
+
+@ObjectType('NavigationMenuItem')
+export class NavigationMenuItemDTO {
+  @IsUUID()
+  @IsNotEmpty()
+  @Field(() => UUIDScalarType)
+  id: string;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  userWorkspaceId?: string;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  targetRecordId?: string | null;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  targetObjectMetadataId?: string | null;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  viewId?: string | null;
+
+  @IsOptional()
+  @Field(() => String, { nullable: true })
+  name?: string | null;
+
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  folderId?: string;
+
+  @IsNumber()
+  @IsNotEmpty()
+  @Field()
+  position: number;
+
+  @HideField()
+  workspaceId: string;
+
+  @Field(() => UUIDScalarType, { nullable: true })
+  applicationId?: string;
+
+  @IsDateString()
+  @Field()
+  createdAt: Date;
+
+  @IsDateString()
+  @Field()
+  updatedAt: Date;
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/dtos/update-navigation-menu-item.input.ts

@@ -0,0 +1,50 @@
+import { Field, InputType, Int } from '@nestjs/graphql';
+
+import { Type } from 'class-transformer';
+import {
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Min,
+  ValidateNested,
+} from 'class-validator';
+
+import { UUIDScalarType } from 'src/engine/api/graphql/workspace-schema-builder/graphql-types/scalars';
+
+@InputType()
+export class UpdateNavigationMenuItemInput {
+  @IsUUID()
+  @IsOptional()
+  @Field(() => UUIDScalarType, { nullable: true })
+  folderId?: string | null;
+
+  @IsInt()
+  @Min(0)
+  @IsOptional()
+  @Field(() => Int, { nullable: true })
+  position?: number;
+
+  @IsOptional()
+  @IsString()
+  @Field(() => String, { nullable: true })
+  name?: string | null;
+}
+
+@InputType()
+export class UpdateOneNavigationMenuItemInput {
+  @IsUUID()
+  @IsNotEmpty()
+  @Field(() => UUIDScalarType, {
+    description: 'The id of the record to update',
+  })
+  id!: string;
+
+  @Type(() => UpdateNavigationMenuItemInput)
+  @ValidateNested()
+  @Field(() => UpdateNavigationMenuItemInput, {
+    description: 'The record to update',
+  })
+  update!: UpdateNavigationMenuItemInput;
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity.ts

@@ -0,0 +1,94 @@
+import {
+  Check,
+  Column,
+  CreateDateColumn,
+  Entity,
+  Index,
+  JoinColumn,
+  ManyToOne,
+  PrimaryGeneratedColumn,
+  type Relation,
+  UpdateDateColumn,
+} from 'typeorm';
+
+import { UserWorkspaceEntity } from 'src/engine/core-modules/user-workspace/user-workspace.entity';
+import { ObjectMetadataEntity } from 'src/engine/metadata-modules/object-metadata/object-metadata.entity';
+import { SyncableEntity } from 'src/engine/workspace-manager/types/syncable-entity.interface';
+
+@Entity({ name: 'navigationMenuItem', schema: 'core' })
+@Index('IDX_NAVIGATION_MENU_ITEM_USER_WORKSPACE_ID_WORKSPACE_ID', [
+  'userWorkspaceId',
+  'workspaceId',
+])
+@Index('IDX_NAVIGATION_MENU_ITEM_TARGET_RECORD_OBJ_METADATA_WS_ID', [
+  'targetRecordId',
+  'targetObjectMetadataId',
+  'workspaceId',
+])
+@Index('IDX_NAVIGATION_MENU_ITEM_FOLDER_ID_WORKSPACE_ID', [
+  'folderId',
+  'workspaceId',
+])
+@Index('IDX_NAVIGATION_MENU_ITEM_VIEW_ID_WORKSPACE_ID', [
+  'viewId',
+  'workspaceId',
+])
+@Check(
+  'CHK_navigation_menu_item_target_fields',
+  '("targetRecordId" IS NULL AND "targetObjectMetadataId" IS NULL) OR ("targetRecordId" IS NOT NULL AND "targetObjectMetadataId" IS NOT NULL)',
+)
+export class NavigationMenuItemEntity
+  extends SyncableEntity
+  implements Required<NavigationMenuItemEntity>
+{
+  @PrimaryGeneratedColumn('uuid')
+  id: string;
+
+  @ManyToOne(() => UserWorkspaceEntity, {
+    onDelete: 'CASCADE',
+    nullable: true,
+  })
+  @JoinColumn({ name: 'userWorkspaceId' })
+  userWorkspace: Relation<UserWorkspaceEntity> | null;
+
+  @Column({ nullable: true, type: 'uuid' })
+  userWorkspaceId: string | null;
+
+  @Column({ nullable: true, type: 'uuid' })
+  targetRecordId: string | null;
+
+  @Column({ nullable: true, type: 'uuid' })
+  targetObjectMetadataId: string | null;
+
+  @Column({ nullable: true, type: 'uuid' })
+  viewId: string | null;
+
+  @ManyToOne(() => ObjectMetadataEntity, {
+    onDelete: 'CASCADE',
+    nullable: true,
+  })
+  @JoinColumn({ name: 'targetObjectMetadataId' })
+  targetObjectMetadata: Relation<ObjectMetadataEntity> | null;
+
+  @Column({ nullable: true, type: 'text' })
+  name: string | null;
+
+  @ManyToOne(() => NavigationMenuItemEntity, {
+    onDelete: 'CASCADE',
+    nullable: true,
+  })
+  @JoinColumn({ name: 'folderId' })
+  folder: Relation<NavigationMenuItemEntity> | null;
+
+  @Column({ nullable: true, type: 'uuid' })
+  folderId: string | null;
+
+  @Column({ nullable: false })
+  position: number;
+
+  @CreateDateColumn({ type: 'timestamptz' })
+  createdAt: Date;
+
+  @UpdateDateColumn({ type: 'timestamptz' })
+  updatedAt: Date;
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/interceptors/navigation-menu-item-graphql-api-exception.interceptor.ts

@@ -0,0 +1,24 @@
+import {
+  type CallHandler,
+  type ExecutionContext,
+  Injectable,
+  type NestInterceptor,
+} from '@nestjs/common';
+
+import { type Observable, catchError } from 'rxjs';
+
+import { navigationMenuItemGraphqlApiExceptionHandler } from 'src/engine/metadata-modules/navigation-menu-item/utils/navigation-menu-item-graphql-api-exception-handler.util';
+
+@Injectable()
+export class NavigationMenuItemGraphqlApiExceptionInterceptor
+  implements NestInterceptor
+{
+  intercept(
+    _context: ExecutionContext,
+    next: CallHandler,
+  ): Observable<unknown> {
+    return next
+      .handle()
+      .pipe(catchError(navigationMenuItemGraphqlApiExceptionHandler));
+  }
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception.ts

@@ -0,0 +1,43 @@
+import { type MessageDescriptor } from '@lingui/core';
+import { msg } from '@lingui/core/macro';
+import { assertUnreachable } from 'twenty-shared/utils';
+
+import { CustomException } from 'src/utils/custom-exception';
+
+export enum NavigationMenuItemExceptionCode {
+  NAVIGATION_MENU_ITEM_NOT_FOUND = 'NAVIGATION_MENU_ITEM_NOT_FOUND',
+  INVALID_NAVIGATION_MENU_ITEM_INPUT = 'INVALID_NAVIGATION_MENU_ITEM_INPUT',
+  CIRCULAR_DEPENDENCY = 'CIRCULAR_DEPENDENCY',
+  MAX_DEPTH_EXCEEDED = 'MAX_DEPTH_EXCEEDED',
+}
+
+const getNavigationMenuItemExceptionUserFriendlyMessage = (
+  code: NavigationMenuItemExceptionCode,
+) => {
+  switch (code) {
+    case NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND:
+      return msg`Navigation menu item not found.`;
+    case NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT:
+      return msg`Invalid navigation menu item input.`;
+    case NavigationMenuItemExceptionCode.CIRCULAR_DEPENDENCY:
+      return msg`Circular dependency detected in navigation menu item hierarchy.`;
+    case NavigationMenuItemExceptionCode.MAX_DEPTH_EXCEEDED:
+      return msg`Navigation menu item hierarchy exceeds maximum depth.`;
+    default:
+      assertUnreachable(code);
+  }
+};
+
+export class NavigationMenuItemException extends CustomException<NavigationMenuItemExceptionCode> {
+  constructor(
+    message: string,
+    code: NavigationMenuItemExceptionCode,
+    { userFriendlyMessage }: { userFriendlyMessage?: MessageDescriptor } = {},
+  ) {
+    super(message, code, {
+      userFriendlyMessage:
+        userFriendlyMessage ??
+        getNavigationMenuItemExceptionUserFriendlyMessage(code),
+    });
+  }
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.module.ts

@@ -0,0 +1,31 @@
+import { Module } from '@nestjs/common';
+
+import { ApplicationModule } from 'src/engine/core-modules/application/application.module';
+import { WorkspaceManyOrAllFlatEntityMapsCacheModule } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.module';
+import { FlatNavigationMenuItemModule } from 'src/engine/metadata-modules/flat-navigation-menu-item/flat-navigation-menu-item.module';
+import { NavigationMenuItemGraphqlApiExceptionInterceptor } from 'src/engine/metadata-modules/navigation-menu-item/interceptors/navigation-menu-item-graphql-api-exception.interceptor';
+import { NavigationMenuItemResolver } from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.resolver';
+import { NavigationMenuItemService } from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.service';
+import { NavigationMenuItemAccessService } from 'src/engine/metadata-modules/navigation-menu-item/services/navigation-menu-item-access.service';
+import { PermissionsModule } from 'src/engine/metadata-modules/permissions/permissions.module';
+import { WorkspaceMigrationBuilderGraphqlApiExceptionInterceptor } from 'src/engine/workspace-manager/workspace-migration/interceptors/workspace-migration-builder-graphql-api-exception.interceptor';
+import { WorkspaceMigrationModule } from 'src/engine/workspace-manager/workspace-migration/workspace-migration.module';
+
+@Module({
+  imports: [
+    WorkspaceManyOrAllFlatEntityMapsCacheModule,
+    WorkspaceMigrationModule,
+    ApplicationModule,
+    FlatNavigationMenuItemModule,
+    PermissionsModule,
+  ],
+  providers: [
+    NavigationMenuItemService,
+    NavigationMenuItemAccessService,
+    NavigationMenuItemResolver,
+    NavigationMenuItemGraphqlApiExceptionInterceptor,
+    WorkspaceMigrationBuilderGraphqlApiExceptionInterceptor,
+  ],
+  exports: [NavigationMenuItemService],
+})
+export class NavigationMenuItemModule {}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.resolver.ts

@@ -0,0 +1,108 @@
+import { UseGuards, UseInterceptors } from '@nestjs/common';
+import { Args, Context, Mutation, Query, Resolver } from '@nestjs/graphql';
+
+import { UUIDScalarType } from 'src/engine/api/graphql/workspace-schema-builder/graphql-types/scalars';
+import { ApiKeyEntity } from 'src/engine/core-modules/api-key/api-key.entity';
+import { ApplicationEntity } from 'src/engine/core-modules/application/application.entity';
+import { WorkspaceEntity } from 'src/engine/core-modules/workspace/workspace.entity';
+import { AuthApiKey } from 'src/engine/decorators/auth/auth-api-key.decorator';
+import { AuthUserWorkspaceId } from 'src/engine/decorators/auth/auth-user-workspace-id.decorator';
+import { AuthWorkspace } from 'src/engine/decorators/auth/auth-workspace.decorator';
+import { NoPermissionGuard } from 'src/engine/guards/no-permission.guard';
+import { WorkspaceAuthGuard } from 'src/engine/guards/workspace-auth.guard';
+import { CreateNavigationMenuItemInput } from 'src/engine/metadata-modules/navigation-menu-item/dtos/create-navigation-menu-item.input';
+import { NavigationMenuItemDTO } from 'src/engine/metadata-modules/navigation-menu-item/dtos/navigation-menu-item.dto';
+import { UpdateOneNavigationMenuItemInput } from 'src/engine/metadata-modules/navigation-menu-item/dtos/update-navigation-menu-item.input';
+import { NavigationMenuItemGraphqlApiExceptionInterceptor } from 'src/engine/metadata-modules/navigation-menu-item/interceptors/navigation-menu-item-graphql-api-exception.interceptor';
+import { NavigationMenuItemService } from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.service';
+import { WorkspaceMigrationBuilderGraphqlApiExceptionInterceptor } from 'src/engine/workspace-manager/workspace-migration/interceptors/workspace-migration-builder-graphql-api-exception.interceptor';
+
+@UseGuards(WorkspaceAuthGuard)
+@UseInterceptors(
+  WorkspaceMigrationBuilderGraphqlApiExceptionInterceptor,
+  NavigationMenuItemGraphqlApiExceptionInterceptor,
+)
+@Resolver(() => NavigationMenuItemDTO)
+export class NavigationMenuItemResolver {
+  constructor(
+    private readonly navigationMenuItemService: NavigationMenuItemService,
+  ) {}
+
+  @Query(() => [NavigationMenuItemDTO])
+  @UseGuards(NoPermissionGuard)
+  async navigationMenuItems(
+    @AuthWorkspace() workspace: WorkspaceEntity,
+    @AuthUserWorkspaceId() userWorkspaceId: string | undefined,
+  ): Promise<NavigationMenuItemDTO[]> {
+    return await this.navigationMenuItemService.findAll({
+      workspaceId: workspace.id,
+      userWorkspaceId,
+    });
+  }
+
+  @Query(() => NavigationMenuItemDTO, { nullable: true })
+  @UseGuards(NoPermissionGuard)
+  async navigationMenuItem(
+    @Args('id', { type: () => UUIDScalarType }) id: string,
+    @AuthWorkspace() workspace: WorkspaceEntity,
+  ): Promise<NavigationMenuItemDTO | null> {
+    return await this.navigationMenuItemService.findById({
+      id,
+      workspaceId: workspace.id,
+    });
+  }
+
+  @Mutation(() => NavigationMenuItemDTO)
+  @UseGuards(NoPermissionGuard)
+  async createNavigationMenuItem(
+    @Args('input') input: CreateNavigationMenuItemInput,
+    @AuthWorkspace() workspace: WorkspaceEntity,
+    @AuthUserWorkspaceId() userWorkspaceId: string | undefined,
+    @AuthApiKey() apiKey: ApiKeyEntity | undefined,
+    @Context() context: { req: { application?: ApplicationEntity } },
+  ): Promise<NavigationMenuItemDTO> {
+    return await this.navigationMenuItemService.create({
+      input,
+      workspaceId: workspace.id,
+      authUserWorkspaceId: userWorkspaceId,
+      authApiKeyId: apiKey?.id,
+      authApplicationId: context.req.application?.id,
+    });
+  }
+
+  @Mutation(() => NavigationMenuItemDTO)
+  @UseGuards(NoPermissionGuard)
+  async updateNavigationMenuItem(
+    @Args('input') input: UpdateOneNavigationMenuItemInput,
+    @AuthWorkspace() workspace: WorkspaceEntity,
+    @AuthUserWorkspaceId() userWorkspaceId: string | undefined,
+    @AuthApiKey() apiKey: ApiKeyEntity | undefined,
+    @Context() context: { req: { application?: ApplicationEntity } },
+  ): Promise<NavigationMenuItemDTO> {
+    return await this.navigationMenuItemService.update({
+      input: { ...input.update, id: input.id },
+      workspaceId: workspace.id,
+      authUserWorkspaceId: userWorkspaceId,
+      authApiKeyId: apiKey?.id,
+      authApplicationId: context.req.application?.id,
+    });
+  }
+
+  @Mutation(() => NavigationMenuItemDTO)
+  @UseGuards(NoPermissionGuard)
+  async deleteNavigationMenuItem(
+    @Args('id', { type: () => UUIDScalarType }) id: string,
+    @AuthWorkspace() workspace: WorkspaceEntity,
+    @AuthUserWorkspaceId() userWorkspaceId: string | undefined,
+    @AuthApiKey() apiKey: ApiKeyEntity | undefined,
+    @Context() context: { req: { application?: ApplicationEntity } },
+  ): Promise<NavigationMenuItemDTO> {
+    return await this.navigationMenuItemService.delete({
+      id,
+      workspaceId: workspace.id,
+      authUserWorkspaceId: userWorkspaceId,
+      authApiKeyId: apiKey?.id,
+      authApplicationId: context.req.application?.id,
+    });
+  }
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.service.ts

@@ -0,0 +1,337 @@
+import { Injectable } from '@nestjs/common';
+
+import { isDefined } from 'twenty-shared/utils';
+
+import { ApplicationService } from 'src/engine/core-modules/application/application.service';
+import { WorkspaceManyOrAllFlatEntityMapsCacheService } from 'src/engine/metadata-modules/flat-entity/services/workspace-many-or-all-flat-entity-maps-cache.service';
+import { findFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
+import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
+import { fromCreateNavigationMenuItemInputToFlatNavigationMenuItemToCreate } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/from-create-navigation-menu-item-input-to-flat-navigation-menu-item-to-create.util';
+import { fromDeleteNavigationMenuItemInputToFlatNavigationMenuItemOrThrow } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/from-delete-navigation-menu-item-input-to-flat-navigation-menu-item-or-throw.util';
+import { fromFlatNavigationMenuItemToNavigationMenuItemDto } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/from-flat-navigation-menu-item-to-navigation-menu-item-dto.util';
+import { fromUpdateNavigationMenuItemInputToFlatNavigationMenuItemToUpdateOrThrow } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/from-update-navigation-menu-item-input-to-flat-navigation-menu-item-to-update-or-throw.util';
+import { type CreateNavigationMenuItemInput } from 'src/engine/metadata-modules/navigation-menu-item/dtos/create-navigation-menu-item.input';
+import { type NavigationMenuItemDTO } from 'src/engine/metadata-modules/navigation-menu-item/dtos/navigation-menu-item.dto';
+import { type UpdateNavigationMenuItemInput } from 'src/engine/metadata-modules/navigation-menu-item/dtos/update-navigation-menu-item.input';
+import {
+  NavigationMenuItemException,
+  NavigationMenuItemExceptionCode,
+} from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception';
+import { NavigationMenuItemAccessService } from 'src/engine/metadata-modules/navigation-menu-item/services/navigation-menu-item-access.service';
+import { WorkspaceMigrationBuilderException } from 'src/engine/workspace-manager/workspace-migration/exceptions/workspace-migration-builder-exception';
+import { WorkspaceMigrationValidateBuildAndRunService } from 'src/engine/workspace-manager/workspace-migration/services/workspace-migration-validate-build-and-run-service';
+
+@Injectable()
+export class NavigationMenuItemService {
+  constructor(
+    private readonly workspaceMigrationValidateBuildAndRunService: WorkspaceMigrationValidateBuildAndRunService,
+    private readonly workspaceManyOrAllFlatEntityMapsCacheService: WorkspaceManyOrAllFlatEntityMapsCacheService,
+    private readonly applicationService: ApplicationService,
+    private readonly navigationMenuItemAccessService: NavigationMenuItemAccessService,
+  ) {}
+
+  async findAll({
+    workspaceId,
+    userWorkspaceId,
+  }: {
+    workspaceId: string;
+    userWorkspaceId?: string;
+  }): Promise<NavigationMenuItemDTO[]> {
+    const { flatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    return Object.values(flatNavigationMenuItemMaps.byId)
+      .filter(
+        (item): item is NonNullable<typeof item> =>
+          isDefined(item) &&
+          (!isDefined(item.userWorkspaceId) ||
+            item.userWorkspaceId === userWorkspaceId),
+      )
+      .sort((a, b) => a.position - b.position)
+      .map(fromFlatNavigationMenuItemToNavigationMenuItemDto);
+  }
+
+  async findById({
+    id,
+    workspaceId,
+  }: {
+    id: string;
+    workspaceId: string;
+  }): Promise<NavigationMenuItemDTO | null> {
+    const { flatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    const flatNavigationMenuItem = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: id,
+      flatEntityMaps: flatNavigationMenuItemMaps,
+    });
+
+    if (!isDefined(flatNavigationMenuItem)) {
+      return null;
+    }
+
+    return fromFlatNavigationMenuItemToNavigationMenuItemDto(
+      flatNavigationMenuItem,
+    );
+  }
+
+  async findByIdOrThrow({
+    id,
+    workspaceId,
+  }: {
+    id: string;
+    workspaceId: string;
+  }): Promise<NavigationMenuItemDTO> {
+    const navigationMenuItem = await this.findById({ id, workspaceId });
+
+    if (!isDefined(navigationMenuItem)) {
+      throw new NavigationMenuItemException(
+        'Navigation menu item not found',
+        NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+      );
+    }
+
+    return navigationMenuItem;
+  }
+
+  async create({
+    input,
+    workspaceId,
+    authUserWorkspaceId,
+    authApiKeyId,
+    authApplicationId,
+  }: {
+    input: CreateNavigationMenuItemInput;
+    workspaceId: string;
+    authUserWorkspaceId?: string;
+    authApiKeyId?: string;
+    authApplicationId?: string;
+  }): Promise<NavigationMenuItemDTO> {
+    await this.navigationMenuItemAccessService.canUserCreateNavigationMenuItem({
+      userWorkspaceId: authUserWorkspaceId,
+      workspaceId,
+      apiKeyId: authApiKeyId,
+      applicationId: authApplicationId,
+      inputUserWorkspaceId: input.userWorkspaceId,
+    });
+    const { workspaceCustomFlatApplication } =
+      await this.applicationService.findWorkspaceTwentyStandardAndCustomApplicationOrThrow(
+        { workspaceId },
+      );
+
+    const { flatNavigationMenuItemMaps: existingFlatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    const normalizedInput: CreateNavigationMenuItemInput = {
+      ...input,
+      userWorkspaceId:
+        isDefined(input.userWorkspaceId) && isDefined(authUserWorkspaceId)
+          ? authUserWorkspaceId
+          : input.userWorkspaceId,
+    };
+
+    const flatNavigationMenuItemToCreate =
+      fromCreateNavigationMenuItemInputToFlatNavigationMenuItemToCreate({
+        createNavigationMenuItemInput: normalizedInput,
+        workspaceId,
+        applicationId: workspaceCustomFlatApplication.id,
+        flatNavigationMenuItemMaps: existingFlatNavigationMenuItemMaps,
+      });
+
+    const validateAndBuildResult =
+      await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunWorkspaceMigration(
+        {
+          allFlatEntityOperationByMetadataName: {
+            navigationMenuItem: {
+              flatEntityToCreate: [flatNavigationMenuItemToCreate],
+              flatEntityToDelete: [],
+              flatEntityToUpdate: [],
+            },
+          },
+          workspaceId,
+          isSystemBuild: false,
+        },
+      );
+
+    if (isDefined(validateAndBuildResult)) {
+      throw new WorkspaceMigrationBuilderException(
+        validateAndBuildResult,
+        'Multiple validation errors occurred while creating navigation menu item',
+      );
+    }
+
+    const { flatNavigationMenuItemMaps: recomputedFlatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    return fromFlatNavigationMenuItemToNavigationMenuItemDto(
+      findFlatEntityByIdInFlatEntityMapsOrThrow({
+        flatEntityId: flatNavigationMenuItemToCreate.id,
+        flatEntityMaps: recomputedFlatNavigationMenuItemMaps,
+      }),
+    );
+  }
+
+  async update({
+    input,
+    workspaceId,
+    authUserWorkspaceId,
+    authApiKeyId,
+    authApplicationId,
+  }: {
+    input: UpdateNavigationMenuItemInput & { id: string };
+    workspaceId: string;
+    authUserWorkspaceId?: string;
+    authApiKeyId?: string;
+    authApplicationId?: string;
+  }): Promise<NavigationMenuItemDTO> {
+    const { flatNavigationMenuItemMaps: existingFlatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    const existingNavigationMenuItem = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: input.id,
+      flatEntityMaps: existingFlatNavigationMenuItemMaps,
+    });
+
+    if (isDefined(existingNavigationMenuItem)) {
+      await this.navigationMenuItemAccessService.canUserUpdateNavigationMenuItem(
+        {
+          userWorkspaceId: authUserWorkspaceId,
+          workspaceId,
+          apiKeyId: authApiKeyId,
+          applicationId: authApplicationId,
+          existingUserWorkspaceId: existingNavigationMenuItem.userWorkspaceId,
+        },
+      );
+    }
+
+    const flatNavigationMenuItemToUpdate =
+      fromUpdateNavigationMenuItemInputToFlatNavigationMenuItemToUpdateOrThrow({
+        flatNavigationMenuItemMaps: existingFlatNavigationMenuItemMaps,
+        updateNavigationMenuItemInput: input,
+      });
+
+    const validateAndBuildResult =
+      await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunWorkspaceMigration(
+        {
+          allFlatEntityOperationByMetadataName: {
+            navigationMenuItem: {
+              flatEntityToCreate: [],
+              flatEntityToDelete: [],
+              flatEntityToUpdate: [flatNavigationMenuItemToUpdate],
+            },
+          },
+          workspaceId,
+          isSystemBuild: false,
+        },
+      );
+
+    if (isDefined(validateAndBuildResult)) {
+      throw new WorkspaceMigrationBuilderException(
+        validateAndBuildResult,
+        'Multiple validation errors occurred while updating navigation menu item',
+      );
+    }
+
+    const { flatNavigationMenuItemMaps: recomputedFlatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    return fromFlatNavigationMenuItemToNavigationMenuItemDto(
+      findFlatEntityByIdInFlatEntityMapsOrThrow({
+        flatEntityId: input.id,
+        flatEntityMaps: recomputedFlatNavigationMenuItemMaps,
+      }),
+    );
+  }
+
+  async delete({
+    id,
+    workspaceId,
+    authUserWorkspaceId,
+    authApiKeyId,
+    authApplicationId,
+  }: {
+    id: string;
+    workspaceId: string;
+    authUserWorkspaceId?: string;
+    authApiKeyId?: string;
+    authApplicationId?: string;
+  }): Promise<NavigationMenuItemDTO> {
+    const { flatNavigationMenuItemMaps: existingFlatNavigationMenuItemMaps } =
+      await this.workspaceManyOrAllFlatEntityMapsCacheService.getOrRecomputeManyOrAllFlatEntityMaps(
+        {
+          workspaceId,
+          flatMapsKeys: ['flatNavigationMenuItemMaps'],
+        },
+      );
+
+    const flatNavigationMenuItemToDelete =
+      fromDeleteNavigationMenuItemInputToFlatNavigationMenuItemOrThrow({
+        flatNavigationMenuItemMaps: existingFlatNavigationMenuItemMaps,
+        navigationMenuItemId: id,
+      });
+
+    await this.navigationMenuItemAccessService.canUserDeleteNavigationMenuItem({
+      userWorkspaceId: authUserWorkspaceId,
+      workspaceId,
+      apiKeyId: authApiKeyId,
+      applicationId: authApplicationId,
+      existingUserWorkspaceId: flatNavigationMenuItemToDelete.userWorkspaceId,
+    });
+
+    const validateAndBuildResult =
+      await this.workspaceMigrationValidateBuildAndRunService.validateBuildAndRunWorkspaceMigration(
+        {
+          allFlatEntityOperationByMetadataName: {
+            navigationMenuItem: {
+              flatEntityToCreate: [],
+              flatEntityToDelete: [flatNavigationMenuItemToDelete],
+              flatEntityToUpdate: [],
+            },
+          },
+          workspaceId,
+          isSystemBuild: false,
+        },
+      );
+
+    if (isDefined(validateAndBuildResult)) {
+      throw new WorkspaceMigrationBuilderException(
+        validateAndBuildResult,
+        'Multiple validation errors occurred while deleting navigation menu item',
+      );
+    }
+
+    return fromFlatNavigationMenuItemToNavigationMenuItemDto(
+      flatNavigationMenuItemToDelete,
+    );
+  }
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/services/navigation-menu-item-access.service.ts

@@ -0,0 +1,173 @@
+import { Injectable } from '@nestjs/common';
+
+import { msg } from '@lingui/core/macro';
+import { PermissionFlagType } from 'twenty-shared/constants';
+import { isDefined } from 'twenty-shared/utils';
+
+import {
+  NavigationMenuItemException,
+  NavigationMenuItemExceptionCode,
+} from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception';
+import {
+  PermissionsException,
+  PermissionsExceptionCode,
+  PermissionsExceptionMessage,
+} from 'src/engine/metadata-modules/permissions/permissions.exception';
+import { PermissionsService } from 'src/engine/metadata-modules/permissions/permissions.service';
+
+@Injectable()
+export class NavigationMenuItemAccessService {
+  constructor(private readonly permissionsService: PermissionsService) {}
+
+  async canUserCreateNavigationMenuItem({
+    userWorkspaceId,
+    workspaceId,
+    apiKeyId,
+    applicationId,
+    inputUserWorkspaceId,
+  }: {
+    userWorkspaceId: string | undefined;
+    workspaceId: string;
+    apiKeyId: string | undefined;
+    applicationId: string | undefined;
+    inputUserWorkspaceId: string | undefined;
+  }): Promise<boolean> {
+    if (!isDefined(inputUserWorkspaceId)) {
+      const hasPermission =
+        await this.permissionsService.userHasWorkspaceSettingPermission({
+          userWorkspaceId,
+          workspaceId,
+          setting: PermissionFlagType.LAYOUTS,
+          apiKeyId,
+          applicationId,
+        });
+
+      if (!hasPermission) {
+        throw new PermissionsException(
+          PermissionsExceptionMessage.PERMISSION_DENIED,
+          PermissionsExceptionCode.PERMISSION_DENIED,
+          {
+            userFriendlyMessage: msg`You do not have permission to create workspace-level navigation menu items. Please contact your workspace administrator for access.`,
+          },
+        );
+      }
+
+      return true;
+    }
+
+    if (!isDefined(userWorkspaceId)) {
+      throw new NavigationMenuItemException(
+        'User-level navigation menu items can only be created by authenticated users',
+        NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+      );
+    }
+
+    return true;
+  }
+
+  async canUserUpdateNavigationMenuItem({
+    userWorkspaceId,
+    workspaceId,
+    apiKeyId,
+    applicationId,
+    existingUserWorkspaceId,
+  }: {
+    userWorkspaceId: string | undefined;
+    workspaceId: string;
+    apiKeyId: string | undefined;
+    applicationId: string | undefined;
+    existingUserWorkspaceId: string | null | undefined;
+  }): Promise<boolean> {
+    if (!isDefined(existingUserWorkspaceId)) {
+      const hasPermission =
+        await this.permissionsService.userHasWorkspaceSettingPermission({
+          userWorkspaceId,
+          workspaceId,
+          setting: PermissionFlagType.LAYOUTS,
+          apiKeyId,
+          applicationId,
+        });
+
+      if (!hasPermission) {
+        throw new PermissionsException(
+          PermissionsExceptionMessage.PERMISSION_DENIED,
+          PermissionsExceptionCode.PERMISSION_DENIED,
+          {
+            userFriendlyMessage: msg`You do not have permission to update workspace-level navigation menu items. Please contact your workspace administrator for access.`,
+          },
+        );
+      }
+
+      return true;
+    }
+
+    if (!isDefined(userWorkspaceId)) {
+      throw new NavigationMenuItemException(
+        'User-level navigation menu items can only be updated by authenticated users',
+        NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+      );
+    }
+
+    if (existingUserWorkspaceId !== userWorkspaceId) {
+      throw new NavigationMenuItemException(
+        'You can only update your own navigation menu items',
+        NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+      );
+    }
+
+    return true;
+  }
+
+  async canUserDeleteNavigationMenuItem({
+    userWorkspaceId,
+    workspaceId,
+    apiKeyId,
+    applicationId,
+    existingUserWorkspaceId,
+  }: {
+    userWorkspaceId: string | undefined;
+    workspaceId: string;
+    apiKeyId: string | undefined;
+    applicationId: string | undefined;
+    existingUserWorkspaceId: string | null | undefined;
+  }): Promise<boolean> {
+    if (!isDefined(existingUserWorkspaceId)) {
+      const hasPermission =
+        await this.permissionsService.userHasWorkspaceSettingPermission({
+          userWorkspaceId,
+          workspaceId,
+          setting: PermissionFlagType.LAYOUTS,
+          apiKeyId,
+          applicationId,
+        });
+
+      if (!hasPermission) {
+        throw new PermissionsException(
+          PermissionsExceptionMessage.PERMISSION_DENIED,
+          PermissionsExceptionCode.PERMISSION_DENIED,
+          {
+            userFriendlyMessage: msg`You do not have permission to delete workspace-level navigation menu items. Please contact your workspace administrator for access.`,
+          },
+        );
+      }
+
+      return true;
+    }
+
+    if (!isDefined(userWorkspaceId)) {
+      throw new NavigationMenuItemException(
+        'User-level navigation menu items can only be deleted by authenticated users',
+        NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+      );
+    }
+
+    if (existingUserWorkspaceId !== userWorkspaceId) {
+      throw new NavigationMenuItemException(
+        'You can only delete your own navigation menu items',
+        NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+      );
+    }
+
+    return true;
+  }
+}

packages/twenty-server/src/engine/metadata-modules/navigation-menu-item/utils/navigation-menu-item-graphql-api-exception-handler.util.ts

@@ -0,0 +1,28 @@
+import { assertUnreachable } from 'twenty-shared/utils';
+
+import {
+  NotFoundError,
+  UserInputError,
+} from 'src/engine/core-modules/graphql/utils/graphql-errors.util';
+import {
+  NavigationMenuItemException,
+  NavigationMenuItemExceptionCode,
+} from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception';
+
+export const navigationMenuItemGraphqlApiExceptionHandler = (error: Error) => {
+  if (error instanceof NavigationMenuItemException) {
+    switch (error.code) {
+      case NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND:
+        throw new NotFoundError(error);
+      case NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT:
+      case NavigationMenuItemExceptionCode.CIRCULAR_DEPENDENCY:
+      case NavigationMenuItemExceptionCode.MAX_DEPTH_EXCEEDED:
+        throw new UserInputError(error);
+      default: {
+        return assertUnreachable(error.code);
+      }
+    }
+  }
+
+  throw error;
+};

packages/twenty-server/src/engine/workspace-cache/types/workspace-cache-key.type.ts

@@ -36,6 +36,7 @@ export const WORKSPACE_CACHE_KEYS_V2 = {
   flatAgentMaps: 'flat-maps:agent',
   flatSkillMaps: 'flat-maps:skill',
   flatCommandMenuItemMaps: 'flat-maps:command-menu-item',
+  flatNavigationMenuItemMaps: 'flat-maps:navigation-menu-item',
   flatRoleTargetByAgentIdMaps: 'flat-maps:flatRoleTargetByAgentId',
   flatPageLayoutMaps: 'flat-maps:page-layout',
   flatPageLayoutWidgetMaps: 'flat-maps:page-layout-widget',

packages/twenty-server/src/engine/workspace-manager/workspace-migration/services/workspace-migration-build-orchestrator.service.ts

@@ -21,6 +21,7 @@ import { WorkspaceMigrationDatabaseEventTriggerActionsBuilderService } from 'src
 import { WorkspaceMigrationFieldActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/field/workspace-migration-field-actions-builder.service';
 import { WorkspaceMigrationFrontComponentActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/front-component/workspace-migration-front-component-actions-builder.service';
 import { WorkspaceMigrationIndexActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/index/workspace-migration-index-actions-builder.service';
+import { WorkspaceMigrationNavigationMenuItemActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/workspace-migration-navigation-menu-item-actions-builder.service';
 import { WorkspaceMigrationObjectActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/object/workspace-migration-object-actions-builder.service';
 import { WorkspaceMigrationPageLayoutTabActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/page-layout-tab/workspace-migration-page-layout-tab-actions-builder.service';
 import { WorkspaceMigrationPageLayoutWidgetActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/page-layout-widget/workspace-migration-page-layout-widget-actions-builder.service';
@@ -58,6 +59,7 @@ export class WorkspaceMigrationBuildOrchestratorService {
     private readonly workspaceMigrationAgentActionsBuilderService: WorkspaceMigrationAgentActionsBuilderService,
     private readonly workspaceMigrationSkillActionsBuilderService: WorkspaceMigrationSkillActionsBuilderService,
     private readonly workspaceMigrationCommandMenuItemActionsBuilderService: WorkspaceMigrationCommandMenuItemActionsBuilderService,
+    private readonly workspaceMigrationNavigationMenuItemActionsBuilderService: WorkspaceMigrationNavigationMenuItemActionsBuilderService,
     private readonly workspaceMigrationPageLayoutActionsBuilderService: WorkspaceMigrationPageLayoutActionsBuilderService,
     private readonly workspaceMigrationPageLayoutWidgetActionsBuilderService: WorkspaceMigrationPageLayoutWidgetActionsBuilderService,
     private readonly workspaceMigrationPageLayoutTabActionsBuilderService: WorkspaceMigrationPageLayoutTabActionsBuilderService,
@@ -161,6 +163,7 @@ export class WorkspaceMigrationBuildOrchestratorService {
       flatAgentMaps,
       flatSkillMaps,
       flatCommandMenuItemMaps,
+      flatNavigationMenuItemMaps,
       flatPageLayoutMaps,
       flatPageLayoutWidgetMaps,
       flatPageLayoutTabMaps,
@@ -859,6 +862,46 @@ export class WorkspaceMigrationBuildOrchestratorService {
       }
     }
 
+    if (isDefined(flatNavigationMenuItemMaps)) {
+      const {
+        from: fromFlatNavigationMenuItemMaps,
+        to: toFlatNavigationMenuItemMaps,
+      } = flatNavigationMenuItemMaps;
+
+      const navigationMenuItemResult =
+        await this.workspaceMigrationNavigationMenuItemActionsBuilderService.validateAndBuild(
+          {
+            additionalCacheDataMaps,
+            from: fromFlatNavigationMenuItemMaps,
+            to: toFlatNavigationMenuItemMaps,
+            buildOptions,
+            dependencyOptimisticFlatEntityMaps: {
+              flatObjectMetadataMaps:
+                optimisticAllFlatEntityMaps.flatObjectMetadataMaps,
+              flatViewMaps: optimisticAllFlatEntityMaps.flatViewMaps,
+            },
+            workspaceId,
+          },
+        );
+
+      this.mergeFlatEntityMapsAndRelatedFlatEntityMapsInAllFlatEntityMapsThroughMutation(
+        {
+          allFlatEntityMaps: optimisticAllFlatEntityMaps,
+          flatEntityMapsAndRelatedFlatEntityMaps:
+            navigationMenuItemResult.optimisticFlatEntityMapsAndRelatedFlatEntityMaps,
+        },
+      );
+
+      if (navigationMenuItemResult.status === 'fail') {
+        orchestratorFailureReport.navigationMenuItem.push(
+          ...navigationMenuItemResult.errors,
+        );
+      } else {
+        orchestratorActionsReport.navigationMenuItem =
+          navigationMenuItemResult.actions;
+      }
+    }
+
     if (isDefined(flatPageLayoutMaps)) {
       const { from: fromFlatPageLayoutMaps, to: toFlatPageLayoutMaps } =
         flatPageLayoutMaps;
@@ -1118,6 +1161,12 @@ export class WorkspaceMigrationBuildOrchestratorService {
           ...aggregatedOrchestratorActionsReport.commandMenuItem.update,
           ///
 
+          // Navigation Menu Items
+          ...aggregatedOrchestratorActionsReport.navigationMenuItem.delete,
+          ...aggregatedOrchestratorActionsReport.navigationMenuItem.create,
+          ...aggregatedOrchestratorActionsReport.navigationMenuItem.update,
+          ///
+
           // Page layouts
           ...aggregatedOrchestratorActionsReport.pageLayout.delete,
           ...aggregatedOrchestratorActionsReport.pageLayout.create,

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/types/workspace-migration-navigation-menu-item-action.type.ts

@@ -0,0 +1,12 @@
+import { type BaseCreateWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-create-workspace-migration-action.type';
+import { type BaseDeleteWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-delete-workspace-migration-action.type';
+import { type BaseUpdateWorkspaceMigrationAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/base-update-workspace-migration-action.type';
+
+export type CreateNavigationMenuItemAction =
+  BaseCreateWorkspaceMigrationAction<'navigationMenuItem'>;
+
+export type UpdateNavigationMenuItemAction =
+  BaseUpdateWorkspaceMigrationAction<'navigationMenuItem'>;
+
+export type DeleteNavigationMenuItemAction =
+  BaseDeleteWorkspaceMigrationAction<'navigationMenuItem'>;

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/workspace-migration-navigation-menu-item-actions-builder.service.ts

@@ -0,0 +1,117 @@
+import { Injectable } from '@nestjs/common';
+
+import { ALL_METADATA_NAME } from 'twenty-shared/metadata';
+
+import { UpdateNavigationMenuItemAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/types/workspace-migration-navigation-menu-item-action.type';
+import { WorkspaceEntityMigrationBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/services/workspace-entity-migration-builder.service';
+import { FlatEntityUpdateValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/flat-entity-update-validation-args.type';
+import { FlatEntityValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/flat-entity-validation-args.type';
+import { FlatEntityValidationReturnType } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/flat-entity-validation-result.type';
+import { FlatNavigationMenuItemValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-navigation-menu-item-validator.service';
+
+@Injectable()
+export class WorkspaceMigrationNavigationMenuItemActionsBuilderService extends WorkspaceEntityMigrationBuilderService<
+  typeof ALL_METADATA_NAME.navigationMenuItem
+> {
+  constructor(
+    private readonly flatNavigationMenuItemValidatorService: FlatNavigationMenuItemValidatorService,
+  ) {
+    super(ALL_METADATA_NAME.navigationMenuItem);
+  }
+
+  protected validateFlatEntityCreation(
+    args: FlatEntityValidationArgs<typeof ALL_METADATA_NAME.navigationMenuItem>,
+  ): FlatEntityValidationReturnType<
+    typeof ALL_METADATA_NAME.navigationMenuItem,
+    'create'
+  > {
+    const validationResult =
+      this.flatNavigationMenuItemValidatorService.validateFlatNavigationMenuItemCreation(
+        args,
+      );
+
+    if (validationResult.errors.length > 0) {
+      return {
+        status: 'fail',
+        ...validationResult,
+      };
+    }
+
+    const { flatEntityToValidate: flatNavigationMenuItemToValidate } = args;
+
+    return {
+      status: 'success',
+      action: {
+        type: 'create',
+        metadataName: 'navigationMenuItem',
+        flatEntity: flatNavigationMenuItemToValidate,
+      },
+    };
+  }
+
+  protected validateFlatEntityDeletion(
+    args: FlatEntityValidationArgs<typeof ALL_METADATA_NAME.navigationMenuItem>,
+  ): FlatEntityValidationReturnType<
+    typeof ALL_METADATA_NAME.navigationMenuItem,
+    'delete'
+  > {
+    const validationResult =
+      this.flatNavigationMenuItemValidatorService.validateFlatNavigationMenuItemDeletion(
+        args,
+      );
+
+    if (validationResult.errors.length > 0) {
+      return {
+        status: 'fail',
+        ...validationResult,
+      };
+    }
+
+    const { flatEntityToValidate: flatNavigationMenuItemToValidate } = args;
+
+    return {
+      status: 'success',
+      action: {
+        type: 'delete',
+        metadataName: 'navigationMenuItem',
+        universalIdentifier:
+          flatNavigationMenuItemToValidate.universalIdentifier,
+      },
+    };
+  }
+
+  protected validateFlatEntityUpdate(
+    args: FlatEntityUpdateValidationArgs<
+      typeof ALL_METADATA_NAME.navigationMenuItem
+    >,
+  ): FlatEntityValidationReturnType<
+    typeof ALL_METADATA_NAME.navigationMenuItem,
+    'update'
+  > {
+    const validationResult =
+      this.flatNavigationMenuItemValidatorService.validateFlatNavigationMenuItemUpdate(
+        args,
+      );
+
+    if (validationResult.errors.length > 0) {
+      return {
+        status: 'fail',
+        ...validationResult,
+      };
+    }
+
+    const { flatEntityId, flatEntityUpdates } = args;
+
+    const updateNavigationMenuItemAction: UpdateNavigationMenuItemAction = {
+      type: 'update',
+      metadataName: 'navigationMenuItem',
+      entityId: flatEntityId,
+      updates: flatEntityUpdates,
+    };
+
+    return {
+      status: 'success',
+      action: updateNavigationMenuItemAction,
+    };
+  }
+}

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-navigation-menu-item-validator.service.ts

@@ -0,0 +1,382 @@
+import { Injectable } from '@nestjs/common';
+
+import { msg, t } from '@lingui/core/macro';
+import { ALL_METADATA_NAME } from 'twenty-shared/metadata';
+import { isDefined } from 'twenty-shared/utils';
+
+import { findFlatEntityByIdInFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps.util';
+import { type FlatNavigationMenuItemMaps } from 'src/engine/metadata-modules/flat-navigation-menu-item/types/flat-navigation-menu-item-maps.type';
+import { NavigationMenuItemExceptionCode } from 'src/engine/metadata-modules/navigation-menu-item/navigation-menu-item.exception';
+import { findFlatEntityPropertyUpdate } from 'src/engine/workspace-manager/workspace-migration/utils/find-flat-entity-property-update.util';
+import { validateFlatEntityCircularDependency } from 'src/engine/workspace-manager/workspace-migration/utils/validate-flat-entity-circular-dependency.util';
+import {
+  type FailedFlatEntityValidation,
+  type FlatEntityValidationError,
+} from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/types/failed-flat-entity-validation.type';
+import { getEmptyFlatEntityValidationError } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/utils/get-flat-entity-validation-error.util';
+import { type FlatEntityUpdateValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/flat-entity-update-validation-args.type';
+import { type FlatEntityValidationArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/types/flat-entity-validation-args.type';
+import { fromFlatEntityPropertiesUpdatesToPartialFlatEntity } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/from-flat-entity-properties-updates-to-partial-flat-entity';
+
+const NAVIGATION_MENU_ITEM_MAX_DEPTH = 2;
+
+@Injectable()
+export class FlatNavigationMenuItemValidatorService {
+  private validateNavigationMenuItemType({
+    hasTargetRecordId,
+    hasTargetObjectMetadataId,
+    hasViewId,
+    name,
+    isUpdate = false,
+  }: {
+    hasTargetRecordId: boolean;
+    hasTargetObjectMetadataId: boolean;
+    hasViewId: boolean;
+    name: string | null | undefined;
+    isUpdate?: boolean;
+  }): FlatEntityValidationError<NavigationMenuItemExceptionCode>[] {
+    const errors: FlatEntityValidationError<NavigationMenuItemExceptionCode>[] =
+      [];
+
+    if (hasTargetObjectMetadataId && !hasTargetRecordId) {
+      errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`targetRecordId is required when targetObjectMetadataId is provided`,
+        userFriendlyMessage: msg`targetRecordId is required when targetObjectMetadataId is provided`,
+      });
+    }
+
+    if (hasTargetRecordId && !hasTargetObjectMetadataId) {
+      errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`targetObjectMetadataId is required when targetRecordId is provided`,
+        userFriendlyMessage: msg`targetObjectMetadataId is required when targetRecordId is provided`,
+      });
+    }
+
+    if (hasViewId && (hasTargetRecordId || hasTargetObjectMetadataId)) {
+      errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`viewId cannot be provided together with targetRecordId or targetObjectMetadataId`,
+        userFriendlyMessage: msg`viewId cannot be provided together with targetRecordId or targetObjectMetadataId`,
+      });
+    }
+
+    const isFolder =
+      !hasTargetRecordId && !hasTargetObjectMetadataId && !hasViewId;
+    const isViewLink = hasViewId;
+    const isRecordLink = hasTargetRecordId && hasTargetObjectMetadataId;
+    const typeCount =
+      (isFolder ? 1 : 0) + (isViewLink ? 1 : 0) + (isRecordLink ? 1 : 0);
+
+    if (typeCount === 0) {
+      errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`Navigation menu item must be either a folder (with name), a view link (with viewId), or a record link (with targetRecordId and targetObjectMetadataId)`,
+        userFriendlyMessage: msg`Navigation menu item must be either a folder (with name), a view link (with viewId), or a record link (with targetRecordId and targetObjectMetadataId)`,
+      });
+    }
+
+    if (typeCount > 1) {
+      errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`Navigation menu item cannot be multiple types simultaneously`,
+        userFriendlyMessage: msg`Navigation menu item cannot be multiple types simultaneously`,
+      });
+    }
+
+    if (isFolder && (!isDefined(name) || name.trim() === '')) {
+      errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: isUpdate
+          ? t`Folder name is required and cannot be empty`
+          : t`Folder name is required when creating a folder`,
+        userFriendlyMessage: isUpdate
+          ? msg`Folder name is required and cannot be empty`
+          : msg`Folder name is required when creating a folder`,
+      });
+    }
+
+    return errors;
+  }
+
+  private getCircularDependencyValidationErrors({
+    navigationMenuItemId,
+    folderId,
+    flatNavigationMenuItemMaps,
+  }: {
+    navigationMenuItemId: string;
+    folderId: string;
+    flatNavigationMenuItemMaps: FlatNavigationMenuItemMaps;
+  }): FlatEntityValidationError<NavigationMenuItemExceptionCode>[] {
+    const circularDependencyResult = validateFlatEntityCircularDependency({
+      flatEntityId: navigationMenuItemId,
+      flatEntityParentId: folderId,
+      maxDepth: NAVIGATION_MENU_ITEM_MAX_DEPTH,
+      parentIdKey: 'folderId',
+      flatEntityMaps: flatNavigationMenuItemMaps,
+    });
+
+    if (circularDependencyResult.status === 'success') {
+      return [];
+    }
+
+    switch (circularDependencyResult.reason) {
+      case 'self_reference':
+        return [
+          {
+            code: NavigationMenuItemExceptionCode.CIRCULAR_DEPENDENCY,
+            message: t`Navigation menu item cannot be its own parent`,
+            userFriendlyMessage: msg`Navigation menu item cannot be its own parent`,
+          },
+        ];
+      case 'circular_dependency':
+        return [
+          {
+            code: NavigationMenuItemExceptionCode.CIRCULAR_DEPENDENCY,
+            message: t`Circular dependency detected in navigation menu item hierarchy`,
+            userFriendlyMessage: msg`Circular dependency detected in navigation menu item hierarchy`,
+          },
+        ];
+      case 'max_depth_exceeded':
+        return [
+          {
+            code: NavigationMenuItemExceptionCode.MAX_DEPTH_EXCEEDED,
+            message: t`Navigation menu item hierarchy exceeds maximum depth of ${NAVIGATION_MENU_ITEM_MAX_DEPTH}`,
+            userFriendlyMessage: msg`Navigation menu item hierarchy exceeds maximum depth of ${NAVIGATION_MENU_ITEM_MAX_DEPTH}`,
+          },
+        ];
+    }
+  }
+
+  public validateFlatNavigationMenuItemCreation({
+    flatEntityToValidate: flatNavigationMenuItem,
+    optimisticFlatEntityMapsAndRelatedFlatEntityMaps: {
+      flatNavigationMenuItemMaps: optimisticFlatNavigationMenuItemMaps,
+    },
+    remainingFlatEntityMapsToValidate,
+  }: FlatEntityValidationArgs<
+    typeof ALL_METADATA_NAME.navigationMenuItem
+  >): FailedFlatEntityValidation<'navigationMenuItem', 'create'> {
+    const validationResult = getEmptyFlatEntityValidationError({
+      flatEntityMinimalInformation: {
+        id: flatNavigationMenuItem.id,
+        universalIdentifier: flatNavigationMenuItem.universalIdentifier,
+      },
+      metadataName: 'navigationMenuItem',
+      type: 'create',
+    });
+
+    if (
+      isDefined(flatNavigationMenuItem.position) &&
+      (!Number.isInteger(flatNavigationMenuItem.position) ||
+        flatNavigationMenuItem.position < 0)
+    ) {
+      validationResult.errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`Position must be a non-negative integer`,
+        userFriendlyMessage: msg`Position must be a non-negative integer`,
+      });
+    }
+
+    const typeValidationErrors = this.validateNavigationMenuItemType({
+      hasTargetRecordId: isDefined(flatNavigationMenuItem.targetRecordId),
+      hasTargetObjectMetadataId: isDefined(
+        flatNavigationMenuItem.targetObjectMetadataId,
+      ),
+      hasViewId: isDefined(flatNavigationMenuItem.viewId),
+      name: flatNavigationMenuItem.name,
+      isUpdate: false,
+    });
+
+    validationResult.errors.push(...typeValidationErrors);
+
+    if (isDefined(flatNavigationMenuItem.folderId)) {
+      const circularDependencyErrors =
+        this.getCircularDependencyValidationErrors({
+          navigationMenuItemId: flatNavigationMenuItem.id,
+          folderId: flatNavigationMenuItem.folderId,
+          flatNavigationMenuItemMaps: optimisticFlatNavigationMenuItemMaps,
+        });
+
+      if (circularDependencyErrors.length > 0) {
+        validationResult.errors.push(...circularDependencyErrors);
+      }
+
+      const referencedParentInOptimistic = findFlatEntityByIdInFlatEntityMaps({
+        flatEntityId: flatNavigationMenuItem.folderId,
+        flatEntityMaps: optimisticFlatNavigationMenuItemMaps,
+      });
+
+      const referencedParentInRemaining = findFlatEntityByIdInFlatEntityMaps({
+        flatEntityId: flatNavigationMenuItem.folderId,
+        flatEntityMaps: remainingFlatEntityMapsToValidate,
+      });
+
+      if (
+        !isDefined(referencedParentInOptimistic) &&
+        !isDefined(referencedParentInRemaining)
+      ) {
+        validationResult.errors.push({
+          code: NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+          message: t`Parent navigation menu item not found`,
+          userFriendlyMessage: msg`Parent navigation menu item not found`,
+        });
+      }
+    }
+
+    return validationResult;
+  }
+
+  public validateFlatNavigationMenuItemDeletion({
+    flatEntityToValidate,
+    optimisticFlatEntityMapsAndRelatedFlatEntityMaps: {
+      flatNavigationMenuItemMaps: optimisticFlatNavigationMenuItemMaps,
+    },
+  }: FlatEntityValidationArgs<
+    typeof ALL_METADATA_NAME.navigationMenuItem
+  >): FailedFlatEntityValidation<'navigationMenuItem', 'delete'> {
+    const validationResult = getEmptyFlatEntityValidationError({
+      flatEntityMinimalInformation: {
+        id: flatEntityToValidate.id,
+        universalIdentifier: flatEntityToValidate.universalIdentifier,
+      },
+      metadataName: 'navigationMenuItem',
+      type: 'delete',
+    });
+
+    const existingNavigationMenuItem = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId: flatEntityToValidate.id,
+      flatEntityMaps: optimisticFlatNavigationMenuItemMaps,
+    });
+
+    if (!isDefined(existingNavigationMenuItem)) {
+      validationResult.errors.push({
+        code: NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+        message: t`Navigation menu item not found`,
+        userFriendlyMessage: msg`Navigation menu item not found`,
+      });
+    }
+
+    return validationResult;
+  }
+
+  public validateFlatNavigationMenuItemUpdate({
+    flatEntityId,
+    flatEntityUpdates,
+    optimisticFlatEntityMapsAndRelatedFlatEntityMaps: {
+      flatNavigationMenuItemMaps: optimisticFlatNavigationMenuItemMaps,
+    },
+  }: FlatEntityUpdateValidationArgs<
+    typeof ALL_METADATA_NAME.navigationMenuItem
+  >): FailedFlatEntityValidation<'navigationMenuItem', 'update'> {
+    const fromFlatNavigationMenuItem = findFlatEntityByIdInFlatEntityMaps({
+      flatEntityId,
+      flatEntityMaps: optimisticFlatNavigationMenuItemMaps,
+    });
+
+    const validationResult = getEmptyFlatEntityValidationError({
+      flatEntityMinimalInformation: {
+        id: flatEntityId,
+        universalIdentifier: fromFlatNavigationMenuItem?.universalIdentifier,
+      },
+      metadataName: 'navigationMenuItem',
+      type: 'update',
+    });
+
+    if (!isDefined(fromFlatNavigationMenuItem)) {
+      validationResult.errors.push({
+        code: NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+        message: t`Navigation menu item not found`,
+        userFriendlyMessage: msg`Navigation menu item not found`,
+      });
+
+      return validationResult;
+    }
+
+    const positionUpdate = findFlatEntityPropertyUpdate({
+      flatEntityUpdates,
+      property: 'position',
+    });
+
+    if (
+      isDefined(positionUpdate) &&
+      (!Number.isInteger(positionUpdate.to) || positionUpdate.to < 0)
+    ) {
+      validationResult.errors.push({
+        code: NavigationMenuItemExceptionCode.INVALID_NAVIGATION_MENU_ITEM_INPUT,
+        message: t`Position must be a non-negative integer`,
+        userFriendlyMessage: msg`Position must be a non-negative integer`,
+      });
+    }
+
+    const toFlatNavigationMenuItem = {
+      ...fromFlatNavigationMenuItem,
+      ...fromFlatEntityPropertiesUpdatesToPartialFlatEntity({
+        updates: flatEntityUpdates,
+      }),
+    };
+
+    const nameUpdate = findFlatEntityPropertyUpdate({
+      flatEntityUpdates,
+      property: 'name',
+    });
+
+    const typeValidationErrors = this.validateNavigationMenuItemType({
+      hasTargetRecordId: isDefined(toFlatNavigationMenuItem.targetRecordId),
+      hasTargetObjectMetadataId: isDefined(
+        toFlatNavigationMenuItem.targetObjectMetadataId,
+      ),
+      hasViewId: isDefined(toFlatNavigationMenuItem.viewId),
+      name: isDefined(nameUpdate)
+        ? nameUpdate.to
+        : toFlatNavigationMenuItem.name,
+      isUpdate: true,
+    });
+
+    validationResult.errors.push(...typeValidationErrors);
+
+    const folderIdUpdate = findFlatEntityPropertyUpdate({
+      flatEntityUpdates,
+      property: 'folderId',
+    });
+
+    if (!isDefined(folderIdUpdate)) {
+      return validationResult;
+    }
+
+    const newFolderId = folderIdUpdate.to;
+
+    if (!isDefined(newFolderId)) {
+      return validationResult;
+    }
+
+    const circularDependencyErrors = this.getCircularDependencyValidationErrors(
+      {
+        navigationMenuItemId: flatEntityId,
+        folderId: newFolderId,
+        flatNavigationMenuItemMaps: optimisticFlatNavigationMenuItemMaps,
+      },
+    );
+
+    if (circularDependencyErrors.length > 0) {
+      validationResult.errors.push(...circularDependencyErrors);
+    }
+
+    const referencedParentNavigationMenuItem =
+      findFlatEntityByIdInFlatEntityMaps({
+        flatEntityId: newFolderId,
+        flatEntityMaps: optimisticFlatNavigationMenuItemMaps,
+      });
+
+    if (!isDefined(referencedParentNavigationMenuItem)) {
+      validationResult.errors.push({
+        code: NavigationMenuItemExceptionCode.NAVIGATION_MENU_ITEM_NOT_FOUND,
+        message: t`Parent navigation menu item not found`,
+        userFriendlyMessage: msg`Parent navigation menu item not found`,
+      });
+    }
+
+    return validationResult;
+  }
+}

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/workspace-migration-builder-validators.module.ts

@@ -4,10 +4,13 @@ import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-
 import { FlatFieldMetadataTypeValidatorService } from 'src/engine/metadata-modules/flat-field-metadata/services/flat-field-metadata-type-validator.service';
 import { FlatPageLayoutWidgetTypeValidatorService } from 'src/engine/metadata-modules/flat-page-layout-widget/services/flat-page-layout-widget-type-validator.service';
 import { FlatAgentValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-agent-validator.service';
+import { FlatCommandMenuItemValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-command-menu-item-validator.service';
 import { FlatCronTriggerValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-cron-trigger-validator.service';
 import { FlatDatabaseEventTriggerValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-database-event-trigger-validator.service';
 import { FlatFieldMetadataValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-field-metadata-validator.service';
+import { FlatFrontComponentValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-front-component-validator.service';
 import { FlatIndexValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-index-metadata-validator.service';
+import { FlatNavigationMenuItemValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-navigation-menu-item-validator.service';
 import { FlatObjectMetadataValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-object-metadata-validator.service';
 import { FlatPageLayoutTabValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-page-layout-tab-validator.service';
 import { FlatPageLayoutValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-page-layout-validator.service';
@@ -18,9 +21,7 @@ import { FlatRouteTriggerValidatorService } from 'src/engine/workspace-manager/w
 import { FlatRowLevelPermissionPredicateGroupValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-row-level-permission-predicate-group-validator.service';
 import { FlatRowLevelPermissionPredicateValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-row-level-permission-predicate-validator.service';
 import { FlatServerlessFunctionValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-serverless-function-validator.service';
-import { FlatCommandMenuItemValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-command-menu-item-validator.service';
 import { FlatSkillValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-skill-validator.service';
-import { FlatFrontComponentValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-front-component-validator.service';
 import { FlatViewFieldValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-view-field-validator.service';
 import { FlatViewFilterGroupValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-view-filter-group-validator.service';
 import { FlatViewFilterValidatorService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/validators/services/flat-view-filter-validator.service';
@@ -49,6 +50,7 @@ import { FlatViewValidatorService } from 'src/engine/workspace-manager/workspace
     FlatAgentValidatorService,
     FlatSkillValidatorService,
     FlatCommandMenuItemValidatorService,
+    FlatNavigationMenuItemValidatorService,
     FlatPageLayoutValidatorService,
     FlatPageLayoutWidgetValidatorService,
     FlatPageLayoutTabValidatorService,
@@ -75,6 +77,7 @@ import { FlatViewValidatorService } from 'src/engine/workspace-manager/workspace
     FlatAgentValidatorService,
     FlatSkillValidatorService,
     FlatCommandMenuItemValidatorService,
+    FlatNavigationMenuItemValidatorService,
     FlatPageLayoutValidatorService,
     FlatPageLayoutWidgetValidatorService,
     FlatPageLayoutTabValidatorService,

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-builder/workspace-migration-builder.module.ts

@@ -4,6 +4,7 @@ import { FeatureFlagModule } from 'src/engine/core-modules/feature-flag/feature-
 import { FlatFieldMetadataTypeValidatorService } from 'src/engine/metadata-modules/flat-field-metadata/services/flat-field-metadata-type-validator.service';
 import { WorkspaceMigrationAgentActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/agent/workspace-migration-agent-actions-builder.service';
 import { WorkspaceMigrationCommandMenuItemActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/command-menu-item/workspace-migration-command-menu-item-actions-builder.service';
+import { WorkspaceMigrationNavigationMenuItemActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/workspace-migration-navigation-menu-item-actions-builder.service';
 import { WorkspaceMigrationCronTriggerActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/cron-trigger/workspace-migration-cron-trigger-action-builder.service';
 import { WorkspaceMigrationDatabaseEventTriggerActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/database-event-trigger/workspace-migration-database-event-trigger-actions-builder.service';
 import { WorkspaceMigrationFieldActionsBuilderService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/field/workspace-migration-field-actions-builder.service';
@@ -48,6 +49,7 @@ import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-
     WorkspaceMigrationAgentActionsBuilderService,
     WorkspaceMigrationSkillActionsBuilderService,
     WorkspaceMigrationCommandMenuItemActionsBuilderService,
+    WorkspaceMigrationNavigationMenuItemActionsBuilderService,
     WorkspaceMigrationPageLayoutActionsBuilderService,
     WorkspaceMigrationPageLayoutWidgetActionsBuilderService,
     WorkspaceMigrationPageLayoutTabActionsBuilderService,
@@ -73,6 +75,7 @@ import { WorkspaceMigrationBuilderValidatorsModule } from 'src/engine/workspace-
     WorkspaceMigrationAgentActionsBuilderService,
     WorkspaceMigrationSkillActionsBuilderService,
     WorkspaceMigrationCommandMenuItemActionsBuilderService,
+    WorkspaceMigrationNavigationMenuItemActionsBuilderService,
     WorkspaceMigrationPageLayoutActionsBuilderService,
     WorkspaceMigrationPageLayoutWidgetActionsBuilderService,
     WorkspaceMigrationPageLayoutTabActionsBuilderService,

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/navigation-menu-item/services/create-navigation-menu-item-action-handler.service.ts

@@ -0,0 +1,40 @@
+import { Injectable } from '@nestjs/common';
+
+import { WorkspaceMigrationRunnerActionHandler } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+import { CreateNavigationMenuItemAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/types/workspace-migration-navigation-menu-item-action.type';
+import { WorkspaceMigrationActionRunnerArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class CreateNavigationMenuItemActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+  'create',
+  'navigationMenuItem',
+) {
+  constructor() {
+    super();
+  }
+
+  async executeForMetadata(
+    context: WorkspaceMigrationActionRunnerArgs<CreateNavigationMenuItemAction>,
+  ): Promise<void> {
+    const { action, queryRunner, workspaceId } = context;
+    const { flatEntity } = action;
+
+    const navigationMenuItemRepository =
+      queryRunner.manager.getRepository<NavigationMenuItemEntity>(
+        NavigationMenuItemEntity,
+      );
+
+    await navigationMenuItemRepository.insert({
+      ...flatEntity,
+      workspaceId,
+    });
+  }
+
+  async executeForWorkspaceSchema(
+    _context: WorkspaceMigrationActionRunnerArgs<CreateNavigationMenuItemAction>,
+  ): Promise<void> {
+    return;
+  }
+}

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/navigation-menu-item/services/delete-navigation-menu-item-action-handler.service.ts

@@ -0,0 +1,46 @@
+import { Injectable } from '@nestjs/common';
+
+import { WorkspaceMigrationRunnerActionHandler } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { findFlatEntityByUniversalIdentifierOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-universal-identifier-or-throw.util';
+import { NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+import { DeleteNavigationMenuItemAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/types/workspace-migration-navigation-menu-item-action.type';
+import { WorkspaceMigrationActionRunnerArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/types/workspace-migration-action-runner-args.type';
+
+@Injectable()
+export class DeleteNavigationMenuItemActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+  'delete',
+  'navigationMenuItem',
+) {
+  constructor() {
+    super();
+  }
+
+  async executeForMetadata(
+    context: WorkspaceMigrationActionRunnerArgs<DeleteNavigationMenuItemAction>,
+  ): Promise<void> {
+    const { action, queryRunner, workspaceId, allFlatEntityMaps } = context;
+    const { universalIdentifier } = action;
+
+    const flatNavigationMenuItem = findFlatEntityByUniversalIdentifierOrThrow({
+      flatEntityMaps: allFlatEntityMaps.flatNavigationMenuItemMaps,
+      universalIdentifier,
+    });
+
+    const navigationMenuItemRepository =
+      queryRunner.manager.getRepository<NavigationMenuItemEntity>(
+        NavigationMenuItemEntity,
+      );
+
+    await navigationMenuItemRepository.delete({
+      id: flatNavigationMenuItem.id,
+      workspaceId,
+    });
+  }
+
+  async executeForWorkspaceSchema(
+    _context: WorkspaceMigrationActionRunnerArgs<DeleteNavigationMenuItemAction>,
+  ): Promise<void> {
+    return;
+  }
+}

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/navigation-menu-item/services/update-navigation-menu-item-action-handler.service.ts

@@ -0,0 +1,39 @@
+import { Injectable } from '@nestjs/common';
+
+import { WorkspaceMigrationRunnerActionHandler } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/interfaces/workspace-migration-runner-action-handler-service.interface';
+
+import { NavigationMenuItemEntity } from 'src/engine/metadata-modules/navigation-menu-item/entities/navigation-menu-item.entity';
+import { UpdateNavigationMenuItemAction } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-builder/builders/navigation-menu-item/types/workspace-migration-navigation-menu-item-action.type';
+import { WorkspaceMigrationActionRunnerArgs } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/types/workspace-migration-action-runner-args.type';
+import { fromFlatEntityPropertiesUpdatesToPartialFlatEntity } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/from-flat-entity-properties-updates-to-partial-flat-entity';
+
+@Injectable()
+export class UpdateNavigationMenuItemActionHandlerService extends WorkspaceMigrationRunnerActionHandler(
+  'update',
+  'navigationMenuItem',
+) {
+  async executeForMetadata(
+    context: WorkspaceMigrationActionRunnerArgs<UpdateNavigationMenuItemAction>,
+  ): Promise<void> {
+    const { action, queryRunner, workspaceId } = context;
+    const { entityId, updates } = action;
+
+    const navigationMenuItemRepository =
+      queryRunner.manager.getRepository<NavigationMenuItemEntity>(
+        NavigationMenuItemEntity,
+      );
+
+    await navigationMenuItemRepository.update(
+      { id: entityId, workspaceId },
+      fromFlatEntityPropertiesUpdatesToPartialFlatEntity({
+        updates,
+      }),
+    );
+  }
+
+  async executeForWorkspaceSchema(
+    _context: WorkspaceMigrationActionRunnerArgs<UpdateNavigationMenuItemAction>,
+  ): Promise<void> {
+    return;
+  }
+}

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/workspace-schema-migration-runner-action-handlers.module.ts

@@ -7,6 +7,9 @@ import { UpdateAgentActionHandlerService } from 'src/engine/workspace-manager/wo
 import { CreateCommandMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/command-menu-item/services/create-command-menu-item-action-handler.service';
 import { DeleteCommandMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/command-menu-item/services/delete-command-menu-item-action-handler.service';
 import { UpdateCommandMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/command-menu-item/services/update-command-menu-item-action-handler.service';
+import { CreateNavigationMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/navigation-menu-item/services/create-navigation-menu-item-action-handler.service';
+import { DeleteNavigationMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/navigation-menu-item/services/delete-navigation-menu-item-action-handler.service';
+import { UpdateNavigationMenuItemActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/navigation-menu-item/services/update-navigation-menu-item-action-handler.service';
 import { CreateCronTriggerActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/cron-trigger/services/create-cron-trigger-action-handler.service';
 import { DeleteCronTriggerActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/cron-trigger/services/delete-cron-trigger-action-handler.service';
 import { UpdateCronTriggerActionHandlerService } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/action-handlers/cron-trigger/services/update-cron-trigger-action-handler.service';
@@ -142,6 +145,10 @@ import { UpdateViewActionHandlerService } from 'src/engine/workspace-manager/wor
     UpdateCommandMenuItemActionHandlerService,
     DeleteCommandMenuItemActionHandlerService,
 
+    CreateNavigationMenuItemActionHandlerService,
+    UpdateNavigationMenuItemActionHandlerService,
+    DeleteNavigationMenuItemActionHandlerService,
+
     CreatePageLayoutActionHandlerService,
     UpdatePageLayoutActionHandlerService,
     DeletePageLayoutActionHandlerService,

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-create-action-on-all-flat-entity-maps.util.ts

@@ -4,6 +4,7 @@ import { assertUnreachable } from 'twenty-shared/utils';
 import { type AllFlatEntityMaps } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-maps.type';
 import { type AllFlatEntityTypesByMetadataName } from 'src/engine/metadata-modules/flat-entity/types/all-flat-entity-types-by-metadata-name';
 import { addFlatEntityToFlatEntityAndRelatedEntityMapsThroughMutationOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/add-flat-entity-to-flat-entity-and-related-entity-maps-through-mutation-or-throw.util';
+import { addFlatNavigationMenuItemToMapsAndUpdateIndex } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/add-flat-navigation-menu-item-to-maps-and-update-index.util';
 
 type CreateAction<TMetadataName extends AllMetadataName> =
   AllFlatEntityTypesByMetadataName[TMetadataName]['actions']['create'];
@@ -79,6 +80,15 @@ export const optimisticallyApplyCreateActionOnAllFlatEntityMaps = <
 
       return allFlatEntityMaps;
     }
+    case 'navigationMenuItem': {
+      addFlatNavigationMenuItemToMapsAndUpdateIndex({
+        flatNavigationMenuItem: action.flatEntity,
+        flatNavigationMenuItemMaps:
+          allFlatEntityMaps.flatNavigationMenuItemMaps,
+      });
+
+      return allFlatEntityMaps;
+    }
     default: {
       assertUnreachable(action);
     }

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-delete-action-on-all-flat-entity-maps.util.ts

@@ -7,6 +7,7 @@ import { type MetadataFlatEntity } from 'src/engine/metadata-modules/flat-entity
 import { deleteFlatEntityFromFlatEntityAndRelatedEntityMapsThroughMutationOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/delete-flat-entity-from-flat-entity-and-related-entity-maps-through-mutation-or-throw.util';
 import { findFlatEntityByUniversalIdentifierOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-universal-identifier-or-throw.util';
 import { getMetadataFlatEntityMapsKey } from 'src/engine/metadata-modules/flat-entity/utils/get-metadata-flat-entity-maps-key.util';
+import { deleteFlatNavigationMenuItemFromMapsAndIndex } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/delete-flat-navigation-menu-item-from-maps-and-index.util';
 
 type DeleteAction<TMetadataName extends AllMetadataName> =
   AllFlatEntityTypesByMetadataName[TMetadataName]['actions']['delete'];
@@ -64,6 +65,21 @@ export const optimisticallyApplyDeleteActionOnAllFlatEntityMaps = <
 
       return allFlatEntityMaps;
     }
+    case 'navigationMenuItem': {
+      const flatNavigationMenuItemToDelete =
+        findFlatEntityByUniversalIdentifierOrThrow({
+          universalIdentifier: action.universalIdentifier,
+          flatEntityMaps: allFlatEntityMaps.flatNavigationMenuItemMaps,
+        });
+
+      deleteFlatNavigationMenuItemFromMapsAndIndex({
+        flatNavigationMenuItem: flatNavigationMenuItemToDelete,
+        flatNavigationMenuItemMaps:
+          allFlatEntityMaps.flatNavigationMenuItemMaps,
+      });
+
+      return allFlatEntityMaps;
+    }
     default: {
       assertUnreachable(action);
     }

packages/twenty-server/src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/optimistically-apply-update-action-on-all-flat-entity-maps.util.ts

@@ -8,6 +8,7 @@ import { addFlatEntityToFlatEntityAndRelatedEntityMapsThroughMutationOrThrow } f
 import { deleteFlatEntityFromFlatEntityAndRelatedEntityMapsThroughMutationOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/delete-flat-entity-from-flat-entity-and-related-entity-maps-through-mutation-or-throw.util';
 import { findFlatEntityByIdInFlatEntityMapsOrThrow } from 'src/engine/metadata-modules/flat-entity/utils/find-flat-entity-by-id-in-flat-entity-maps-or-throw.util';
 import { getMetadataFlatEntityMapsKey } from 'src/engine/metadata-modules/flat-entity/utils/get-metadata-flat-entity-maps-key.util';
+import { replaceFlatNavigationMenuItemInMapsAndUpdateIndex } from 'src/engine/metadata-modules/flat-navigation-menu-item/utils/replace-flat-navigation-menu-item-in-maps-and-update-index.util';
 import { replaceFlatEntityInFlatEntityMapsThroughMutationOrThrow } from 'src/engine/workspace-manager/workspace-migration/utils/replace-flat-entity-in-flat-entity-maps-through-mutation-or-throw.util';
 import { fromFlatEntityPropertiesUpdatesToPartialFlatEntity } from 'src/engine/workspace-manager/workspace-migration/workspace-migration-runner/utils/from-flat-entity-properties-updates-to-partial-flat-entity';
 
@@ -92,6 +93,27 @@ export const optimisticallyApplyUpdateActionOnAllFlatEntityMaps = <
 
       return allFlatEntityMaps;
     }
+    case 'navigationMenuItem': {
+      const fromFlatNavigationMenuItem =
+        findFlatEntityByIdInFlatEntityMapsOrThrow({
+          flatEntityId: action.entityId,
+          flatEntityMaps: allFlatEntityMaps.flatNavigationMenuItemMaps,
+        });
+
+      const toFlatNavigationMenuItem = {
+        ...fromFlatNavigationMenuItem,
+        ...fromFlatEntityPropertiesUpdatesToPartialFlatEntity(action),
+      };
+
+      replaceFlatNavigationMenuItemInMapsAndUpdateIndex({
+        fromFlatNavigationMenuItem,
+        toFlatNavigationMenuItem,
+        flatNavigationMenuItemMaps:
+          allFlatEntityMaps.flatNavigationMenuItemMaps,
+      });
+
+      return allFlatEntityMaps;
+    }
     default: {
       assertUnreachable(action);
     }