Skip to content

feat: add official Homebrew tap - #2740

Draft
fengmk2 wants to merge 25 commits into
mainfrom
rfc/official-homebrew-tap
Draft

fengmk2 wants to merge 25 commits into
mainfrom
rfc/official-homebrew-tap

Conversation

@fengmk2

@fengmk2 fengmk2 commented Sep 18, 2026 •

Copy link
Copy Markdown
Member

Add the official Homebrew tap at voidzero-dev/vite-plus/vp. Stable installations download the native CLI from GitHub Releases without Node.js or npm dependencies.

On first use, vp prepares Node.js and uses its bundled npm to download pinned pnpm. Both npm and pnpm use the user's registry and authentication configuration. The CLI stores matching JavaScript dependencies and completion state in user directories.

Homebrew keeps control of the executable. Stable shims survive upgrades, and setup preserves saved preferences and global packages. CLI notices identify the owning formula and distinguish Core from the official tap. Core installations receive migration instructions that preserve user data.

The release workflow proposes formula updates after the archives and matching npm packages are available. Release instructions require maintainers to complete the formula update for each stable version. Stable installation stays disabled until a compatible release is published. Installation checks run for packaging changes or the test: install-e2e label. Preview publication and installation checks can run concurrently.

Set HOMEBREW_VP_PR_VERSION to a PR number or full commit SHA to install a published preview from the registry bridge. The formula resolves the commit and verifies the archive checksum. First use installs matching preview dependencies.

The guides describe the official tap, including installation, preview testing, registry configuration, and removal. The RFC records its design and compatibility requirements. Related to #1171 and #2719.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 18, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://rfc-official-homebrew-tap-viteplus-dev.voidzero-docs.workers.dev (commit ededdac)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://9128d7e3-viteplus-dev.voidzero-docs.workers.dev ededdac 2026-09-24T02:58:12.532Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://4c939953-viteplus-dev.voidzero-docs.workers.dev 90ff9f0 2026-09-24T02:56:43.067Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://961c83c4-viteplus-dev.voidzero-docs.workers.dev fb236d0 2026-09-24T02:51:53.070Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://1553db22-viteplus-dev.voidzero-docs.workers.dev 2308a30 2026-09-23T11:00:38.951Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://e6be568e-viteplus-dev.voidzero-docs.workers.dev 90dcb25 2026-09-23T10:20:51.373Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://5a3a69f0-viteplus-dev.voidzero-docs.workers.dev 1d9c814 2026-09-22T15:07:41.278Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://3f9d121a-viteplus-dev.voidzero-docs.workers.dev 4f5e929 2026-09-22T13:34:32.163Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://fa6c7d50-viteplus-dev.voidzero-docs.workers.dev 036df81 2026-09-22T11:36:00.300Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://e2afa120-viteplus-dev.voidzero-docs.workers.dev 4b2bf0e 2026-09-22T10:59:00.238Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://5c4c0d1c-viteplus-dev.voidzero-docs.workers.dev 1a32f08 2026-09-22T10:39:48.006Z Visit the dashboard ↗

View all previews: View all previews ↗

@fengmk2
fengmk2 force-pushed the rfc/official-homebrew-tap branch from 51663a3 to caa0d3a Compare September 22, 2026 08:56
@fengmk2 fengmk2 changed the title docs: RFC for a Vite+-managed Homebrew tap feat: add official Homebrew tap Sep 22, 2026
@github-actions

github-actions Bot commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

✅ Staging deployment successful!

Preview: https://viteplus-staging.void.app/
Commit: ededdac

@github-actions

github-actions Bot commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor

CLI artifact sizes (ededdac)

Final release artifacts built by the canonical build-upstream and build-windows-cli actions.
The dist rows use the Linux build. The core total excludes .node files to match the release artifact.

