Simplifies migrating and merging external repositories into an Nx monorepo while preserving git history and fixing configuration conflicts.
The nx-import skill provides specialized guidance for using the 'nx import' command to adopt Nx across multiple repositories or consolidate projects into a unified monorepo. It goes beyond basic command execution by offering expert-level troubleshooting for common migration hurdles, such as fixing pnpm workspace globs, merging root configurations, and resolving TypeScript project reference issues. This skill ensures a smooth transition by identifying the best import strategy based on project type and enforcing destination directory conventions to maintain a clean workspace architecture.
Key Features
01Provides critical fixes for pnpm workspace glob patterns and root dependency merging.
020 GitHub stars
03Preserves full git commit history during project migration and consolidation.
04Guidance on merging nx.json targetDefaults, namedInputs, and plugin configurations.
05Expert troubleshooting for ESLint version pinning and TypeScript 'noEmit' conflicts.
06Automatically distinguishes between applications and libraries for correct directory placement.
Use Cases
01Migrating standalone React, Next.js, or NestJS applications into an existing Nx monorepo.
02Consolidating multiple micro-repositories into a unified workspace to share tooling and configuration.
03Adopting Nx for legacy codebases while keeping all historical git metadata intact.