docs: add installer environment variables documentation by yukinoshi · Pull Request #2114 · voidzero-dev/vite-plus

yukinoshi · 2026-07-09T14:39:42Z

Create docs/guide/installer-env-vars.md documenting env vars used by installers (vp-setup.exe, install.ps1, install.sh)
Add links from Getting Started, Environment, Install, Docker, and Upgrade
Cover install vars (VP_VERSION, VP_HOME, NPM_CONFIG_REGISTRY, VP_NODE_MANAGER, VP_PR_VERSION, etc.)
Cover runtime vars (VP_HOME, VP_NODE_DIST_MIRROR, VP_NODE_VERSION, VP_DEBUG_SHIM, etc.)
Cover TLS/CA config (SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, VP_INSECURE_TLS)
Cover logging/debug vars (VITE_LOG, VITE_UPDATE_TASK_TYPES, etc.)
Document standard vars (CI, NO_COLOR, HOME) and precedence rules

Closes#1957

- Create docs/guide/installer-env-vars.md documenting env vars used by installers (vp-setup.exe, install.ps1, install.sh) - Add links from Getting Started, Environment, Install, Docker, and Upgrade - Cover install vars (VP_VERSION, VP_HOME, NPM_CONFIG_REGISTRY, VP_NODE_MANAGER, VP_PR_VERSION, etc.) - Cover runtime vars (VP_HOME, VP_NODE_DIST_MIRROR, VP_NODE_VERSION, VP_DEBUG_SHIM, etc.) - Cover TLS/CA config (SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, VP_INSECURE_TLS) - Cover logging/debug vars (VITE_LOG, VITE_UPDATE_TASK_TYPES, etc.) - Document standard vars (CI, NO_COLOR, HOME) and precedence rules Closesvoidzero-dev#1957

netlify · 2026-07-09T14:39:48Z

✅ Deploy Preview for viteplus-preview ready!

Name	Link
🔨 Latest commit	`cfb6250`
🔍 Latest deploy log	https://app.netlify.com/projects/viteplus-preview/deploys/6a50df83e9ebb80008da4687
😎 Deploy Preview	https://deploy-preview-2114--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.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:5719297066

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

yukinoshi · 2026-07-09T15:56:39Z

Got it, thanks for clarifying. I removed those extra hint/tip additions from unrelated pages and kept the changes focused on the new installer environment variables document.

fengmk2

@yukinoshi Thanks

yukinoshi · 2026-07-10T10:10:47Z

Thanks for letting me be a part of it, it was an awesome experience, thank you all

fengmk2 · 2026-07-10T10:16:51Z

@yukinoshi why close it?

fengmk2 · 2026-07-10T10:19:28Z

@yukinoshi can you fix the doc format check erros? Thanks.

yukinoshi · 2026-07-10T10:21:08Z

@yukinoshi why close it?

Clicked it by accident

yukinoshi · 2026-07-10T10:21:23Z

@yukinoshi can you fix the doc format check erros? Thanks.

ok

yukinoshi · 2026-07-10T10:41:36Z

@fengmk2 Done. The formatting issue was caused by my outdated branch and should be fixed now. Could you please check it again? Thanks!

fengmk2 · 2026-07-10T11:44:37Z

@yukinoshi let me fix format issue before I merge.

- Fix trailing whitespace in docker.md (vp fmt --check failure) - Merge the duplicate VP_HOME entries into one - Link the canonical sections for VP_PR_VERSION, VP_NODE_DIST_MIRROR, and VP_NODE_SKIP_SIGNATURE_VERIFY instead of restating them - Drop VITE_UPDATE_TASK_TYPES (test-time codegen switch; the documented vp update command does not exist), VP_TRAMPOLINE_PATH (test-only), VP_ENV_USE_EVAL_ENABLE and VITE_GLOBAL_CLI_JS_SCRIPTS_DIR (internal/dev) - Compress the internal-variable lists and dev-only installer vars to short notes; merge SSL_CERT_FILE / NODE_EXTRA_CA_CERTS - Register the page in the sidebar next to Environment and replace the Getting Started info box with a plain sentence

