migrate-catalog v1.0.0
Migrate Catalog
Migrate Catalog is a CLI tool for automating the migration of dependency versions from a centralized catalog
in your pnpm-workspace.yaml
file to all package.json
files in a monorepo. This tool streamlines version updates in pnpm workspaces, saving time and reducing manual errors.
Features
- Automated Migration: Scans all
package.json
files and replaces"catalog:"
with the correct version from yourpnpm-workspace.yaml
catalog. - Monorepo Support: Built to work seamlessly in multi-package repositories managed by pnpm.
- Easy Integration: Ideal for CI/CD pipelines and local development environments.
- Customizable: Extendable for additional dependency sections or custom update logic.
Installation
Install the package globally with npm:
npm install -g migrate-catalog
Or use it via npx:
npx migrate-catalog
Usage
Run the tool from the root of your monorepo:
migrate-catalog
The script will:
- Read the
catalog
section frompnpm-workspace.yaml
. - Recursively locate all
package.json
files (ignoringnode_modules
). - Update dependencies with the version placeholder
"catalog:"
to the actual version from the catalog.
Getting Started
Configure Your Monorepo: Ensure your
pnpm-workspace.yaml
includes a validcatalog
section and that yourpackage.json
files have dependencies with"catalog:"
as their version.Run Migrate Catalog: Execute the tool in your project root and verify that the updates have been applied across your packages.
Contributing
Contributions are welcome! Fork the repository, create your feature branch, and submit a pull request with your enhancements.
License
This project is licensed under the MIT License.
Keywords
catalog migration, monorepo, pnpm, npm package, dependency management, version automation, node CLI tool, automated version update
4 months ago