> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipthing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing dependencies

> Learn how to manage dependencies in your project.

## Install dependencies

To install a package you need to decide whether you want to install it to the root of the monorepo or to a specific workspace. Installing it to the root makes it available to all packages, while installing it to a specific workspace makes it available only to that workspace.

* To install a package globally, run:

```sh Terminal theme={"system"}
pnpm add -w <package-name>
```

* To install a package to a specific workspace, run:

```sh Terminal theme={"system"}
pnpm add --filter <workspace-name> <package-name>
```

Or go to the folder where you want to install the package and run:

```sh Terminal theme={"system"}
pnpm add <package-name>
```

## Remove dependencies

Removing a package is the same as installing but with the `remove` command.

* To install a package globally, run:

```sh Terminal theme={"system"}
pnpm remove -w <package-name>
```

* To install a package to a specific workspace, run:

```sh Terminal theme={"system"}
pnpm remove --filter <workspace-name> <package-name>
```

## Upgrading dependencies

You can upgrade all the dependencies in all your `package.json` files and installs the new versions with the `bump-deps` command:

```sh Terminal theme={"system"}
pnpm bump-deps
```

This will update all the dependencies in your `package.json` files and install the new versions.

> [!TIP]
>
> You should run a `pnpm build` after running `bump-deps` to ensure the project builds correctly. You should also run `pnpm dev` and ensure the project runs correctly in runtime.

## Upgrading shadcn/ui components

You can upgrade all the shadcn/ui components in the [Design System](https://docs.shipthing.com/packages/design-system/components.md) package with the `bump-ui` command:

```sh Terminal theme={"system"}
pnpm bump-ui
```

This will update all the shadcn/ui components, as well as the relevant dependencies in the Design System's `package.json` file.

> [!WARNING]
>
> This will override all customization you've made to the components folder `@repo/design-system/components`. To avoid this happening, we recommend not to modify the code directly. If the shadcn components not satisfies your need , build your own instead of changing the shadcn components.

> [!WARNING]
>
> The `shadcn` CLI will likely make some unwanted changes to your shared Tailwind config file and global CSS. Make sure you review changes before committing them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.