Skip to content

Commit 964e758

Browse files
Han5991claude
andcommitted
docs: add rebuild section to install guide
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 94bbaa6 commit 964e758

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

docs/guide/install.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,7 @@ Vite+ provides all the familiar package management commands:
6060
- `vp list` shows installed packages
6161
- `vp why <pkg>` explains why a package is present
6262
- `vp info <pkg>` shows registry metadata for a package
63+
- `vp rebuild` rebuilds native modules (e.g. after switching Node.js versions)
6364
- `vp link` and `vp unlink` manage local package links
6465
- `vp dlx <pkg>` runs a package binary without adding it to the project
6566
- `vp pm <command>` forwards a raw package-manager-specific command when you need behavior outside the normalized `vp` command set
@@ -115,6 +116,20 @@ Use these when you need to understand the current state of dependencies.
115116
- `vp why react` explains why `react` is installed
116117
- `vp info react` shows registry metadata such as versions and dist-tags
117118

119+
#### Rebuild
120+
121+
Use `vp rebuild` when native modules need to be recompiled, for example after switching Node.js versions or when a C/C++ addon fails to load.
122+
123+
- `vp rebuild` rebuilds all native modules
124+
- `vp rebuild -- <args>` passes extra arguments to the underlying package manager
125+
126+
```bash
127+
vp rebuild
128+
vp rebuild -- --update-binary
129+
```
130+
131+
`vp rebuild` is a shorthand for `vp pm rebuild`.
132+
118133
#### Advanced
119134

120135
Use these when you need lower-level package-manager behavior.

0 commit comments

Comments
 (0)