voidzero-dev/vite-plus v0.3.1

vite-plus v0.3.1: manage package-manager versions with vp env

on GitHub

vp env now manages Node.js and package-manager versions together. This release also fixes TanStack Start routing and stale Vitest aliases.

Breaking Changes

Package-manager setup

Vite+ replaces Corepack with managed npm, pnpm, yarn, and bun commands. It removes the corepack shim and legacy global package-manager installations (#2391), by @liangmiQwQ.

Replace Corepack setup commands in shell profiles, CI jobs, and Dockerfiles:

Use vp env pin <manager>@<version> to set a project version.

vp env command scope and JSON output

Unscoped vp env commands now operate on Node.js and package managers. Package managers support independent defaults, project pins, session overrides, and installation commands (#2398), by @liangmiQwQ.

Add node to limit an operation to Node.js, for example, vp env off node or vp env unpin node. Bare versions, such as vp env default 22.19.0, still select Node.js.

Update scripts that read JSON output:

See the environment guide.

vp pack migration to tsdown@0.23

vp pack now uses tsdown@0.23, which removes deprecated options and changes defaults (#2614), by @fengmk2.

1. Run vp migrate to update supported static configurations and package scripts, including projects that already use Vite+.
2. Check migration warnings in vite.config.*, tsdown.config.*, and package.json.
3. Update dynamic configurations manually. Arrays built with .map() require manual changes, even when migration reports no warning.
4. Run vp pack to check the result.

Migration preserves the previous defaults for dependency resolution and ATTW.

tsdown no longer supports Node.js 25. Use Node.js ^22.18.0, ^24.11.0, or >=26.0.0. The programmatic build() API now returns { bundles, watch }.

See the complete migration guide for declaration and TypeScript module-resolution changes.

CLI argument validation

vp staged, vp config, vp hooks, vp migrate, and vp create now reject unsupported options and extra positional arguments (#2523), by @fengmk2.

Remove unsupported arguments from scripts. For example, replace vp config --hooks-only with vp config --no-agent.

Highlights

• Fix TanStack Start HTTP 404 responses caused by separate Vite runtime copies (#2617), by @fengmk2.
• Reduce the Windows vp-shim.exe size from 214 KiB to 14 KiB (#2466), by @fengmk2.
• Add vp check --quiet to hide lint warning diagnostics while retaining errors and summary counts (#2593), by @RSS1102.

Features

• Add vp sync-versions --json so automation can request dependency alignment plans from manifest snapshots without changing project files (#2600), by @afonsojramos.
• Make vp create --git suggest an initial commit command after Git initialization (#2581), by @fengmk2.
• Make vp migrate replace frozen voidzero-dev/setup-vp@v1 workflow references with the supported version pin (#2540), by @fengmk2.
• Upgrade rolldown from 1.2.5 to 1.2.7, tsdown from 0.22.14 to 0.23.0, and Oxc from 0.146.0 to 0.148.0. Upgrade oxlint from 1.79.0 to 1.81.0 and oxfmt from 0.64.0 to 0.66.0. These versions can flag code that passed before. Run vp fmt after upgrading if CI runs vp check (#2580, #2613), by @voidzero-guard[bot].

Fixes & Enhancements

• Resolve package-manager versions without rewriting package.json. Use vp env pin or vp env unpin to change project declarations explicitly (#2399), by @liangmiQwQ.
• Let vp migrate repair stale vitest aliases that previously prevented the CLI from starting (#2605), by @fengmk2.
• Keep Vite DevTools within the version ranges supported by the bundled Vite (#2559), by @fengmk2.
• Keep automatic Vitest upgrades on the supported 4.x major (#2612), by @fengmk2.
• Remove a deprecated tsdown option from the prompts package build (#2597), by @jong-kyung.

Refactor

• Use the updated which dependency to resolve relative PATH entries (#2583), by @RSS1102.
• Remove the unused async-trait annotation from JsRuntimeProvider (#2538), by @jong-kyung.

Docs

• Add Azure Pipelines setup instructions (#2553), by @naokihaba.
• Correct Zed Oxc formatter settings and include JSX and TSX (#2592), by @joschuba.
• Add Wrangler deployment configuration for the documentation site (#2596), by @mdong1909.
• Explain conflicts between pnpm and Vite+ runtime management, including the runtimeOnFail setting (#2620), by @liangmiQwQ.

Chore

• Run CLI snapshots without published release packages (#2625), by @fengmk2.
• Update the release-manager skill with package-install checks, changelog guidance, and announcement handling (#2548), by @fengmk2.
• Wait for npm dependencies to become available before publishing dependent release packages (#2601), by @fengmk2.
• Remove old Docker preview images (#2539), by @fengmk2.
• Stabilize external-tool snapshots and isolate npm network cases (#2577, #2604), by @fengmk2.
• Avoid unreliable Fish PPA setup in CI (#2560), by @fengmk2.
• Update the vinext fixture to an upstream fix (#2571), by @jong-kyung.
• Stabilize the pnpm snapshot and Nuxt build in CI (#2591), by @voidzero-guard[bot].
• Pin pnpm in project-creation build-approval fixtures (#2616), by @liangmiQwQ.
• Remove unused documentation components, assets, and the typewriter dependency (#2550, #2562), by @jong-kyung.
• Remove duplicate tempfile dependencies, an unused runtime helper, and unused error variants. Update the unit_bindings lint name (#2555, #2558, #2566, #2567), by @jong-kyung.
• Update GitHub Actions dependencies, including actions/setup-node v7 (#2544, #2545, #2582, #2618), by @renovate[bot].
• Update crate-ci/typos through v1.50.1 (#2584, #2589, #2609), by @renovate[bot].
• Update repository pnpm to 11.24.0 (#2590), by @renovate[bot].
• Update voidzero-dev/setup-vp to v1.19.0 (#2619), by @renovate[bot].

Bundled Versions

Upgrade

vp upgrade

New Contributors

@afonsojramos, @joschuba

Full Changelog: v0.3.0...v0.3.1

Published Packages

• @voidzero-dev/vite-plus-core@0.3.1
• vite-plus@0.3.1

Installation

macOS/Linux:

curl -fsSL https://vite.plus | bash

Windows:

irm https://vite.plus/ps1 | iex

Or download and run vp-setup.exe from the assets below.

Docker:

docker run --rm -it -v "$PWD:/app" -w /app ghcr.io/voidzero-dev/vite-plus:0.3.1 vp build

Run any vp command without installing it; see the Docker guide for more.