nx-import

Import external codebases into an Nx monorepo while preserving Git history.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/cyrus-rumao/attendance-monorepo --skill nx-import-cyrus-rumao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nx-import
Source: https://github.com/cyrus-rumao/attendance-monorepo/tree/main/.gemini/skills/nx-import
Command: npx skills add https://github.com/cyrus-rumao/attendance-monorepo --skill nx-import-cyrus-rumao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of bringing codebases from external repositories or directories into an existing Nx workspace, preserving history and ensuring compatibility.

Core Features & Use Cases

  • Monorepo Adoption: Adopt Nx across multiple repositories or migrate projects into a new monorepo structure.
  • Code Merging: Combine code and commit history from other repositories into your current Nx workspace.
  • Use Case: You have a legacy project in a separate Git repository and want to integrate it into your main Nx monorepo. This Skill will help you import the project's code and its entire Git history into the monorepo.

Quick Start

Import the 'shared-ui' library from the '/path/to/source/repo' directory into the 'libs/shared/ui' directory of the current workspace.

Frequently Asked Questions about nx-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import an external repository into an Nx monorepo while preserving Git history?

You can import external repositories into an Nx monorepo while preserving Git history by using strategies that support either whole-repo or subdirectory-at-a-time codebase integration.

What is the best way to handle pnpm workspace globs and root dependencies when migrating to an Nx workspace?

When migrating to an Nx workspace, the import process addresses common issues like pnpm workspace globs and root dependencies by automatically fixing configurations to ensure compatibility within the monorepo.

Can I integrate a Next.js or Vite project from a separate Git repository into my current Nx workspace?

Yes, you can integrate a Next.js or Vite project from a separate Git repository into your current Nx workspace, as the import process handles technology-specific configurations for frameworks like Next.js, Vite, Gradle, and Jest.

How do TypeScript project references and executor paths get updated during an Nx codebase integration?

During an Nx codebase integration, TypeScript project references and explicit executor path fixups are automatically handled and updated to ensure the imported code correctly aligns with the new monorepo structure.

Does migrating a Turborepo project into an Nx monorepo require manual configuration fixes?

Migrating a Turborepo project into an Nx monorepo does not require extensive manual configuration fixes, as the import mechanism specifically handles technology-specific configurations for Turborepo to ensure a seamless transition.