You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
pnpm install + pnpm dev fails out of the box on Linux (esbuild + lightningcss) #394
A freshly scaffolded TanStack Start project fails immediately with two consecutive
errors when using pnpm on Linux. No modifications were made to the project.
Your Example Website or App
Fresh scaffold via: pnpm create @tanstack/start@latest No modifications made. Reproducible on any Linux x64 machine with pnpm.
Steps to Reproduce the Bug or Issue
pnpm create @tanstack/start@latest
cd
pnpm install
pnpm dev
Expected behavior
The dev server starts successfully after a fresh install.
Screenshots or Videos
No response
Platform
OS: Linux x64 (Ubuntu)
Node: v22.22.0
pnpm: v10.30.1
@tanstack/react-start: 1.162.4
Additional context
Two errors occur in sequence:
Error 1 — esbuild postinstall fails:
The scaffold pins esbuild@0.27.3 directly in dependencies. This version has a
broken postinstall script that fails with:
Error: Expected "0.27.3" but got ""
Error 2 — lightningcss native binary missing (after removing esbuild from
dependencies):
pnpm's strict symlinking means lightningcss-linux-x64-gnu binary never gets
linked into lightningcss's node/ directory:
Error: Cannot find module '../lightningcss.linux-x64-gnu.node'
Workaround: using npm install instead of pnpm works without issues.
This was addressed in commit 16fcd67 (fix(create): preserve pnpm build approvals across add-ons) on February 28. esbuild is no longer pinned in dependencies and esbuild + lightningcss are listed under pnpm.onlyBuiltDependencies in the base templates so pnpm runs their install scripts. The fix is on main and just waiting on a release.
Activity
tannerlinsley commentedon Apr 27, 2026
This was addressed in commit 16fcd67 (
fix(create): preserve pnpm build approvals across add-ons) on February 28.esbuildis no longer pinned independenciesandesbuild+lightningcssare listed underpnpm.onlyBuiltDependenciesin the base templates so pnpm runs their install scripts. The fix is onmainand just waiting on a release.Generated by Claude Code