Skip to content

Commit a3e3079

Browse files
committed
docs(migrate): note the Rolldown-compat check and trim a duplicated rule
Document that migration warns about Rolldown-incompatible Vite config patterns (e.g. manualChunks) without changing them. Replace the pnpm section's restated "every vite-plus package needs a direct vite" rule with a cross-reference to the "Vite and Overrides" section. Clarify that vp upgrade updates the global CLI, which migration delegates to when a project's local vite-plus is older. Claude-Session: https://claude.ai/code/session_01DQhS6o1fyQd1yjiee6W8jR
1 parent fcd4a97 commit a3e3079

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

docs/guide/migrate-rules.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ package-manager configuration in existing Vite+ projects. See the
66

77
## Before You Migrate
88

9-
1. Run `vp upgrade` before migrating an existing Vite+ project. A stale local
10-
CLI does not contain the new migration rules; migration delegates to the
11-
global CLI when the local version is older.
9+
1. Run `vp upgrade` so the global CLI has the latest migration rules. When a
10+
project's local `vite-plus` is older, migration delegates to the global CLI,
11+
so a stale local copy is not a blocker.
1212
2. Upgrade the project to Vite 8+ and Vitest 4.1+ when necessary.
1313
3. Run `vp migrate` from the workspace root. Use `--no-interactive` in
1414
automated environments.
@@ -237,9 +237,8 @@ format Vite+ reads:
237237
migration reuses that managed toolchain catalog for newly added dependencies
238238
and overrides. It creates a top-level default catalog only when no managed or
239239
default catalog can be reused.
240-
- Each package that lists `vite-plus` in `dependencies` or `devDependencies`
241-
gets a direct `vite` dev dependency unless it already declares `vite` in a
242-
dependency field.
240+
- Each package that declares `vite-plus` also gets a direct `vite` dev
241+
dependency (see [Vite and Overrides](#vite-and-overrides)).
243242
- Unrelated selector-shaped and object-valued overrides are preserved.
244243

245244
### npm
@@ -272,6 +271,9 @@ format Vite+ reads:
272271
- Mirror the core alias as a direct `vite` dependency so Bun sees the peer
273272
provider before applying overrides.
274273

274+
Migration inspects each Vite config for Rolldown-incompatible patterns (such as
275+
`manualChunks`) and reports any it finds as warnings, without changing the config.
276+
275277
After updating the manifests and package-manager configuration, migration
276278
reinstalls dependencies once to refresh the lockfile. If installation fails,
277279
migration reports the error and exits with a nonzero status. After a successful

0 commit comments

Comments
 (0)