nx-import

Import repositories into Nx workspaces while preserving project history.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/devswapnil1995/society-management-platform --skill nx-import-devswapnil1995
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nx-import
Source: https://github.com/devswapnil1995/society-management-platform/tree/main/frontend/society-frontend/.opencode/skills/nx-import
Command: npx skills add https://github.com/devswapnil1995/society-management-platform --skill nx-import-devswapnil1995

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers migrate, merge, and organize repositories inside Nx workspaces while preserving project history and avoiding common configuration failures.

Core Features & Use Cases

  • Repository Import Guidance: Provides workflows for using nx import to bring projects or repositories into monorepos.
  • Workspace Migration Support: Handles application and library detection, dependency alignment, TypeScript configuration, plugins, and package manager issues.
  • Use Case: A team moving multiple frontend repositories into an Nx-based monorepo can use this Skill to plan imports, resolve conflicts, and validate the resulting workspace setup.

Quick Start

Use the nx-import skill to bring my existing repository into an Nx workspace and guide me through the required configuration fixes.

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 an existing repository into an Nx workspace, use the nx import workflow to integrate projects while preserving history. This process handles application and library detection, aligns dependencies, and resolves TypeScript configuration conflicts during the monorepo migration.

What is the best way to merge multiple repositories into an Nx monorepo?

Merging multiple repositories into an Nx monorepo requires planning imports, resolving dependency conflicts, and updating workspace configuration. The process uses the nx import workflow to safely integrate separate frontend or backend projects while preserving their project history.

Does migrating to an Nx workspace break my TypeScript configuration?

Migrating to an Nx workspace can cause TypeScript configuration conflicts if not aligned properly. Workspace migration support resolves these issues by updating project boundaries, fixing path aliases, and validating the TypeScript setup across imported applications and libraries.

Can I move an application into an Nx workspace without losing project history?

Yes, you can move an application into an Nx workspace without losing project history by using the nx import workflow. This migration approach preserves your repository history while integrating the application and resolving package manager and plugin configuration updates.

Why does dependency alignment fail during Nx workspace migration?

Dependency alignment fails during Nx workspace migration when imported libraries have conflicting versions or missing workspace boundaries. Resolving these dependency conflicts requires updating package manager configurations and validating project boundaries to ensure the integrated repository functions correctly.

What are the limitations of using nx import for repository migration?

Using nx import for repository migration requires manual validation of framework-specific plugins, package manager setups, and TypeScript configurations. Limitations arise when imported projects have unresolved dependency conflicts or undefined project boundaries that require manual workspace configuration updates.