> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

## Catalyst upgrade keeps dependency versions current

`catalyst upgrade` now carries `@bigcommerce/catalyst*` dependency version bumps through its merge automatically, the same as any other `package.json` change.

* **Dependency versions move with the merge** — a project pinned to a real semver range picks up the version the target release shipped, or surfaces a conflict if you pinned that dependency deliberately.
* **Projects still on `workspace:^`** get an opt-in migration prompt after the merge, offering to swap to the published version so future upgrades can keep it current the normal way.
* **New upgrade guide** walks through prerequisites, running the command, recommended upgrade cadence, and how the dependency migration prompt works.

For details, see [Upgrading](/developer/docs/storefront/catalyst/getting-started/upgrading) and the [Catalyst CLI reference](/developer/docs/storefront/catalyst/reference/cli#upgrade).