From 542beaa0fcf335eb829e94b8831041bda36f44d0 Mon Sep 17 00:00:00 2001 From: Jan Koprowski Date: Sat, 18 Jul 2026 10:01:17 +0000 Subject: [PATCH 1/4] Mention about WSL 2 setup in Windows section. --- docs/en/tutorial/tutorial-0.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/en/tutorial/tutorial-0.md b/docs/en/tutorial/tutorial-0.md index c486f557..021c28b9 100644 --- a/docs/en/tutorial/tutorial-0.md +++ b/docs/en/tutorial/tutorial-0.md @@ -103,6 +103,21 @@ Building BeeWare apps on Windows requires: After installing these tools, you should ensure you restart any terminal sessions. Windows will only expose newly installed tools terminals started *after* the install has completed. +/// admonition | WSL 2 + +If you are using WSL, just follow the Linux instructions for your distribution. +To work with GUI projects or the emulator, open the `C:\Users\%USERNAME%\.wslconfig` file and make sure that: + +```ini +[wsl2] +guiApplications=true +``` + +is set to true. Afterward, shut down WSL using `wsl --shutdown` in the Windows command prompt and restart it. +This instruction requires WSL 2 version. + +/// + /// ## Set up a virtual environment From a357ca19df5b0fc2f276db8e09de21a3d88aab47 Mon Sep 17 00:00:00 2001 From: Jan Koprowski Date: Sat, 18 Jul 2026 10:11:50 +0000 Subject: [PATCH 2/4] Trim trailing whitespace. --- docs/en/tutorial/tutorial-0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/tutorial/tutorial-0.md b/docs/en/tutorial/tutorial-0.md index 021c28b9..3521d381 100644 --- a/docs/en/tutorial/tutorial-0.md +++ b/docs/en/tutorial/tutorial-0.md @@ -103,7 +103,7 @@ Building BeeWare apps on Windows requires: After installing these tools, you should ensure you restart any terminal sessions. Windows will only expose newly installed tools terminals started *after* the install has completed. -/// admonition | WSL 2 +/// admonition | WSL 2 If you are using WSL, just follow the Linux instructions for your distribution. To work with GUI projects or the emulator, open the `C:\Users\%USERNAME%\.wslconfig` file and make sure that: From fca3ce4e8e99450e4262c65068f28925f0943b76 Mon Sep 17 00:00:00 2001 From: Jan Koprowski Date: Sat, 18 Jul 2026 11:47:33 +0000 Subject: [PATCH 3/4] Add WSL word to spelling wordlist. --- docs/spelling_wordlist | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist index 431c3787..1103cdca 100644 --- a/docs/spelling_wordlist +++ b/docs/spelling_wordlist @@ -84,4 +84,5 @@ UI uv verbing Weblate +WSL Xcode From 403d5017e59704c6e527a7ddf7ac37d45c9e28e0 Mon Sep 17 00:00:00 2001 From: Malcolm Smith Date: Sat, 18 Jul 2026 13:12:07 +0100 Subject: [PATCH 4/4] Minor cleanups --- docs/en/tutorial/tutorial-0.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/en/tutorial/tutorial-0.md b/docs/en/tutorial/tutorial-0.md index 3521d381..f0623624 100644 --- a/docs/en/tutorial/tutorial-0.md +++ b/docs/en/tutorial/tutorial-0.md @@ -105,16 +105,15 @@ After installing these tools, you should ensure you restart any terminal session /// admonition | WSL 2 -If you are using WSL, just follow the Linux instructions for your distribution. -To work with GUI projects or the emulator, open the `C:\Users\%USERNAME%\.wslconfig` file and make sure that: +If you are using WSL 2, just follow the Linux instructions for your distribution. +To work with GUI projects or the Android emulator, open the `C:\Users\%USERNAME%\.wslconfig` file and make sure that: ```ini [wsl2] guiApplications=true ``` -is set to true. Afterward, shut down WSL using `wsl --shutdown` in the Windows command prompt and restart it. -This instruction requires WSL 2 version. +is set to true. Afterward, shut down WSL using `wsl --shutdown` in the Windows command prompt and restart it. ///