--- title: Быстрый старт icon: rocket description: Создайте своё первое приложение Twenty за считанные минуты. --- ## Требования * **Node.js 24.5+** — [Скачать здесь](https://nodejs.org/) * **Yarn 4** — поставляется вместе с Node.js через Corepack. Включите его, выполнив `corepack enable` * **Docker** — [Скачать здесь](https://www.docker.com/products/docker-desktop/). Требуется для запуска локального экземпляра Twenty. Пропустите, если у вас уже запущен Twenty в другом месте. Создание приложения Twenty включает три фазы. Генератор каркаса объединяет их в одну команду для идеального сценария (happy path), но каждая фаза — отдельная концепция: когда что-то идёт не так, понимание того, на какой фазе вы находитесь, подскажет, что исправить. | Фаза | Что вы делаете | Инструмент | Результат | | ----------------------- | ------------------------------------------------- | ----------------------------------- | -------------------------------------- | | **1. Создание каркаса** | Сгенерировать исходный код приложения | `npx create-twenty-app` | Проект TypeScript на диске | | **2. Запустить сервер** | Запустить сервер Twenty для синхронизации | Docker + `yarn twenty docker:start` | Запущенный экземпляр Twenty | | **3. Синхронизация** | Синхронизируйте код с сервером в реальном времени | `yarn twenty dev` | Ваши изменения появляются в интерфейсе | --- ## Фаза 1 — Сгенерируйте каркас проекта Создайте новое приложение из шаблона: ```bash filename="Terminal" npx create-twenty-app@latest my-twenty-app ``` Генератор работает в неинтерактивном режиме: имя каталога становится именем приложения. Передайте `--display-name` и `--description`, чтобы настроить создаваемые метаданные (вы также можете отредактировать их позже в `src/constants/universal-identifiers.ts`). Это создаёт проект TypeScript в `my-twenty-app/` с начальным файлом `application-config.ts`, ролью по умолчанию, рабочими процессами CI/CD и интеграционным тестом. **После этой фазы:** у вас есть исходный код приложения на вашем компьютере. Он ещё не запущен — это фаза 2. --- ## Фаза 2 — Запустите локальный сервер Twenty Вашему приложению нужен сервер Twenty для синхронизации. Сервер — это полноценный экземпляр Twenty — UI, GraphQL API, PostgreSQL — работающий локально в Docker. Ваш локальный код загружает свои определения на этот сервер, благодаря чему они появляются в интерфейсе. Генератор запускает её за вас: при запущенном Docker он скачивает образ `twentycrm/twenty-app-dev`, запускает его на порту `2020` и аутентифицирует CLI в предварительно заполненном демо‑workspace (`tim@apple.dev`) — вход не требуется. Чтобы вместо этого подключиться к существующему серверу Twenty, передайте `--url \`. Удалённые серверы аутентифицируются через OAuth: открывается браузер, чтобы вы могли войти в систему и нажать **Authorize**, после чего CLI получает доступ к вашему workspace. (Локально вы тоже можете включить OAuth с помощью `--authentication-method oauth` — войдите, используя `tim@apple.dev` / `tim@apple.dev`.)
Экран входа в Twenty
Экран авторизации Twenty CLI
В вашем терминале появится подтверждение, что всё настроено.
Каркас приложения успешно создан
**После этой фазы:** у вас запущен сервер Twenty на [http://localhost:2020](http://localhost:2020), а ваш CLI авторизован для синхронизации с ним. Если Docker не установлен или не запущен, генератор каркаса подскажет правильную команду запуска для вашей ОС. Когда Docker будет запущен, вы можете продолжить с `yarn twenty docker:start` — заново генерировать каркас не нужно. --- ## Фаза 3 — Синхронизируйте свои изменения Это внутренний цикл, в котором вы проведёте большую часть времени. ```bash filename="Terminal" cd my-twenty-app yarn twenty dev ``` Эта команда отслеживает `src/`, пересобирает при каждом изменении и синхронизирует результат с сервером. Отредактируйте файл, сохраните — и через несколько секунд сервер отразит изменения. В терминале появится панель текущего статуса. Для более подробного вывода (журналы сборки, запросы синхронизации, трассировки ошибок) добавьте `--verbose`.
Вывод терминала в режиме разработки
Откройте [http://localhost:2020/settings/applications#developer](http://localhost:2020/settings/applications#developer). Вы должны увидеть своё приложение в разделе **Your Apps**.
Список Your Apps с приложением My twenty app
Нажмите **My twenty app**, чтобы открыть его регистрацию приложения — запись на уровне сервера, описывающую ваше приложение (имя, идентификатор, учётные данные OAuth, источник). Одну и ту же регистрацию можно установить в нескольких рабочих пространствах на одном сервере.
Сведения о регистрации приложения
Нажмите **View installed app**, чтобы посмотреть установку в рабочем пространстве. Вкладка **About** показывает версию и параметры управления.
Установленное приложение
**После этой фазы:** у вас есть интерактивный цикл разработки. Отредактируйте любой файл в `src/`, и он появится в интерфейсе. ### Разовая синхронизация для CI и скриптов Используйте `plan` и `apply`, чтобы один раз запустить тот же конвейер без наблюдателя: ```bash filename="Terminal" yarn twenty plan # preview the metadata changes without applying them yarn twenty apply # show the plan, then apply it ``` | Команда | Поведение | Когда использовать | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | `yarn twenty dev` | Отслеживает и повторно синхронизирует при каждом изменении. Продолжает работать, пока вы его не остановите. | Интерактивная локальная разработка. | | `yarn twenty apply` | Одна сборка и синхронизация, завершает работу с кодом `0` при успехе и `1` при ошибке. Запрашивает подтверждение при разрушительных изменениях (передайте `--force`, чтобы пропустить). | CI, хуки pre-commit, AI-агенты, скриптовые рабочие процессы. | | `yarn twenty plan` | Создает и выводит изменения метаданных **без их применения**. | Проверка того, какие изменения внесет синхронизация, прежде чем зафиксировать их. | Все режимы требуют аутентифицированного удалённого сервера. Смотрите раздел [Syncing & recovery](/l/ru/developers/extend/apps/operations/sync-and-recovery#previewing-changes-plan) для получения дополнительной информации о `plan`. `yarn twenty dev --once` и `yarn twenty dev --once --dry-run` являются устаревшими псевдонимами для `yarn twenty apply` и `yarn twenty plan`. ### Параметры режима разработки | Флаг | Описание | | ------------------------------------- | ------------------------------------------------------------------------------------- | | `--force` | Применяет разрушительные изменения (удаления) без подтверждения. | | `--debounceMs \` | Установить задержку дебаунса изменений файлов в миллисекундах (по умолчанию: `1000`). | | `--verbose` / `--debug` | Показывать подробные журналы сборки, запросы синхронизации и трассировки ошибок. | ## Что вы можете создать Приложения состоят из **сущностей** — каждая определена как файл TypeScript с одним `export default`: | Сущность | Что делает | | ----------------------------- | --------------------------------------------------------------------------------------------------------- | | **Объекты и поля** | Пользовательские модели данных (почтовая открытка, счёт и т. д.) с типизированными полями | | **Логические функции** | Серверный TypeScript, запускаемый HTTP-маршрутами, расписаниями cron или событиями базы данных | | **Фронтенд-компоненты** | React-компоненты, которые отображаются внутри интерфейса Twenty (боковая панель, виджеты, командное меню) | | **Навыки и агенты** | Возможности ИИ — многократно используемые инструкции и автономные помощники | | **Представления и навигация** | Предварительно настроенные представления списков и элементы бокового меню | | **Макеты страниц** | Пользовательские страницы сведений о записи с вкладками и виджетами | Полная справка: [Концепции](/l/ru/developers/extend/apps/getting-started/concepts). ## Следующие шаги Идентификация приложения, роль по умолчанию, хуки установки и удаления, публичные ресурсы. Объекты, поля и двунаправленные связи. Логические функции, навыки, агенты и OAuth-подключения. Представления, навигация, макеты страниц, фронтенд-компоненты. CLI, тестирование, удалённые серверы, CI и публикация вашего приложения.