СтатьиEsc
Антон Ишинкин1 мин чтения

Одна основа для восьми React-приложений: от 4 часов настройки к 30 минутам

Как я собрал общий starter kit для нескольких продуктов: воспроизводимая сборка, интеграция с BFF и единый мониторинг ошибок.

  • Yandex Games
  • React
  • Docker
  • NestJS
  • Frontend Architecture

Восемь приложений, восемь способов собрать проект

У команды было восемь React-приложений, и каждое настраивалось по-своему: своя сборка, свой Dockerfile, свой подход к ошибкам. Запуск нового проекта превращался в полдня копирования из соседнего репозитория и поиска, какие настройки там устарели.

Starter kit вместо копирования

Я подготовил общий шаблон: структуру проекта, линтеры, многоэтапную Docker-сборку и установку зависимостей через npm ci, чтобы сборка на CI и у разработчика давала один и тот же результат. Интеграция с BFF на NestJS идёт в шаблоне из коробки.

Многоэтапная сборка держит в итоговом образе только статику и веб-сервер, без исходников и dev-зависимостей.

Dockerfile · многоэтапная сборка
FROM node:24-alpine AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html

Ошибки в одном месте

Вторая часть основы: централизованный мониторинг клиентских и API-ошибок. Раньше каждое приложение логировало ошибки по-своему, и найти причину сбоя было сложно. Теперь ошибки из всех продуктов попадают в одно место в одинаковом формате.

В результате ручная настройка нового проекта сократилась с 4 часов до 30 минут.

Что я вынес

  • Сборка воспроизводима: npm ci и зафиксированный lockfile.
  • В итоговом образе нет исходников и dev-зависимостей.
  • Ошибки всех продуктов собираются в одном формате.