Когда фронтенд, бэкенд и общие библиотеки живут в одном репозитории, рано или поздно встаёт вопрос инструментов: как ускорить сборку, переиспользовать код и не утонуть в дублировании зависимостей. В экосистеме JavaScript и TypeScript за это отвечают три имени, которые постоянно сравнивают между собой: pnpm workspaces, Turborepo и Nx. Они решают разные задачи, и понимание разницы экономит недели на миграциях.

Чем эти инструменты вообще различаются

Главная путаница в том, что их ставят в один ряд, хотя они работают на разных уровнях. pnpm workspaces — это менеджер пакетов со встроенной поддержкой нескольких пакетов в одном репозитории. Turborepo — это раннер задач с кэшированием поверх любого менеджера. Nx — полноценная платформа для монорепозитория с генераторами кода, плагинами и распределённым CI.

  • pnpm workspaces отвечает за установку зависимостей и связи между пакетами.
  • Turborepo отвечает за то, чтобы задачи (сборка, тесты, линт) выполнялись быстро и кэшировались.
  • Nx закрывает весь жизненный цикл: от генерации модулей до релиза и распределения задач по агентам.

На практике pnpm и Turborepo часто работают вместе: pnpm управляет пакетами, Turborepo кэширует задачи поверх них. А Nx можно поставить и поверх pnpm workspaces, если нужны его генераторы и распределённый CI. Поэтому правильный вопрос не «что из трёх», а «какой уровень мне сейчас нужен».

Что вообще даёт монорепозиторий

Прежде чем выбирать инструмент, стоит понять, ради чего вообще держать всё в одном репозитории. Основных выгод несколько: общий код переиспользуется без публикации в реестр, изменения в библиотеке и в её потребителях попадают в один коммит, а зависимости легче держать в согласованных версиях. Обратная сторона — без инструментов сборка и CI быстро становятся медленными: каждый прогон пересобирает всё подряд. Именно эту боль и снимают раннеры задач с кэшированием.

pnpm workspaces: фундамент

Если проект небольшой, иногда достаточно одного pnpm. Он умеет связывать локальные пакеты, экономит место на диске за счёт общего хранилища и не требует отдельного конфига для раннера. В версии 9.5 (июль 2024) появились pnpm Catalogs — централизованное описание версий зависимостей в pnpm-workspace.yaml. Это снимает боль, когда десяток пакетов используют разные версии одной библиотеки: версия описывается один раз, а пакеты ссылаются на неё. Catalogs работают и сами по себе, и в связке с Turborepo или Nx. Для прототипа или библиотеки из двух-трёх пакетов часто этого и достаточно — добавлять раннер задач имеет смысл, когда сборки станут заметно тормозить.