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

# Updates

> Built-in helpers to help you keep your project up to date.

## Upgrading `zopio`

As `zopio` evolves, you may want to stay up to date with the latest changes. This can be difficult to do manually, so we've created a script to help you.

```sh Terminal theme={"system"}
npx zopio@latest update
```

This will run our update script, which will guide you through the process of updating your project.

```
┌  Let's update your `zopio` project!
│
│
◆  Select a version to update to:
│  ● v1.0.4
│  ○ v1.0.3
│  ○ v1.0.2
│  ○ v1.0.1
│  ○ v1.0.0
└
```

This will clone the latest version of zopio into a temporary directory, apply the updates, and then copy the files over to your project. From here, you can commit the changes and push them to your repository.

<Tip>Because `zopio` is a framework and not a library, you'll likely need to manually merge the changes you've made with the changes from the update.</Tip>

## Upgrading dependencies

You can update the dependency versions in all your `package.json` files with the `bump-deps` command:

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

This command only updates the `package.json` files.
Run `pnpm install` (or `pnpm install -r`) afterward to actually install the upgraded 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.</Tip>

## Upgrading shadcn/ui components

You can upgrade all the shadcn/ui components in the [Design System](/packages/design-system/components) 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. To avoid this happening, we recommend proxying the components into a new folder, such as `@repo/design-system/components`.</Warning>

<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.</Warning>