| name | local-package |
| description | Use Clipboard's internal CLI to link and unlink @clipboard-health packages across repositories for local development. Use when testing local package changes, linking @clipboard-health packages between repos, or using the cbh CLI local-package command. |
Local Package Development
Use Clipboard's internal CLI (@clipboard-health/cli) to test package changes across repositories without publishing. The cbh local-package command wraps yalc to simplify linking packages between sibling repositories.
Prerequisites
See the CLI README for setup instructions.
Commands
Link packages
From the consuming repository, link packages from sibling repos:
cbh local-package link --packages <package-names...>
Example:
cbh local-package link --packages util-ts
This will:
- Find the package in sibling
packages/* directories
- Build the package with nx
- Push the built package to yalc
- Update your
package.json to use the yalc version
Unlink packages
After testing, restore the published package versions:
cbh local-package unlink --packages <package-names...>
Example:
cbh local-package unlink --packages util-ts
Workflow Example
To test changes to util-ts in cbh-mobile-app:
-
Make changes to util-ts in core-utils
-
From cbh-mobile-app root, run:
cbh local-package link --packages util-ts
-
Test your changes in cbh-mobile-app
-
When done, unlink:
cbh local-package unlink --packages util-ts
Troubleshooting
- Package not found: Ensure the package exists in a sibling repo's
packages/ directory
- Build fails: The package must have a valid nx build target
- Changes not reflected: Run
npm install after linking to pull in the yalc version
