release: v0.2.2 Vite+ Beta by voidzero-guard[bot] · Pull Request #2016 · voidzero-dev/vite-plus · GitHub

Release vite-plus v0.2.2: the Vite+ Beta release.

Vite+ is now in Beta: stable and ready for production adoption, fully open source under MIT. Read the announcement to see what Vite+ is about and where it is headed: Announcing Vite+ Beta.

On top of the Beta milestone, this release brings cross-version upgrades via vp migrate, an official Docker toolchain image on GHCR, zero-config runner-aware vp build caching, and PGP-verified managed Node.js downloads.

Highlights

vp migrate upgrades existing Vite+ projects across versions: previous release notes told users not to run vp migrate for upgrades. It now runs from the global CLI when the local one is older, re-pins vite-plus and the vite -> @voidzero-dev/vite-plus-core alias across dependencies, overrides/resolutions, and catalogs in every workspace package, aligns vitest / @vitest/* by actual usage, and defaults to a version-only upgrade (pass --full to also run the first-time setup bucket: hooks, editor, agent files, lint migration) (#1891), by @fengmk2
Official Vite+ Docker toolchain image: ghcr.io/voidzero-dev/vite-plus bundles vp plus a native build toolchain on debian:bookworm-slim (amd64/arm64, non-root). Since vp provisions the exact Node.js from .node-version, one image builds any project, and a documented multi-stage build copies the resolved Node.js into a small vp-free runtime stage (#1944), by @fengmk2
Zero-config vp build caching via runner-aware Vite: Vite reports its inputs, outputs, and tracked env reads to the vp runner over the new @voidzero-dev/vite-task-client IPC (vite#22453), so vp build caches correctly with no hand-written cache config: outputs are tracked and restored automatically, and a changed VITE_* env var invalidates the cache and is named in the cache-miss message (#1774), by @wan9chi
PGP-verified Node.js downloads: installing a managed Node.js now verifies the release's clearsigned SHASUMS256.txt.asc against the vendored Node.js release keyring (pure Rust, no gpg required) before trusting any checksum, so a tampered archive is rejected before install; unsigned sources (musl builds, custom mirrors) fall back to checksum-only verification (#1848), by @fengmk2

Features

vp check: a check block in vite.config.ts (check.fmt / check.lint) can make plain vp check skip formatting or linting by default, mirroring --no-fmt / --no-lint; standalone vp fmt / vp lint and git hooks are unaffected, and a note: line keeps the config-based skip discoverable (#1981), by @fengmk2
vp env list-remote: highlight installed versions (color, or a * prefix when piped) and label the project-resolved current and global default versions; --json gains installed / current / default fields (#1907), by @semimikoh
vpr ships as a vite-plus package bin, so the vp run shorthand works on clean installs without global PATH shims (Vercel build image, generic CI runners) (#1988), by @kvnwolf
Vite Task: dependsOn can select tasks from dependency packages, e.g. dependsOn: [{ "task": "build", "from": "dependencies" }] (vite-task#479), by @wan9chi
Vite Task: a task's env / untrackedEnv glob patterns support ! negation (e.g. ["VITE_*", "!VITE_SECRET"]) (vite-task#425), and an env-caused cache miss now names the variable inline, e.g. cache miss: env 'NODE_ENV' changed (vite-task#438), by @wan9chi
Upgrade upstream dependencies: vite 8.0.16 -> 8.1.2, rolldown 1.1.1 -> 1.1.4, oxlint 1.70.0 -> 1.72.0, oxfmt 0.55.0 -> 0.57.0, oxlint-tsgolint 0.23.0 -> 0.24.0, and the oxc toolchain 0.136.0 -> 0.138.0 (#1924, #1989, #2000, #2009), by @voidzero-guard[bot]

Fixes & Enhancements

Windows: vp run no longer hangs CI when a node_modules/.bin .cmd shim is routed through PowerShell; the npm/pnpm/yarn .ps1 wrappers read stdin and block forever on a non-TTY pipe, so the PowerShell rewrite is now skipped when stdin is not an interactive terminal (vite-task#491, via #1973), by @fengmk2
Vite Task: the task cache is stored in a per-schema-version directory (e.g. node_modules/.vite/task-cache/v13/), so switching between branches that pin different Vite+ versions no longer fails with Unrecognized database version (vite-task#433), by @fengmk2
Vite Task: env values in cache fingerprints are stored only as SHA-256 digests and env cache-miss details report names without values (vite-task#455); prefix env assignments like PATH=... command now affect executable lookup during planning (vite-task#440); package.json / pnpm-workspace.yaml files with a UTF-8 BOM parse correctly (vite-task#424), by @wan9chi
vp upgrade: run the pinned pnpm with a managed Node.js LTS directly instead of re-entering vp install, so an incompatible session/project/system runtime can no longer make pnpm skip optional native binaries and leave the upgraded CLI broken (#1900), by @liangmiQwQ
Global package installs: each install writes to an immutable packages/<name>#<uuid> prefix that is activated via metadata after npm succeeds, so an interrupted reinstall can no longer leave the active package unavailable (#1906), and stale interrupted-install directories are swept with file-lock protection for concurrent installs (#1945), by @liangmiQwQ
lazyPlugins(): skip plugin factories only while config metadata is being resolved instead of keying off VP_COMMAND, so builds spawned under vp run / vp exec keep the user's plugins and vp format no longer loads them (#1939), by @fengmk2
vp migrate (pnpm): add a direct vite devDep aliased to the core override wherever vite-plus is depended on, so vitest's vite peer binds to @voidzero-dev/vite-plus-core instead of pulling in a second upstream vite that broke the vp test cache (#1933), by @fengmk2
vp pack: bundle @tsdown/exe and @tsdown/css into core so --exe and CSS bundling work without a resolvable top-level tsdown; the native lightningcss becomes an optional peer loaded lazily with an actionable error (#1919), by @fengmk2
vp env: invalidate stale shim resolve cache entries when the project's Node.js version source changes (#1951), by @jong-kyung
Node shim: when the project declares npm via packageManager / devEngines.packageManager, child processes spawned from node resolve the managed npm instead of the Node-bundled one (#1938); vp env which reports bins linked by an intercepted npm install -g (e.g. tsc) instead of "not found" (#1968); bins with uppercase names (e.g. vitePlus) dispatch correctly (#1963), by @liangmiQwQ
vp-setup: pass the configured npm registry to the inner pnpm install so setup works behind custom registries (#1795), by @daflyinbed
Native binding: declare the platform packages' true ABI floor engines.node >=20.0.0 so engine-strict package managers (pnpm) no longer skip the optional native dependency and fail with Cannot find native binding when a consumer's Node floor lands in a product-policy gap (#1993), by @fengmk2
vp create: run git init without creating an initial commit, so commitlint-configured templates no longer reject the hardcoded message and template placeholders are not baked into history (#2008), by @forehalo
vp staged --debug: inline the bundled lint-staged version so debug logging no longer crashes reading a package.json that does not exist in the bundle (#1925), by @rokuosan
Installer: retry downloads truncated mid-body in HttpClient::get_bytes (the platform-tarball path for vp upgrade and the standalone installer) (#1940), and clean up the temp dir when a package-manager install fails instead of leaking .tmpXXXX directories (#1949), by @shulaoda
Windows/msys: normalize backslashes in the env.fish fallback path (#1954), by @Aalivexy
install.ps1: detect the missing VC++ runtime (0xC0000135) and print VC++ Redistributable guidance instead of a generic failure; interactive irm | iex installs keep the shell open (#1962), by @cheezone
vp migrate: preserve comments, key order, and trailing commas in existing .vscode / .zed JSONC configs by patching the original text instead of re-serializing it (#1956), by @fengmk2
Migration: link the git hook warning to the migration guide (#1902), by @naokihaba
vp info / vp view: use package-manager-native commands (pnpm view, bun info, yarn npm info) instead of routing every lookup through npm view (#1895), by @jong-kyung
Correct overused ErrorConfig error types across the codebase (#1934), by @liangmiQwQ

Refactor

vite_install: centralize Yarn v1/berry branching with is_yarn_berry (#1897), by @jong-kyung

Docs

Document Vite Task automatic tracking (fs tracking and cache-reporting tools), reusing the task cache with GitHub Actions cache, and dependsOn: [{ task, from: "dependencies" }] (#1992), by @wan9chi
Rewrite the "Upgrading Vite+" guide: preview builds install through the registry bridge as ordinary 0.0.0-commit.<sha> npm versions, and vp migrate is the recommended way to upgrade a project or move it onto a preview build (#1965), by @fengmk2
Describe how to switch back to the release version from nightly (#1887), by @situ2001
Clarify Git hook tool migration (#1901), by @naokihaba
Add a global installation explanation (#1915), update the vp env help output (#1969), and add liangmiQwQ as a team member (#1911), by @liangmiQwQ
Fix package manager command examples (#1937) and the dependsOn guide link (#1883), by @jong-kyung
Remove Fathom analytics from the uninstall docs (#1946), by @mdong1909
Center the README logo and fix its size (#1878), by @hyf0

Chore

Prevent Vite beta upgrades in the upstream-deps script (#1879), stabilize flaky network-dependent tests (#1923), and bump the ecosystem-ci bun-vite-template to the oxlint jsx-a11y fix (#1898), by @fengmk2
Pin snap-test install fixtures to a published vite-plus version so release-branch CI can pass before the new version is published (#2017), by @fengmk2
Update the deprecated VITE_PLUS_ env var prefixes to VP_ in the RFCs (#1984), by @liangmiQwQ
CI: skip full CI for docs-only PRs (#1991) and for the docs deploy config (#2015), by @wan9chi
Update GitHub Actions (#1904, #1977), claude-code-action to v1.0.158 (#1979), and pnpm to v10.34.4 (#1996), by @renovate[bot]
Update oxc-project/security-action to v1.0.8 (#1918), by @fengmk2
Refresh trusted stack stats on the docs homepage (#1913, #1982), by @voidzero-guard[bot]

Bundled Versions

Tool	Version	Source
vite	8.1.2	ba31193
rolldown	1.1.4	6cbd233
tsdown	0.22.3	npm
vitest	4.1.9	npm
oxlint	1.72.0	npm
oxlint-tsgolint	0.24.0	npm
oxfmt	0.57.0	npm

Upgrade

vp upgrade

New to Vite+? Start with the Beta announcement, then create a project with vp create or bring an existing one over with vp migrate.

New Contributors

Welcome to our new contributors @rokuosan, @Aalivexy, @cheezone, @daflyinbed, @forehalo, @kvnwolf! 🎉

Full Changelog: v0.2.1...v0.2.2

Merging this PR will trigger the release workflow.

✅ Deploy Preview for viteplus-preview ready!

Name	Link
🔨 Latest commit	61d37e5
🔍 Latest deploy log	https://app.netlify.com/projects/viteplus-preview/deploys/6a462af1bcd9ce0008c07da5
😎 Deploy Preview	https://deploy-preview-2016--viteplus-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

NAPI bakes the package.json version into binding/index.cjs version checks. The prepare_release workflow bumps package.json but does not regenerate this file, so the CI build's regeneration step produces a diff that the post-build no-unexpected-changes guard rejects.

Discord announcement draft (concise), copy-paste after the release is published:

**Vite+ Beta is out (vite-plus v0.2.2)** :tada:

Stable, production-ready, MIT. Read the announcement: https://voidzero.dev/posts/announcing-vite-plus-beta

**Highlights**
:seedling: `vp migrate` now upgrades existing Vite+ projects across versions
:hammer_and_wrench: Official Docker image: `ghcr.io/voidzero-dev/vite-plus`
:zap: Zero-config `vp build` caching (auto outputs + tracked envs)
:lock: PGP-verified Node.js downloads

**Also in this release**
- `check.fmt` / `check.lint` config for `vp check`
- `vpr` ships as a package bin (works on Vercel/CI)
- Windows: `vp run` no longer hangs on PowerShell `.cmd` shims
- Task cache survives switching branches across Vite+ versions
- `dependsOn: [{ task, from: "dependencies" }]`

**Bundled versions**
vite `8.1.2`, rolldown `1.1.4`, tsdown `0.22.3`, vitest `4.1.9`, oxlint `1.72.0`, oxlint-tsgolint `0.24.0`, oxfmt `0.57.0`

**Upgrade**: `vp upgrade`

Full notes: <https://github.com/voidzero-dev/vite-plus/releases/tag/v0.2.2>
Thanks to new contributors @rokuosan, @Aalivexy, @cheezone, @daflyinbed, @forehalo, @kvnwolf :wave:

Open in StackBlitz

vite-plus

npm i https://pkg.pr.new/voidzero-dev/vite-plus@2016

@voidzero-dev/vite-plus-core

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-core@2016

@voidzero-dev/vite-plus-prompts

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-prompts@2016

@voidzero-dev/vite-plus-cli-darwin-arm64

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-darwin-arm64@2016

@voidzero-dev/vite-plus-cli-darwin-x64

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-darwin-x64@2016

@voidzero-dev/vite-plus-cli-linux-arm64-gnu

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-linux-arm64-gnu@2016

@voidzero-dev/vite-plus-cli-linux-arm64-musl

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-linux-arm64-musl@2016

@voidzero-dev/vite-plus-cli-linux-x64-gnu

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-linux-x64-gnu@2016

@voidzero-dev/vite-plus-cli-linux-x64-musl

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-linux-x64-musl@2016

@voidzero-dev/vite-plus-cli-win32-arm64-msvc

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-win32-arm64-msvc@2016

@voidzero-dev/vite-plus-cli-win32-x64-msvc

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-cli-win32-x64-msvc@2016

@voidzero-dev/vite-plus-darwin-arm64

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-darwin-arm64@2016

@voidzero-dev/vite-plus-darwin-x64

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-darwin-x64@2016

@voidzero-dev/vite-plus-linux-arm64-gnu

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-linux-arm64-gnu@2016

@voidzero-dev/vite-plus-linux-arm64-musl

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-linux-arm64-musl@2016

@voidzero-dev/vite-plus-linux-x64-gnu

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-linux-x64-gnu@2016

@voidzero-dev/vite-plus-linux-x64-musl

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-linux-x64-musl@2016

@voidzero-dev/vite-plus-win32-arm64-msvc

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-win32-arm64-msvc@2016

@voidzero-dev/vite-plus-win32-x64-msvc

npm i https://pkg.pr.new/voidzero-dev/vite-plus/@voidzero-dev/vite-plus-win32-x64-msvc@2016

commit: 1d7ba81

Registry bridge build (1d7ba81)

This commit is published to pkg.pr.new and registered with the registry bridge, which serves these as ordinary npm versions (every other package proxies to npmjs):

Package	Version
vite-plus	0.0.0-commit.1d7ba811f0e456640b0e761e8e8acf77d1ad3251
@voidzero-dev/vite-plus-core	0.0.0-commit.1d7ba811f0e456640b0e761e8e8acf77d1ad3251

Install the Vite+ CLI built from this commit, then migrate a project:

# macOS / Linux
curl -fsSL https://vite.plus | VP_PR_VERSION=2016 bash

# Windows (PowerShell)
$env:VP_PR_VERSION="2016"; irm https://vite.plus/ps1 | iex

After installing, upgrade the current project's vite-plus to this test build with:

vp migrate

Or point your package manager at the bridge registry https://registry-bridge.viteplus.dev/:

Package manager	Registry config
npm / pnpm / Bun	.npmrc: registry=https://registry-bridge.viteplus.dev/
Yarn (v2+)	.yarnrc.yml: npmRegistryServer: "https://registry-bridge.viteplus.dev/"

Then pin the build (vite aliases to vite-plus-core; pnpm can use a catalog, npm an overrides entry):

{
  "devDependencies": {
    "vite-plus": "0.0.0-commit.1d7ba811f0e456640b0e761e8e8acf77d1ad3251",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.1d7ba811f0e456640b0e761e8e8acf77d1ad3251"
  }
}

🐳 Docker preview image

Built from this PR's pkg.pr.new build:

Image	Compressed size
ghcr.io/voidzero-dev/vite-plus:pr-2016	240MB

# remove any stale local copy from a previous run, then pull fresh
docker rmi ghcr.io/voidzero-dev/vite-plus:pr-2016 2>/dev/null; docker pull ghcr.io/voidzero-dev/vite-plus:pr-2016

Quick check:

docker run --rm ghcr.io/voidzero-dev/vite-plus:pr-2016 vp --version

See docs/guide/docker.md for usage.

Documents the v0.2.2 (PR #2016) smoke test run: choosing a target project pinned to the previous release for a real upgrade path, passing the full build commit SHA when the PR head has moved, the shape of a passing run, and the single-version pass criteria with the release-blocker rule on failure.

BETA!

release: v0.2.2

144d26a

voidzero-guard Bot assigned fengmk2 Jul 2, 2026

fengmk2 changed the title release: v0.2.2 release: v0.2.2: Vite+ Beta Jul 2, 2026

fengmk2 added the preview-build Publish this PR's commits to the registry bridge as preview builds label Jul 2, 2026

Merge remote-tracking branch 'origin/main' into release/v0.2.2

1d7ba81

fengmk2 changed the title release: v0.2.2: Vite+ Beta release: v0.2.2 Vite+ Beta Jul 2, 2026

fengmk2 added 2 commits July 2, 2026 17:06

Merge branch 'main' into release/v0.2.2

9d225ab

Merge branch 'main' into release/v0.2.2

61d37e5

fengmk2 approved these changes Jul 2, 2026

View reviewed changes

fengmk2 merged commit 4f7fd0b into main Jul 2, 2026
118 of 120 checks passed

fengmk2 deleted the release/v0.2.2 branch July 2, 2026 09:28

fengmk2 mentioned this pull request Jul 2, 2026

vp migrate hangs indefinitely (0% CPU) when the project's pinned pnpm deadlocks during install #2020

Open

release: v0.2.2 Vite+ Beta by voidzero-guard[bot] · Pull Request #2016 · voidzero-dev/vite-plus · GitHub

Uh oh!

release: v0.2.2 Vite+ Beta - #2016

release: v0.2.2 Vite+ Beta#2016
fengmk2 merged 5 commits into
mainfrom
release/v0.2.2

voidzero-guard Bot commented Jul 2, 2026 •
edited by fengmk2
Loading

Uh oh!

Uh oh!

netlify Bot commented Jul 2, 2026 •
edited
Loading

Uh oh!

Uh oh!

fengmk2 commented Jul 2, 2026 •
edited
Loading

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jul 2, 2026 •
edited
Loading

Uh oh!

Uh oh!

github-actions Bot commented Jul 2, 2026 •
edited
Loading

Uh oh!

Uh oh!

github-actions Bot commented Jul 2, 2026

Uh oh!

fengmk2 left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

release: v0.2.2 Vite+ Beta by voidzero-guard[bot] · Pull Request #2016 · voidzero-dev/vite-plus · GitHub

Uh oh!

release: v0.2.2 Vite+ Beta - #2016

release: v0.2.2 Vite+ Beta#2016fengmk2 merged 5 commits intomainvoidzero-dev/vite-plus:mainfrom release/v0.2.2voidzero-dev/vite-plus:release/v0.2.2Copy head branch name to clipboard

Conversation

voidzero-guard Bot commented Jul 2, 2026 • edited by fengmk2 Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Highlights

Features

Fixes & Enhancements

Refactor

Docs

Chore

Bundled Versions

Upgrade

New Contributors

Uh oh!

netlify Bot commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for viteplus-preview ready!

Uh oh!

fengmk2 commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new Bot commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Registry bridge build (1d7ba81)

Uh oh!

github-actions Bot commented Jul 2, 2026

🐳 Docker preview image

Uh oh!

fengmk2 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

release: v0.2.2 Vite+ Beta#2016
fengmk2 merged 5 commits into
mainfrom
release/v0.2.2

voidzero-guard Bot commented Jul 2, 2026 •
edited by fengmk2
Loading

netlify Bot commented Jul 2, 2026 •
edited
Loading

fengmk2 commented Jul 2, 2026 •
edited
Loading

pkg-pr-new Bot commented Jul 2, 2026 •
edited
Loading

github-actions Bot commented Jul 2, 2026 •
edited
Loading