What problem does it solve?
Importing repositories into an Nx workspace is error-prone and involves many manual fixes: preserving git history, avoiding directory conflicts, merging root dependencies and Nx configuration, updating pnpm workspace globs, and repairing TypeScript, ESLint, and testing setups after import. This Skill documents the recommended strategies, gotchas, and fix order required to reliably adopt Nx across single-project repos and multi-project monorepos.
Core Features & Use Cases
- Preserve history: Use nx import to bring code and commit history into the destination workspace.
- Import strategies: Guidance for subdirectory-at-a-time imports vs whole-repo imports and when to use each.
- Workspace fixes: Steps to repair pnpm workspace globs, merge root package.json and nx.json settings, and resolve dependency version conflicts.
- Tooling adjustments: Instructions for TypeScript project references (nx sync / nx reset), executor path fixups, and plugin detection/installation for ESLint, Jest, Vite, Next.js, Gradle, and Turborepo migrations.
- Common gotchas: Advice on stale lockfiles/node_modules, .gitkeep blocking, project name collisions, and frontend tsconfig base settings.
Quick Start
Import the source repository into this workspace with nx import, preserve git history, and then reconcile root dependencies, pnpm workspace globs, and nx.json targetDefaults.