monorepo-import-guard

Monorepo Workspace Imports Guard: A zero-dependency workspace tool that audits and automatically repairs relative file imports pointing across package boundaries within a monorepo.

⚡ Features

• Zero Runtime Dependencies: Ultra lightweight and fast.
• Cross-package Relative Import Audit: Scans code files and resolves relative paths to check if they reference other packages in the workspaces folder.
• Auto-Sync Repair: Automatically rewrites long relative paths (e.g. ../../package-a/src/util) to use proper workspace package scopes (e.g. package-a/util).

📦 Installation

npm install monorepo-import-guard

🚀 Usage

1. CLI Usage

Scan package imports inside a monorepo:

npx monorepo-import-guard

# Automatically fix broken relative imports
npx monorepo-import-guard --sync

# Specify custom monorepo root dir
npx monorepo-import-guard --dir ./my-project

2. Programmatic API

import { guardImports } from 'monorepo-import-guard';

const fixes = await guardImports(process.cwd(), true);
console.log(`Repaired ${fixes.length} relative workspace imports.`);

📄 License

MIT License.