re:re:actable
Урок 023 минуты чтения

Как масштабировать фронтенд: монорепозиторий, модули и микрофронтенды

На этой странице
Кратко

Когда над фронтендом работают несколько команд, архитектура должна позволять менять код независимо: четкие границы модулей с публичным API (Feature-Sliced Design, доменные модули), монорепозиторий с общими пакетами (UI-кит, утилиты, конфиги) и инструментами сборки (Turborepo, Nx, pnpm workspaces), а при необходимости — микрофронтенды, которые собираются и деплоятся отдельно. Правило: начинать с модульного монолита и переходить к микрофронтендам только при реальной организационной необходимости.

Вопрос

Как масштабировать фронтенд-приложение и кодовую базу, когда растет команда? Что такое монорепозиторий и микрофронтенды и когда они оправданы?

Ступени масштабирования

1. Модульный монолит      одно приложение, границы фич, публичные API модулей
2. Монорепозиторий        несколько приложений и общие пакеты в одном репозитории
3. Микрофронтенды         независимые сборки и деплои частей интерфейса

1. Модули с границами

src/
  app/            инициализация, провайдеры, роутинг
  pages/          страницы
  widgets/        крупные блоки страниц
  features/       пользовательские действия: add-to-cart, auth-by-phone
  entities/       бизнес-сущности: user, product, order
  shared/         UI-кит, api-клиент, утилиты
  • импорт только сверху вниз по слоям и только через index.ts модуля;
  • правила проверяются линтером (eslint-plugin-boundaries, Steiger для FSD);
  • владельцы кода (CODEOWNERS) для каждой зоны.

2. Монорепозиторий

apps/
  web/            основное приложение (Next.js)
  admin/          админка (Vite)
packages/
  ui/             дизайн-система
  api-client/     сгенерированный из OpenAPI клиент
  config/         eslint, tsconfig, prettier
  utils/
ПлюсыМинусы
атомарные изменения во всех пакетах одним PRсборка и CI растут без кеширования
общие версии зависимостей и конфигинужна дисциплина границ
переиспользование без публикации в npmинструменты требуют настройки

Инструменты: pnpm workspaces (связывание пакетов), Turborepo или Nx (граф задач, кеш сборки и тестов, запуск только затронутого — affected), Changesets (версии пакетов).

3. Микрофронтенды

Каждая команда владеет частью интерфейса от разработки до деплоя: каталог, корзина, личный кабинет.

Способ интеграцииКак работаетОсобенности
Разные маршруты (multi-zone)/shop/* — одно приложение, /account/* — другоепроще всего, переход между зонами — полная загрузка
Module Federationприложение загружает модули другого в рантаймеобщий React как singleton, сложная настройка версий
Web Componentsчасти оформлены как custom elementsизоляция Shadow DOM, сложнее SSR
iframeполная изоляцияплохо для UX, SEO, a11y
Серверная композициясервер или edge собирает HTML фрагментовхорошо для SEO, сложная инфраструктура

Обязательные договоренности: общая дизайн-система, общий способ авторизации, коммуникация через события или URL (а не через общий глобальный store), контроль размера бандла (нет пяти копий React), сквозной мониторинг.

Когда что выбирать

СитуацияРешение
одна-две командымодульный монолит
несколько приложений с общими компонентамимонорепозиторий
много автономных команд, независимые релизы, разные циклымикрофронтенды
миграция legacy-приложения по частяммикрофронтенды как временный шаг

Что важно помнить

  • Микрофронтенды решают организационную проблему (независимость команд), а не техническую; цена — сложность, производительность и согласованность UX.
  • Границы модулей важнее инструментов: без них и монорепо, и микрофронтенды превращаются в связанный монолит.
  • Кеш сборки и запуск только затронутого кода (affected) — основа быстрого CI в монорепозитории.
  • Связанные темы: Feature-Sliced Design, микрофронтенды с React, изоляция модулей.

Мини-шпаргалка

Модульный монолит (слои, публичные API, линтер границ) → монорепо (pnpm workspaces, Turborepo/Nx, общие пакеты, affected) → микрофронтенды (маршруты, Module Federation, Web Components, серверная композиция) только при многих автономных командах. Общие: дизайн-система, auth, события, мониторинг.

Документация

Turborepo, Nx, pnpm: Workspaces, Martin Fowler: Micro Frontends, Module Federation.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам