microsoft / microsoft/rayfin

esbuild.exe blocked by Windows security policy — no actionable error message

Open
#27 0 comments 0 reactions 1 assignee View on GitHub

@mksuni is already working on this.

Since Jun 11, 2026.

bug issue-mapped triaged
Dominant language
No language data
Stars
610
Forks
62
Avg merge
1d 23h
Merged PRs (30d)
3

Description

Context

Split from https://github.com/microsoft/rayfin/issues/24 (sub-issue 1 of 4).

Problem

When scaffolding on Windows, esbuild.exe is blocked by local security policy with no clear error message guiding the user to a workaround. Switching to WSL resolves the issue immediately.

Expected Behavior

The CLI should detect when esbuild.exe fails to execute due to a policy block and surface a user-friendly error message with suggested workarounds (e.g., use WSL, unblock the binary via PowerShell Unblock-File, or adjust execution policy).

Suggested Fix

  • Catch the specific error from esbuild.exe execution failure
  • Display a clear message: "esbuild.exe was blocked by your system's security policy. Try running in WSL, or unblock the file with Unblock-File"
  • Add a note in the Getting Started docs about this Windows-specific issue

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.