@liangmiQwQ

) Release vite-plus v0.2.5: Cleaner environments and more reliable workflows. This release adds cleanup and package version commands, supports TypeScript 7 declaration generation, reduces the standalone binary size, and hardens task tracking, CLI output, package-manager routing, Docker workflows, and project scaffolding. ### Highlights - Add `vp env clean` to remove unused managed Node.js runtimes and package-manager caches ([#2003](#2003)), by @liangmiQwQ - Add `vp pm version`, forwarding native version commands to npm, pnpm, Yarn, and Bun ([#2127](#2127)), by @jong-kyung - Add TypeScript 7 support to declaration generation and generated library projects with tsdown `0.22.7` ([#2104](#2104), [#2168](#2168)), by @wan9chi - Improve automatic task input tracking for Bun on macOS, Linux containers with constrained `/dev/shm`, and Windows process images, reduce Windows backing-file allocation, and clarify task wait failures ([vite-task#515](voidzero-dev/vite-task#515), [vite-task#518](voidzero-dev/vite-task#518), [vite-task#523](voidzero-dev/vite-task#523), [vite-task#524](voidzero-dev/vite-task#524), [vite-task#542](voidzero-dev/vite-task#542), [#2126](#2126), [#2167](#2167)), by @wan9chi - Prevent CLI diagnostics from truncating or panicking when inherited standard output or error is nonblocking ([#2172](#2172), [#2173](#2173)), by @wan9chi ### Fixes & Enhancements - Reduce standalone `vp` binary sizes by about 5% on Linux and macOS and 19% on Windows ([#2043](#2043)), by @fengmk2 - Keep the Docker image non-root by default while allowing passwordless `sudo` for Playwright browser dependencies and system packages ([#2088](#2088)), by @fengmk2 - Ignore `.env` and `.env.*` in generated projects while keeping `.env.example` trackable ([#2095](#2095)), by @forehalo - Create `vp-use.cmd` after the Windows environment bin directory is ready and document its Command Prompt-only usage ([#2128](#2128)), by @liangmiQwQ - Render user-facing process statuses and paths without Rust debug wrappers ([#2130](#2130)), by @liangmiQwQ - Make `vp dedupe` fall back to `yarn install` with a warning on Yarn Classic ([#2139](#2139)), by @jong-kyung - Ensure package-manager child processes, including Bun, can always find the managed Node.js runtime ([#2158](#2158)), by @BlankParticle ### Docs - Update the release-manager post-release guidance ([#2096](#2096)), by @wan9chi - Add Windows to the Namespace sponsor credit ([#2108](#2108)), by @fengmk2 - Document installer and runtime environment variables, registry settings, TLS options, and precedence rules ([#2114](#2114)), by @yukinoshi - Mark shell examples in `CONTRIBUTING.md` as Bash code blocks ([#2159](#2159)), by @BlankParticle ### Chore - Assign prepared release PRs to the workflow actor ([#2094](#2094)), by @wan9chi - Complete the PTY snapshot migration and harden the runner, fixtures, release-version redaction, registry teardown, timeouts, and Linux parallelism ([#2071](#2071), [#2080](#2080), [#2084](#2084), [#2099](#2099), [#2102](#2102), [#2103](#2103), [#2107](#2107), [#2109](#2109), [#2115](#2115), [#2117](#2117), [#2118](#2118), [#2119](#2119), [#2120](#2120), [#2121](#2121), [#2131](#2131), [#2132](#2132), [#2134](#2134), [#2137](#2137), [#2138](#2138), [#2141](#2141), [#2143](#2143), [#2145](#2145), [#2182](#2182)), by @fengmk2 and @wan9chi - Expose Vite+ managed binaries consistently inside snapshot fixtures ([#2110](#2110)), by @liangmiQwQ - Exclude PTY snapshot configuration from Vitest discovery and remove the legacy snapshot infrastructure ([#2135](#2135), [#2146](#2146)), by @jong-kyung - Modernize Windows runners, registry bridge publishing, native size reporting, merge-base comparisons, and package-manager installation CI ([#2083](#2083), [#2100](#2100), [#2105](#2105), [#2106](#2106), [#2112](#2112), [#2133](#2133)), by @fengmk2 - Verify that created monorepo libraries emit declarations in CI ([#2171](#2171)), by @wan9chi ### Bundled Versions | Tool | Version | Source | | --------------- | ------- | ----------------------------------------------------------------------- | | vite | `8.1.4` | [`a477454`](vitejs/vite@a477454) | | rolldown | `1.1.5` | [`f09947a`](rolldown/rolldown@f09947a) | | tsdown | `0.22.7` | [npm](https://npmx.dev/package/tsdown/v/0.22.7) | | vitest | `4.1.10` | [npm](https://npmx.dev/package/vitest/v/4.1.10) | | oxlint | `1.73.0` | [npm](https://npmx.dev/package/oxlint/v/1.73.0) | | oxlint-tsgolint | `0.24.0` | [npm](https://npmx.dev/package/oxlint-tsgolint/v/0.24.0) | | oxfmt | `0.58.0` | [npm](https://npmx.dev/package/oxfmt/v/0.58.0) | ### Upgrade ```bash vp upgrade ``` ### New Contributors Welcome @yukinoshi and @BlankParticle. **Full Changelog**: v0.2.4...v0.2.5 --- Merging this PR will trigger the release workflow. --------- Co-authored-by: voidzero-guard[bot] <278573678+voidzero-guard[bot]@users.noreply.github.com> Co-authored-by: wan9chi <dk4rest@gmail.com>

