From 512cf784a740bc0ef85d61c850d273a0507d46d6 Mon Sep 17 00:00:00 2001
From: Terence <89863790+TERR-inss@users.noreply.github.com>
Date: Wed, 25 Mar 2026 15:09:24 -0400
Subject: [PATCH] provide additional info to help users set up for frontend dev
 environment (#917)

---
 doc/installing-from-source.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/installing-from-source.md b/doc/installing-from-source.md
index c67865b..4a2f95c 100644
--- a/doc/installing-from-source.md
+++ b/doc/installing-from-source.md
@@ -76,3 +76,19 @@ Note though that we can't assist with any issues setting ADB up, _especially
 not_ on Windows. There have been too many driver issues to make this the
 "golden path" for most users or contributors. There have been instances where
 people managed to brick their orbic devices using ADB on Windows.
+
+## Troubleshooting
+
+You may need to turn off your VPN in order to load the frontend succesfully - even with local network sharing enabled, VPNs can interfere with the connection to the backend.
+
+Specifically for WSL users:
+
+- The HyperV firewall also tends to interfere with the connection between frontend and backend. You can turn it off in your WSL settings.
+
+- WSL2 has a known compatibility issue which may prevent vite from detecting file system changes and therefore affects HMR (hot module replacement).
+If your hot reloading does not work, some have success using polling to detect changes. To do so, specify the following setting in vite.config.ts:
+```ts
+server: {
+    watch: { usePolling: true }
+}
+```
\ No newline at end of file