monorepo-management

Run npx create-turbo@latest to scaffold the project, then define workspaces in pnpm-workspace.yaml listing apps and packages directories. Configure build pipelines in turbo.json with dependsOn and outputs, and add turbo run scripts to the root package.json.

Turborepo is recommended for most teams due to its simpler configuration focused on task pipelines and caching. Nx offers more features like code generators and dependency graph visualization but adds complexity, while Lerna is in maintenance mode.

Use pnpm's filter flag, for example pnpm add react --filter @repo/ui, to install a dependency in a specific package. Add -w to install at the workspace root, or use pnpm -r to run commands across all packages.

Cache misses usually happen when inputs are misconfigured or outputs are missing from the pipeline definition. Ensure turbo.json lists all source files in inputs and all build artifacts like dist/** in outputs for each task.

Use Changesets: install @changesets/cli, run pnpm changeset to record version bumps, then pnpm changeset version and pnpm changeset publish. The changesets GitHub Action can automate release pull requests and publishing in CI.

Common pitfalls include circular dependencies between packages, phantom dependencies not declared in package.json, incorrect cache inputs, and over-sharing or under-sharing code. Keep the dependency graph acyclic and centralize shared configs.