nx-import

What problem does it solve?

This Skill documents how to import, merge, or combine external repositories or subdirectories into an existing Nx workspace while preserving commit history and avoiding common post-import breakages. It addresses the friction of adopting Nx across multiple repos, resolving workspace globs, dependency mismatches, TypeScript project reference errors, and plugin/ESLint/test configuration drift that typically follow an import.

Core Features & Use Cases

• Preserve Git History: Guidance for using nx import to retain commit history during migration.
• Import Strategies: Recommendations for subdirectory-at-a-time versus whole-repo imports and when to use each.
• Post-Import Fixes: Actionable fixes for pnpm workspace globs, root dependencies and nx.json merges, explicit executor path adjustments, TypeScript project reference sync, ESLint and Jest/Vite/Next plugin setup, and Turborepo config migrations.
• Use Case: Consolidate multiple service and library repositories into a single monorepo, migrate a create-next-app into apps/, or bring legacy pnpm workspaces under Nx control while preserving CI and dev workflows.

Quick Start

Run nx import to move a source repository or project into your Nx workspace while preserving its git history, then apply the documented fixes for pnpm workspace globs, root dependency merges, TypeScript references, and required Nx plugins.