You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guide/upgrade.md
+2-62Lines changed: 2 additions & 62 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -90,72 +90,12 @@ The installer resolves the ref to its `0.0.0-commit.<sha>` build through the reg
90
90
91
91
### Local `vite-plus` Preview
92
92
93
-
There are two ways to move a project's local `vite-plus` onto a preview build.
94
-
95
-
#### With `vp migrate` (recommended)
96
-
97
-
After installing the preview global CLI above, run migrate in the project:
93
+
After installing the preview global CLI above, run migrate in the project to move its local `vite-plus` onto the same build:
98
94
99
95
```bash
100
96
vp migrate
101
97
```
102
98
103
99
Migrate points the project at the bridge registry (writing it to `.npmrc`, or `.yarnrc.yml` for Yarn Berry) and pins `vite-plus` and the `vite` -> `@voidzero-dev/vite-plus-core` alias to the matching `0.0.0-commit.<sha>` version. That registry line is what lets the same versions resolve in the project's own CI, so commit it if you want CI to test the preview too.
104
100
105
-
#### By hand
106
-
107
-
Point your package manager at the bridge registry, then pin the commit version. Use the version from the pull request comment (or from `vp --version`).
108
-
109
-
Configure the registry:
110
-
111
-
| Package manager | Registry config |
112
-
| --- | --- |
113
-
| npm / pnpm / Bun |`.npmrc`: `registry=https://registry-bridge.viteplus.dev/`|
Then pin `vite-plus` and any `vite` alias to the commit version, exactly like ordinary npm versions. For npm and Bun projects, update the relevant `package.json` entries:
Only include the direct `vite` entry if your project already has one. If your project has `@voidzero-dev/vite-plus-core` directly instead, pin that package to the same commit version. Only include the `overrides` entry if your project already pins `vite` there.
131
-
132
-
For pnpm workspaces, make the same override change in `pnpm-workspace.yaml` if that is where your Vite+ overrides live:
After installing a preview, check the bundled versions with `vp --version`. If the preview includes a newer bundled Vitest, update your `vitest` override to that exact version so `vp test` and project imports keep using the same Vitest copy.
156
-
157
-
When testing is complete, restore every preview spec first: set `vite-plus` back to `latest`, set any direct `vite` / `@voidzero-dev/vite-plus-core` dependency plus any `vite` override or resolution back to `npm:@voidzero-dev/vite-plus-core@latest`, and remove the bridge `registry` line from `.npmrc` (or `.yarnrc.yml`). Then reinstall:
158
-
159
-
```bash
160
-
vp install
161
-
```
101
+
After installing, check the bundled versions with `vp --version`. When testing is complete, restore the published release: set `vite-plus` back to `latest`, remove the bridge `registry` line from `.npmrc` (or `.yarnrc.yml`), and reinstall with `vp install`.
0 commit comments