Skip to content

Upgrading Vite+

Use vp upgrade to update the global vp binary, and use Vite+'s package management commands to update the local vite-plus package in a project.

Overview

There are two parts to upgrading Vite+:

  • The global vp command installed on your machine
  • The local vite-plus package used by an individual project

You can upgrade both of them independently.

Global vp

bash
vp upgrade              # upgrade to the latest version
vp upgrade --check      # check for updates without installing

Rollback

Vite+ keeps the 3 most recent versions installed so you can revert quickly:

bash
vp upgrade --rollback

Older versions are pruned automatically after each upgrade. The active version and the previous version are always kept, so a rollback target is never removed.

Local vite-plus

Update the project dependency with the package manager commands in Vite+:

bash
vp update vite-plus

Projects created or migrated by Vite+ declare vite-plus with a version range (for example ^0.1.24), so vp update vite-plus picks up new releases within that range. To move beyond the range, update the range explicitly:

bash
vp update --latest vite-plus
# or
vp add vite-plus@latest

Updating Aliased Packages

Vite+ sets up npm aliases for its core packages during installation:

  • vite is aliased to npm:@voidzero-dev/vite-plus-core@^x.y.z
  • vitest is aliased to npm:@voidzero-dev/vite-plus-test@^x.y.z

vp update vite-plus does not re-resolve these aliases in the lockfile. To fully upgrade, update them separately:

bash
vp update @voidzero-dev/vite-plus-core @voidzero-dev/vite-plus-test

Or update everything at once:

bash
vp update vite-plus @voidzero-dev/vite-plus-core @voidzero-dev/vite-plus-test

You can verify with vp outdated that no Vite+ packages remain outdated.