Skip to content

Visualize Your Ideas With Code

docs: add warning for Vite not watching files in WSL2 (#224)

michaelharlow8c308e9fa259
diff --git a/packages/docs/docs/getting-started/quickstart.mdx b/packages/docs/docs/getting-started/quickstart.mdx
index fbdb13f1..16269703 100644
--- a/packages/docs/docs/getting-started/quickstart.mdx
+++ b/packages/docs/docs/getting-started/quickstart.mdx
@@ -75,7 +75,20 @@ file with the following snippet.
</CodeBlock>
Now save the file. Any changes you make are automatically picked up and
-reflected in the preview. You should see a gray circle in the preview pane at
+reflected in the preview.
+
+:::caution Vite on Windows Subsystem for Linux (WSL) 2
+
+When running Vite on WSL2, file system watching does not work if a file is edited by Windows applications.
+
+To fix this, move the project folder into the WSL2 file system and use WSL2 applications to edit files.
+Accessing the Windows file system from WSL2 is slow, so this will improve performance.
+
+For more information view the [**Vite Docs**](https://vitejs.dev/config/server-options.html#server-watch).
+
+:::
+
+You should see a gray circle in the preview pane at
the top right of the web application. Press the play button to see the circle
animate across the screen.