vp

vp [-C dir] [-V] [command] [options]

vp is the CLI for Vite+, VoidZero's unified toolchain for local web development. One command covers Node.js and package-manager versions, dependency install, the Vite dev server, Oxc lint/format, Vitest, production builds (Vite and Rolldown), library packing (tsdown), and cached monorepo tasks (Vite Task).There are two distributions. The global CLI is a standalone vp binary: it does not need Node.js already installed, manages runtimes and package managers, and can run the toolchain without adding `vite-plus` to a project. The project-local `vite-plus` npm package records the toolchain in the project's lockfile. For dev, build, test, check, and run, the global CLI uses the project's installed `vite-plus` when present, otherwise the globally bundled toolchain. env, upgrade, and implode always belong to the global CLI.With no command, vp opens an interactive picker. Built-in commands such as dev, test, and build cannot be replaced by `package.json` scripts; run those scripts with vp run (or vpr).Install the global CLI on Linux and macOS with `curl -fsSL https://vite.plus | bash`, then open a new shell and run vp help. Prebuilt binaries cover Linux x64/arm64 glibc and macOS; Linux musl is experimental. On Alpine, install `libstdc++` before using managed Node.js.

-C dir

Run as if started in dir instead of the current working directory.

Print the CLI version.

Scaffold a new app, library, or monorepo from a template.

Move an existing project onto Vite+. Prints a plan before rewriting files.

Install all dependencies, or add packages when names are given. Detects npm, pnpm, Yarn, or Bun from `packageManager`, lockfiles, and related config.

Add packages to dependencies.

Remove packages from dependencies.

Update packages to their latest versions.

Start the Vite development server with HMR. Powered by Vite and Rolldown.

Run format, lint, and type checks together (Oxfmt and Oxlint).

Lint code with Oxlint.

Format code with Oxfmt.

Run tests with Vitest.

Build the application for production.

Serve the production build locally.

Build a library for publishing, or a standalone executable.

Run `package.json` scripts and monorepo tasks with caching. Also available as the standalone vpr binary.

Run a binary from the project's `node_modules/.bin`.

Download and run a package binary without adding it as a dependency. Also available as vpx.

Run a Node.js script with the resolved Vite+ environment. Use vpx file for TypeScript.

Manage Node.js and package-manager versions. Global CLI only. See vp-env(1).

Show the versions of Vite+, Vite, Rolldown, Oxc, Vitest, and related tools. Uses the project's `vite-plus` package when present; --global inspects the machine install.

Configure Git hooks and agent integration.

Manage the Git hook dispatcher.

Run checks on Git staged files.

Manage the task cache.

Update the global vp binary. Homebrew installs must be upgraded with Homebrew instead.

Remove the global vp installation and Vite+-managed runtimes, packages, config, and caches.

vite.config.ts

Project config via `defineConfig` from `vite-plus`. Holds Vite (`plugins`, `build`), Vitest (`test`), Oxlint (`lint`), Oxfmt (`fmt`), Vite Task (`run`), and staged-file (`staged`) options in one file.

`packageManager` and `devEngines.packageManager` select the package manager. `devEngines.runtime` and `engines.node` contribute to Node.js version resolution. See vp-env(1).

Project Node.js version files read by vp env.

Optional single-root install directory. When unset, a fresh install uses split XDG paths (`~/.local/share/vite-plus`, `~/.cache/vite-plus`, `~/.config/vite-plus`, `~/.local/state/vite-plus` on Linux and macOS). An existing `~/.vite-plus` install is reused.

env, upgrade, and implode are not in the project-local `vite-plus` package.implode deletes managed Node.js runtimes, global packages, configuration, and caches.Homebrew owns its vp binary: vp upgrade refuses to replace it and points at `brew upgrade vite-plus`.Built-in commands ignore same-named `package.json` scripts. Use vp run script.On Alpine (musl), managed Node.js needs `libstdc++`. A missing prebuilt binary for the current OS/CPU fails the installer.

Vite+ is developed by VoidZero, the company founded by Evan You (creator of Vite and Vue). The public beta shipped on 2 July 2026. Vite+ 1.0 was released on 28 September 2026 (MIT licensed), bundling Vite 8, Vitest, Rolldown, Oxlint, Oxfmt, and tsdown behind vp. VoidZero later joined Cloudflare.

vp-env(1), vite(1), vitest(1), npm(1), pnpm(1), node(1), nvm(1), uv(1)

Source code · Homepage · Documentation