CLI interactive prompts lose keyboard focus on Windows

[codayon]

Have you read the Contributing Guidelines on issues?

• I have read the Contributing Guidelines on issues.

Prerequisites

• I'm using the latest version of Docusaurus.
• I have tried the npm run clear or yarn clear command.
• I have tried rm -rf node_modules yarn.lock package-lock.json and re-installing packages.
• I have tried creating a repro with https://new.docusaurus.io.
• I have read the console error message carefully (if applicable).

Description

When initializing a new Docusaurus project using pnpm create docusaurus or npm init docusaurus on Windows, the interactive prompts (specifically the language selection) appear to freeze. Keyboard input (arrow keys) is ignored until the user presses Enter once.

Outdated Information (Click to expand)

Gemini says, this is what causing the issue, for something called "race condition":

const [templates, siteName] = await Promise.all([
  readTemplates(),
  getSiteName(reqName, rootDir),
]);

L527-L530

Reproducible demo

No response

Steps to reproduce

1. Run pnpm create docusaurus on a Windows machine.
2. Provide a site name.
3. Select template classic
4. Face the issue

Expected behavior

To be able to create a project without interruption

Actual behavior

Prompts lose keyboard focus until pressed Enter

Your environment

• Docusaurus version used: 3.9.2
• Environment name and version: Node.js 24
• Operating system and version: Windows 11 25H2
• Shell: PowerShell 7 and Git Bash

Self-service

• I'd be willing to fix this bug myself.

[dear-asutosh]

I was able to reproduce this issue on Windows 11.

The problem appears to be concurrent stdin access caused by running
readTemplates() and getSiteName() in parallel via Promise.all().

I tested a fix that runs these steps sequentially. Since
readTemplates() is fast relative to user input, this avoids the
Windows terminal focus issue without any noticeable performance impact.

I’m preparing a PR with this fix.

[codayon]

#11652 (comment)

[slorber]

Can you please record a video of the problem to help understand it better?

[codayon]

Can you please record a video of the problem to help understand it better?

Here, https://youtu.be/LHoN3BdFVBc

This is from another PC. Currently, I'm not on Windows.

[codayon]

By the way, I'm not sure if it matters but, I use fnm to install node and corepack for pnpm.

[slorber]

I see, thanks for the video.
And you can only reproduce this on Windows/PowerShell, or are you able to reproduce in other environemnts as well?

[codayon]

And you can only reproduce this on Windows/PowerShell, or are you able to reproduce in other environemnts as well?

This issue can be reproduced on both Git Bash (MinGW64) and PowerShell. I wasn't able to reproduce this on Linux.

[Gourav2580]

/assign

[Gourav2580]

please assign this issue i want work on it

[codayon]

please assign this issue i want work on it

you can try solving the issue by yourself, or comment the solution for now

[Gourav2580]

ok, i'll try to solve this problem myself