chatgpt-codex-connectorBot reviewed Jul 9, 2026
View reviewed changes

Comment threaddocs/guide/installer-env-vars.md Outdated

fengmk2 reviewed Jul 9, 2026
View reviewed changes

Comment threaddocs/guide/env.md Outdated

fengmk2 reviewed Jul 9, 2026
View reviewed changes

Comment threaddocs/guide/install.md Outdated

yukinoshi mentioned this pull request Jul 9, 2026
Document installer env variables #1957
Closed
4 tasks

clear no need hint and vars to bash, not curl
c7ba39f

yukinoshi requested a review from fengmk2 July 10, 2026 02:48

fengmk2 approved these changes Jul 10, 2026
View reviewed changes

yukinoshi closed this Jul 10, 2026

yukinoshi reopened this Jul 10, 2026

Merge branch 'main' into docs/issue-1957-installer-env-vars
8ec6f14

Merge branch 'main' into docs/issue-1957-installer-env-vars
5acd7e5

fengmk2 merged commit 0a767d6 into voidzero-dev:mainJul 10, 2026
38 of 40 checks passed

wan9chi mentioned this pull request Jul 15, 2026
release: v0.2.5: Cleaner environments and more reliable workflows #2180
Merged

BrewTestBot mentioned this pull request Jul 17, 2026
vite-plus 0.2.5 Homebrew/homebrew-core#293663
Merged
2 tasks

Navigation Menu

Uh oh!

docs: add installer environment variables documentation - #2114

docs: add installer environment variables documentation#2114
fengmk2 merged 5 commits into
voidzero-dev:mainfrom
yukinoshi:docs/issue-1957-installer-env-vars

yukinoshi commented Jul 9, 2026

Uh oh!

netlifyBot commented Jul 9, 2026•
edited
Loading

Uh oh!

chatgpt-codex-connectorBot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

yukinoshi commented Jul 9, 2026

Uh oh!

fengmk2 left a comment

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

fengmk2 commented Jul 10, 2026

Uh oh!

fengmk2 commented Jul 10, 2026

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

fengmk2 commented Jul 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

yukinoshi commented Jul 9, 2026

Uh oh!

netlifyBot commented Jul 9, 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!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

yukinoshi commented Jul 9, 2026

Uh oh!

fengmk2 left a comment

Choose a reason for hiding this comment

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

fengmk2 commented Jul 10, 2026

Uh oh!

fengmk2 commented Jul 10, 2026

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

yukinoshi commented Jul 10, 2026

Uh oh!

fengmk2 commented Jul 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlifyBot commented Jul 9, 2026•
edited
Loading