Artifact Format Base PR Change
packages/cli/dist Directory total 2.34 MiB 2.34 MiB -3 B (-0.00%)
packages/core/dist Directory total 3.95 MiB 3.95 MiB 0 B (0.00%)
Combined package dist Directory total 6.30 MiB 6.30 MiB -3 B (-0.00%)
vp (Linux x64) Binary 11.29 MiB 11.34 MiB +56.08 KiB (+0.49%)
vp (Linux x64) gzip -9 4.88 MiB 4.91 MiB +24.25 KiB (+0.48%)
NAPI (Linux x64) Binary 32.16 MiB 32.16 MiB 0 B (0.00%)
NAPI (Linux x64) gzip -9 12.74 MiB 12.74 MiB -9 B (-0.00%)
vp (macOS ARM64) Binary 8.41 MiB 8.46 MiB +48.48 KiB (+0.56%)
vp (macOS ARM64) gzip -9 4.26 MiB 4.28 MiB +23.59 KiB (+0.54%)
NAPI (macOS ARM64) Binary 39.75 MiB 39.75 MiB 0 B (0.00%)
NAPI (macOS ARM64) gzip -9 17.05 MiB 17.05 MiB +2 B (+0.00%)
vp (Windows x64) Binary 9.16 MiB 9.21 MiB +49.50 KiB (+0.53%)
vp (Windows x64) gzip -9 4.00 MiB 4.02 MiB +19.50 KiB (+0.48%)
NAPI (Windows x64) Binary 27.11 MiB 27.11 MiB 0 B (0.00%)
NAPI (Windows x64) gzip -9 10.85 MiB 10.85 MiB -15 B (-0.00%)
Trampoline (Windows x64) Binary 13.50 KiB 13.50 KiB 0 B (0.00%)
Trampoline (Windows x64) gzip -9 7.08 KiB 7.09 KiB +4 B (+0.06%)
Installer (Windows x64) Binary 4.56 MiB 4.48 MiB -89.50 KiB (-1.91%)
Installer (Windows x64) gzip -9 2.13 MiB 2.09 MiB -42.31 KiB (-1.94%)

@fengmk2
fengmk2 force-pushed the rfc/official-homebrew-tap branch 2 times, most recently from 1d9c814 to 90dcb25 Compare September 23, 2026 10:19
@fengmk2 fengmk2 added the preview-build Publish this PR's commits to the registry bridge as preview builds label Sep 23, 2026
@github-actions

github-actions Bot commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

Registry bridge build (ededdac)

This commit build is published to the registry bridge, which serves these as ordinary npm versions (every other package proxies to npmjs):

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

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

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/voidzero-dev/vite-plus/ededdac938f1ab252c7df86fb663b9de757af41a/packages/cli/install.sh | VP_PR_VERSION=2740 VP_LEGACY_INSTALLER_URL=https://raw.githubusercontent.com/voidzero-dev/vite-plus/ededdac938f1ab252c7df86fb663b9de757af41a/packages/cli/install-legacy.sh bash
# Windows (PowerShell)
$env:VP_PR_VERSION="2740"; $env:VP_LEGACY_INSTALLER_URL="https://raw.githubusercontent.com/voidzero-dev/vite-plus/ededdac938f1ab252c7df86fb663b9de757af41a/packages/cli/install-legacy.ps1"; irm https://raw.githubusercontent.com/voidzero-dev/vite-plus/ededdac938f1ab252c7df86fb663b9de757af41a/packages/cli/install.ps1 | iex

Or download the standalone Windows installer built from this commit:

Architecture Installer
x64 vp-setup-x86_64-pc-windows-msvc.exe
Arm64 vp-setup-aarch64-pc-windows-msvc.exe

GitHub requires you to sign in and downloads each installer as a ZIP artifact. Extract vp-setup.exe, then run it against this preview build:

.\vp-setup.exe --version "0.0.0-commit.ededdac938f1ab252c7df86fb663b9de757af41a" --registry "https://registry-bridge.viteplus.dev/"

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.ededdac938f1ab252c7df86fb663b9de757af41a",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.ededdac938f1ab252c7df86fb663b9de757af41a"
  }
}

@github-actions

Copy link
Copy Markdown
Contributor

🐳 Docker preview image

Built from this PR's registry bridge build:

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

Quick check:

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

See docs/guide/docker.md for usage.

@fengmk2 fengmk2 added preview-build Publish this PR's commits to the registry bridge as preview builds and removed preview-build Publish this PR's commits to the registry bridge as preview builds labels Sep 24, 2026
@fengmk2
fengmk2 force-pushed the rfc/official-homebrew-tap branch from fb236d0 to 90ff9f0 Compare September 24, 2026 02:55
@fengmk2 fengmk2 added preview-build Publish this PR's commits to the registry bridge as preview builds and removed preview-build Publish this PR's commits to the registry bridge as preview builds labels Sep 24, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

preview-build Publish this PR's commits to the registry bridge as preview builds

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant