feat: add Linux musl target support by fengmk2 · Pull Request #995 · voidzero-dev/vite-plus

fengmk2 · 2026-03-17T13:51:24Z

Summary

Add build, publish, and CI support for Linux musl targets (x86_64-unknown-linux-musl and aarch64-unknown-linux-musl), enabling vite-plus to run in Alpine/musl-based Docker containers.

Add musl NAPI binding targets to package.json and release workflow
Cross-compile musl binaries using cargo-zigbuild (napi-cross only supports gnu)
Download musl Node.js from unofficial-builds.nodejs.org (official nodejs.org only provides glibc)
Add test-musl CI job running cargo check/test in Alpine container
Add cli-e2e-test-musl CI job with snap tests in Alpine Docker
Add musl standalone install tests (test-standalone-install.yml)
Add libc filter support to snap test ignoredPlatforms (e.g. { "os": "linux", "libc": "musl" })
Replace cat FILE && exit 1 || true with portable test ! -f FILE in snap tests
Add platform support documentation to getting started guide

Test plan

cargo test -p vite_global_cli — registry test includes musl
test-musl job — cargo check + test in Alpine container
cli-e2e-test-musl job — full E2E with snap tests in Alpine Docker
test-standalone-install.yml — musl x64 + arm64 install tests
Release workflow builds 8 targets (6 existing + 2 musl)

Closes #992

fengmk2 · 2026-03-17T13:51:38Z

feat: add Linux musl target support #995 👈 (View in Graphite)
feat(env): use trampoline exe instead of .cmd wrappers on Windows #981 : 1 other dependent PR (#1005 )
test: skip flaky snap tests on macOS and win32 #1022
main

How to use the Graphite Merge Queue

Add the label auto-merge to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

_{An organization admin has enabled the Graphite Merge Queue in this repository.} _{Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.}

This stack of pull requests is managed by Graphite. Learn more about stacking.

docs/guide/index.md

Brooooooklyn · 2026-03-18T02:29:02Z

@fengmk2 should also add musl target cargo tests and cli e2e tests

…l E2E

… tmp dir

Published vite-plus 0.1.13 doesn't include musl NAPI bindings yet. Skip tests that depend on the npm-published package on musl targets: - migration tests that install vite-plus@latest - command-pack-exe (uses tsdown which loads rolldown binding) - command-upgrade-check Remove debug steps from CI now that root cause is identified.

The snap test runner passes CI through to subprocesses, and vp commands may behave differently in CI mode.

Alpine's cat outputs "can't open" while GNU cat outputs "No such file or directory". Use test ! -f which is portable and produces no output.

- Replace cat FILE checks with test ! -f in remaining snap tests: command-init-inline-config-existing, migration-existing-lint-staged-config, migration-eslint-lintstagedrc, create-missing-typecheck - Skip command-dlx-npm10 on musl

In CI environments (especially Docker containers), the log file path is not accessible to the user. Print the log contents directly when CI=true.

Pass CI=true so install.sh prints log contents on failure instead of pointing to a file. Use bash -x for full debug trace output.

The error() function calls exit 1 internally, so the cat of the install log was never reached. Use echo directly with the CI check before exiting.

…released The published vp binary (alpha) downloads glibc Node.js from nodejs.org. The musl fix (unofficial-builds.nodejs.org) is in this PR but not yet released. These tests will work after the first musl-enabled release.

The unofficial-builds Node.js musl binary dynamically links to libstdc++.so.6 and libgcc_s.so.1 (uses musl libc but GNU C++ runtime). Install libstdc++ in Alpine containers for the musl install tests.

.github/workflows/test-standalone-install.yml

install.sh runs in a bash subprocess; its .profile changes don't propagate back to the outer sh -c shell. Use export PATH directly.

QEMU user-mode emulation doesn't support all syscalls needed by rolldown/tsdown (ENOSYS error 38), same as the glibc ARM64 job.

fengmk2 self-assigned this Mar 17, 2026

fengmk2 mentioned this pull request Mar 17, 2026

feat(env): use trampoline exe instead of .cmd wrappers on Windows #981

Merged

33 tasks

fengmk2 force-pushed the support-musl branch from df968a6 to 4ff7810 Compare March 17, 2026 15:05

fengmk2 force-pushed the trampoline-exe-for-shims branch 2 times, most recently from 475016b to 45e4691 Compare March 17, 2026 15:16

fengmk2 force-pushed the support-musl branch from 4ff7810 to 05d77f6 Compare March 17, 2026 15:16

fengmk2 mentioned this pull request Mar 18, 2026

feat(install): add bun as a package manager (#557) #1005

Draft

fengmk2 force-pushed the trampoline-exe-for-shims branch from 45e4691 to bc38b7a Compare March 18, 2026 01:50

fengmk2 force-pushed the support-musl branch from 05d77f6 to b18cfb5 Compare March 18, 2026 01:50

fengmk2 marked this pull request as ready for review March 18, 2026 01:51

fengmk2 requested a review from Brooooooklyn March 18, 2026 01:51

fengmk2 force-pushed the trampoline-exe-for-shims branch from bc38b7a to 810d51c Compare March 18, 2026 02:16

fengmk2 force-pushed the support-musl branch from 58ec409 to 38284bb Compare March 18, 2026 02:16

fengmk2 commented Mar 18, 2026

View reviewed changes

docs/guide/index.md Show resolved Hide resolved

fengmk2 force-pushed the support-musl branch from 38284bb to 86db067 Compare March 18, 2026 02:28

fengmk2 force-pushed the trampoline-exe-for-shims branch from 810d51c to efc5c42 Compare March 18, 2026 02:28

fengmk2 force-pushed the support-musl branch 2 times, most recently from c63425a to 7ffe689 Compare March 18, 2026 03:51

fengmk2 force-pushed the trampoline-exe-for-shims branch from efc5c42 to d143fc6 Compare March 18, 2026 03:51

fengmk2 force-pushed the support-musl branch from 7ffe689 to b8dff2e Compare March 18, 2026 04:01

fengmk2 force-pushed the trampoline-exe-for-shims branch 2 times, most recently from 9db93c2 to cc73dcc Compare March 18, 2026 06:05

fengmk2 force-pushed the support-musl branch 2 times, most recently from e49456f to 2572e70 Compare March 18, 2026 06:08

fengmk2 force-pushed the trampoline-exe-for-shims branch from cc73dcc to 000f043 Compare March 18, 2026 06:08

fengmk2 force-pushed the support-musl branch from 2572e70 to 6ea20b1 Compare March 18, 2026 06:15

fengmk2 force-pushed the trampoline-exe-for-shims branch from 000f043 to 00ae674 Compare March 18, 2026 06:15

fengmk2 force-pushed the support-musl branch from 6ea20b1 to f88606f Compare March 18, 2026 06:49

fengmk2 and others added 14 commits March 24, 2026 14:06

debug(ci): isolate migration-auto-create-vite-config snap test in mus…

1e0d0d5

…l E2E

debug(ci): run migration-auto-create-vite-config commands directly in…

5870384

… tmp dir

fix(ci): pass CI=true to Alpine Docker container for musl E2E

7986818

The snap test runner passes CI through to subprocesses, and vp commands may behave differently in CI mode.

fix: use test -f instead of cat for file existence checks in snap tests

4160a8e

Alpine's cat outputs "can't open" while GNU cat outputs "No such file or directory". Use test ! -f which is portable and produces no output.

fix(ci): rename Test (musl) to Test (Linux x64 musl)

e9b86fc

fix: use test -f in command-init-inline-config snap test

ddb38dc

fix(ci): use git diff --quiet to avoid duplicate diff output in musl E2E

69b6e0d

fix: skip create-missing-typecheck snap test on musl

8b52410

fix(ci): remove dangling run job reference from done gate

6cdc468

fix(ci): remove redundant cargo check from test-musl job to save CI time

686e778

ci: allow retry the failed native package publishing

600704d

simplify publish native addons script

31a82b5

fengmk2 force-pushed the support-musl branch from 0ff9227 to 31a82b5 Compare March 24, 2026 06:07

fengmk2 added 5 commits March 24, 2026 14:29

fix: print install log directly in CI instead of pointing to file

af835cc

In CI environments (especially Docker containers), the log file path is not accessible to the user. Print the log contents directly when CI=true.

debug(ci): add bash -x and CI=true to musl standalone install tests

56feff9

Pass CI=true so install.sh prints log contents on failure instead of pointing to a file. Use bash -x for full debug trace output.

fix: avoid error() function exit before printing install log in CI

7e91b2e

The error() function calls exit 1 internally, so the cat of the install log was never reached. Use echo directly with the CI check before exiting.

fix(ci): re-enable musl install tests with libstdc++ dependency

a085027

The unofficial-builds Node.js musl binary dynamically links to libstdc++.so.6 and libgcc_s.so.1 (uses musl libc but GNU C++ runtime). Install libstdc++ in Alpine containers for the musl install tests.

fengmk2 commented Mar 24, 2026

View reviewed changes

.github/workflows/test-standalone-install.yml Show resolved Hide resolved

fengmk2 added 7 commits March 24, 2026 15:09

fix(ci): use direct PATH export in musl install tests instead of source

69234de

install.sh runs in a bash subprocess; its .profile changes don't propagate back to the outer sh -c shell. Use export PATH directly.

feat(ci): add create and build test to musl x64 standalone install

fa90e0e

feat(ci): add create and build test to musl arm64 standalone install

b8cc217

docs: add libstdc++ requirement for Alpine/musl platforms

56f0dee

fix(docs): remove --no-cache flag from apk add example

75ecabb

fix(ci): comment out create test in ARM64 musl QEMU job

79c4653

QEMU user-mode emulation doesn't support all syscalls needed by rolldown/tsdown (ENOSYS error 38), same as the glibc ARM64 job.

fix(ci): skip flaky test_verify_file_hash_sha1 in musl test job

76dbdd5

fengmk2 merged commit 1462953 into main Mar 24, 2026
36 checks passed

fengmk2 deleted the support-musl branch March 24, 2026 09:46

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add Linux musl target support#995

feat: add Linux musl target support#995
fengmk2 merged 62 commits intomainfrom
support-musl

fengmk2 commented Mar 17, 2026 •

edited

Loading

Uh oh!

fengmk2 commented Mar 17, 2026 •

edited

Loading

Uh oh!

Uh oh!

Brooooooklyn commented Mar 18, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

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

Uh oh!

Summary

Test plan

Uh oh!

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

Uh oh!

How to use the Graphite Merge Queue

Uh oh!

Uh oh!

Brooooooklyn commented Mar 18, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

fengmk2 commented Mar 17, 2026 •

edited

Loading

fengmk2 commented Mar 17, 2026 •

edited

Loading