css.TailwindCSS fails to build when @tailwindcss/cli is installed with pnpm

[blaflamme]

What version of Hugo are you using (hugo version)?

$ hugo version
hugo v0.161.1+extended+withdeploy darwin/arm64 BuildDate=2026-04-29T13:56:01Z VendorInfo=Homebrew

Does this issue reproduce with the latest release?

Yes

Problem

This issue is not present when you install @tailwindcss/cli with npm because a node script is installed under node_modules/.bin/ but pnpm instead installs a shell wrapper script, then it fails and return this error TAILWINDCSS: failed to transform "/css/main.css" (text/css): binary "tailwindcss" is not a Node.js script.

Also I've only tested this on MacOS.

[blaflamme]

@bep I found that I can change pnpm behaviour to ensure scripts are not wrapped, then it works, so I think a change is not needed in Hugo base code but in the docs about Tailwind and this possible issue.

pnpm settings or add prefer-symlinked-executables=true in a .npmrc file.

[bep]

@blaflamme I have a Claude-implemented fix in #14856 -- if that fix is reasonably simple and passes on all Oses (which I doubt), I'll merge it. Avoiding future noise/questions from others in the same situation would have some value.