monorepo-management

Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management. Use when setting up monorepos, optimizing builds, or managing shared dependencies.

1. Utwórz nowy projekt monorepo za pomocą Turborepo, uruchamiając npx create-turbo@latest my-monorepo i przejdź do katalogu projektu. Struktura będzie zawierać foldery apps/ (aplikacje takie jak Next.js), packages/ (komponenty UI, konfiguracje wspólne) oraz plik turbo.json do konfiguracji.

2. Zainstaluj pnpm jako menedżer pakietów (rekomendowany dla monorepo) i skonfiguruj workspace'y, definiując zależności między pakietami w głównym package.json.

3. Skonfiguruj turbo.json, definiując pipeline buildów — określ, które zadania zależą od siebie (np. build zależy od poprzedniego build'u w pakietach zależnych) i jakie zmienne środowiskowe wpływają na cache.

4. Użyj skill'u do optymalizacji buildów poprzez cache'owanie wyników Turborepo, co przyspiesza iteracje deweloperskie i CI/CD.

5. Zarządzaj wspólnymi zależnościami i kodem — umieszczaj komponenty UI, konfiguracje TypeScript i narzędzia w packages/, a aplikacje w apps/, aby umożliwić atomowe commity i łatwe refaktoryzacje.

6. Debuguj problemy specyficzne dla monorepo, takie jak konflikty wersji zależności, problemy z cache'em Turborepo lub złe konfiguracje pipeline'u, korzystając z wiedzy zawartej w skill'u.