# Local Package

> 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. Use when this capability is needed.

- Skill: `tomevault-io/local-package` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/local-package`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/local-package/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/local-package

---


# 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](https://www.npmjs.com/package/yalc) to simplify linking packages between sibling repositories.

## Prerequisites

See the [CLI README](https://github.com/ClipboardHealth/cbh-core/tree/main/packages/cli#local-package) for setup instructions.

## Commands

### Link packages

From the consuming repository, link packages from sibling repos:

```bash
cbh local-package link --packages <package-names...>
```

Example:

```bash
cbh local-package link --packages ui-theme ui-components
```

This will:

1. Find the package in sibling `packages/*` directories
2. Build the package with nx
3. Push the built package to yalc
4. Update your `package.json` to use the yalc version

### Unlink packages

After testing, restore the published package versions:

```bash
cbh local-package unlink --packages <package-names...>
```

Example:

```bash
cbh local-package unlink --packages ui-theme ui-components
```

## Workflow Example

To test changes to `ui-theme` in `cbh-mobile-app`:

1. Make changes to `ui-theme` in `cbh-core`
2. From `cbh-mobile-app` root, run:

   ```bash
   cbh local-package link --packages ui-theme
   ```

3. Test your changes in `cbh-mobile-app`
4. When done, unlink:

   ```bash
   cbh local-package unlink --packages ui-theme
   ```

## 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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/clipboardhealth) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->