From 2c47fbf687636d5afa5fe7e272592a8c191a1a01 Mon Sep 17 00:00:00 2001
From: Divya Rathod <155083420+divyarathodgit@users.noreply.github.com>
Date: Tue, 10 Mar 2026 14:32:41 +0530
Subject: [PATCH] docs: add GUI support warning for WSL users using neu run

Added information for WSL users regarding GUI support when running neu CLI.
---
 docs/cli/neu-cli.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/cli/neu-cli.md b/docs/cli/neu-cli.md
index d753705c..2f677244 100644
--- a/docs/cli/neu-cli.md
+++ b/docs/cli/neu-cli.md
@@ -67,6 +67,9 @@ development evironment at the same time. This option patches the main HTML file
 client library global variables to expose the native API to the frontend library's development server.
 Learn how to setup this feature from [this](../getting-started/using-frontend-libraries.md) guide.
 
+:::info WSL Users
+If you are using Windows Subsystem for Linux (WSL), ensure you have GUI support (WSLg) enabled. Running `neu run` without a display server configured will result in an application crash or `error code 1`.
+:::
 #### Options
 - `--disable-auto-reload`: Disables the auto-reloading feature.
 - `--arch=<arch>`: Explicitly set the CPU architecture. This option is helpful if you use a 32-bit Node.js process