nx-import

Import and merge codebases into an Nx workspace with preserved commit history.

1|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/vreddi/overnight-mountain --skill nx-import-vreddi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nx-import
Source: https://github.com/vreddi/overnight-mountain/tree/main/.cursor/skills/nx-import
Command: npx skills add https://github.com/vreddi/overnight-mountain --skill nx-import-vreddi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of bringing code from external repositories or directories into an existing Nx workspace, ensuring a smooth transition and preserving project history.

Core Features & Use Cases

  • Monorepo Adoption: Facilitates adopting Nx across multiple repositories or migrating existing projects into a monorepo structure.
  • Codebase Merging: Enables merging code and commit history from one repository into another within an Nx workspace.
  • Use Case: You have a standalone React application and want to integrate it into your existing Nx monorepo. This Skill will guide you through the nx import process to bring the application's code and history into the monorepo.

Quick Start

Use the nx-import skill to import the code from the '/path/to/source/repo' directory into the 'apps/new-app' directory of the current Nx 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 existing repository into an Nx workspace?

To import a repository into an Nx workspace, use the `nx import` command to integrate the codebase and preserve its commit history. This process guides the migration of external project directories directly into your monorepo structure.

Can I migrate code into a monorepo while preserving commit history?

Yes, migrating code into a monorepo with an Nx workspace preserves the original commit history. The `nx import` command facilitates repository merging by bringing both the application code and its historical commits into the target workspace.

Does nx import work with Next.js and Vite project configurations?

Yes, `nx import` works with Next.js and Vite configurations. The process specifically addresses technology-specific configurations and resolves common issues related to TypeScript project references when adopting these frameworks into your monorepo.

What are common issues when merging codebases into an Nx workspace?

Common issues when merging codebases into an Nx workspace include conflicts with pnpm workspace globs, managing root dependencies, and resolving TypeScript project references. The import process handles these specific configurations to ensure a smooth transition.

What is the best way to consolidate multiple repositories into a single Nx monorepo?

The best way to consolidate multiple repositories into an Nx monorepo is using the `nx import` command. It streamlines monorepo adoption by integrating standalone applications and merging codebases while maintaining their original commit history.

Why does importing a project into Nx fail with pnpm workspace glob issues?

Importing a project into Nx can fail due to pnpm workspace glob conflicts and root dependency mismanagement. The `nx import` process addresses these specific configuration issues to properly merge external repositories into the workspace.