From 77012666e6aff1842f1a7ff6e695cd0e534014a7 Mon Sep 17 00:00:00 2001 From: TERR-inss Date: Sat, 21 Feb 2026 15:51:54 -0500 Subject: [PATCH 1/2] provide additional info to help users set up for frontend dev environment --- doc/installing-from-source.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/installing-from-source.md b/doc/installing-from-source.md index c67865ba..60af1062 100644 --- a/doc/installing-from-source.md +++ b/doc/installing-from-source.md @@ -47,6 +47,20 @@ API_TARGET=http://192.168.1.1:8080 npm run dev The UI will listen on `localhost:5173` and instantly show any frontend changes you make. Backend changes require building everything from the top (daemon and installer). +You may need to turn off your VPN in order to load the frontend succesfully. Even with local network sharing enabled, VPNs may 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 developer have success using polling to detect changes, by specifying the following setting in vite.config.ts. +```ts +server: { + watch: { usePolling: true } +} +``` + ## Installer utils, getting a shell Check `./scripts/install-dev.sh util --help` From 4c9dd8d38dc9a4c1dd101a7e59f736561e2e5f92 Mon Sep 17 00:00:00 2001 From: TERR-inss Date: Sat, 21 Feb 2026 16:02:02 -0500 Subject: [PATCH 2/2] add bullet points, minor grammatical changes --- doc/installing-from-source.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/installing-from-source.md b/doc/installing-from-source.md index 60af1062..1f55cb35 100644 --- a/doc/installing-from-source.md +++ b/doc/installing-from-source.md @@ -47,14 +47,14 @@ API_TARGET=http://192.168.1.1:8080 npm run dev The UI will listen on `localhost:5173` and instantly show any frontend changes you make. Backend changes require building everything from the top (daemon and installer). -You may need to turn off your VPN in order to load the frontend succesfully. Even with local network sharing enabled, VPNs may interfere with the connection to the backend. +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. +- 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 developer have success using polling to detect changes, by specifying the following setting in vite.config.ts. +- 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 }