Обзор - Twenty Documentation

Слой компоновки приложения Twenty — это всё, что видит пользователь: где приложение отображается в боковой панели, какие списки представлений оно поставляет, как устроены его страницы деталей записей и какие пользовательские React‑компоненты отображаются внутри этих страниц.

   Sidebar               Record list            Record detail page
   ───────               ───────────            ──────────────────
   [📋 My View]    ────▶ ┌──────────┐          ┌─────────────────────┐
   [📋 Drafts ]          │ Companies│          │ Tabs: [Overview ]   │
   [📋 Inbox  ]          │ ──────── │          │       [Notes    ]   │
        ▲                │  Apple   │          │       [Hello    ]◀──── definePageLayoutTab
        │                │  Acme    │          │                     │   adds a tab...
        └ defineNavi-    │  …       │          │  ┌────────────────┐ │
          gationMenu-    └────▲─────┘          │  │                │ │
          Item points         │                │  │   React UI     │◀── …with a
          to a defineView     │                │  │  (sandboxed in │ │   defineFrontComponent
                              └ defineView     │  │   a Worker)    │ │   widget inside
                                picks columns  │  └────────────────┘ │
                                and filters    └─────────────────────┘

В этом разделе

Представления

defineView — сохранённые конфигурации списков: видимые столбцы, фильтры, группы.

Элементы меню навигации

defineNavigationMenuItem — элементы боковой панели, ссылающиеся на представления или внешние URL.

Макеты страниц

definePageLayout и definePageLayoutTab — вкладки и виджеты на странице деталей записи.

Компоненты фронтенда

defineFrontComponent — изолированные React‑компоненты, которые отображаются внутри Twenty.

Элементы меню команд

defineCommandMenuItem — регистрирует фронтенд‑компоненты как элементы Cmd+K и быстрые действия.

Где отображается приложение

Область отображения	Что определяет	Сущность
Боковая панель	Пользовательский элемент, который ссылается на сохранённое представление или внешний URL	`defineNavigationMenuItem`
Список записей	Сохранённая конфигурация для объекта — видимые столбцы, порядок, фильтры, группы	`defineView`
Страница деталей записи	Вкладки и виджеты на странице записи (вашего собственного объекта или стандартного)	`definePageLayout`, `definePageLayoutTab`
Внутри любого из перечисленного выше	Пользовательский React‑виджет — кнопки, формы, панели мониторинга, интеграции	`defineFrontComponent`
Меню команд (Cmd+K)	Закреплённое быстрое действие или скрытая команда	`defineCommandMenuItem`

Фронтенд‑компоненты выполняются внутри изолированного Web Worker с использованием Remote DOM — они отображаются нативно на странице (не внутри iframe), но не могут напрямую обращаться к хостовой странице или DOM. Взаимодействие с Twenty происходит через хостовый API обмена сообщениями.

​В этом разделе