Nx Monorepo

---
name: nx-monorepo
description: |
  Управление Nx монорепо. Используй при:
  - Запуске задач (build, test, lint, dev)
  - Настройке кэширования и CI
  - Работе с affected командами
  - Добавлении проектов/библиотек
  - Настройке зависимостей между проектами
  - Troubleshooting Nx
---

# Nx Monorepo

Руководство по управлению Nx монорепо.

## Quick Reference

```bash
# Основные команды
nx dev <project>           # Запуск dev сервера
nx build <project>         # Сборка проекта
nx lint <project>          # Линтинг (oxlint + ESLint)
nx test <project>          # Тесты
nx typecheck:tsgo <project> # Проверка типов (9-38x быстрее!)

# Форматирование — ТОЛЬКО так, голая `nx format`/`nx format:write` жёстко зашита на Prettier
nx run-many -t format --projects=<project>

# Множественные задачи
nx run-many -t build       # Собрать все проекты
nx affected -t test        # Тестировать только изменённые

# Утилиты
nx graph                   # Визуализация зависимостей
nx reset                   # Очистить кэш и daemon
nx show project <name>     # Информация о проекте
```

⛔ **`nx sync` здесь не работает** — генератор `@nx/js:typescript-sync` отключён в `nx.json`
(`sync.disabledTaskSyncGenerators`), в CI и git-хуках не вызывается. `references` в `tsconfig.json`
правятся руками, и чаще всего не требуют правки вовсе:
[environment.md](/.claude/docs/environment.md#разработка-shared-библиотек).

---

## Версия Nx

- **Nx:** 23.x (точная версия — `package.json`)
- **Пакетный менеджер:** Bun

---

## Проекты в Workspace

Список проектов и портов — MCP `nx_workspace` и `apps/<app>/.env`; ручной таблицы портов нет и заводить её не нужно ([environment](/.claude/docs/environment.md)).

## Ключевые концепции

| Концепция          | Описание                           |
| ------------------ | ---------------------------------- |
| **Target**         | Задача проекта (build, test, lint) |
| **Executor**       | Исполнитель задачи                 |
| **dependsOn**      | Зависимости между задачами         |
| **affected**       | Только изменённые проекты          |
| **inputs/outputs** | Контроль кэширования               |
| **tags**           | Метки для module boundaries        |

---

## Перед коммитом

```bash
nx run-many -t format --projects=<project>  # Форматирование (dprint)
nx lint <project>                           # Линтинг (oxlint + ESLint)
nx typecheck:tsgo <project>                 # Проверка типов
```

---

## См. также

- [reference/commands.md](reference/commands.md) — Все команды
- [reference/configuration.md](reference/configuration.md) — nx.json, project.json
- [reference/caching.md](reference/caching.md) — Кэширование
- [reference/affected.md](reference/affected.md) — Affected команды
- [reference/plugins.md](reference/plugins.md) — Плагины
- [reference/project-structure.md](reference/project-structure.md) — Теги, boundaries
- [reference/troubleshooting.md](reference/troubleshooting.md) — Проблемы