wiki: document dev environment (WSL networking, workflow)
Capture hard-won dev knowledge that was only in commit messages: - wsl-dev-networking: WSL2 NAT blocks UDP broadcast (device discovery can't reach the LAN); fix is mirrored networking (.wslconfig, Win11 22H2+), plus the gotchas that remained after — multiple interfaces, subnet-directed broadcast, localhost->IPv6 stall. Alternatives for non-mirrored setups. - local-dev-workflow: first-time setup, pnpm dev, and the gotchas (the strip-types dev-server hang -> tsx, the 127.0.0.1 proxy fix, .env loading, seeding into the right DB). - device-discovery: corrected the old "broadcast permission (EACCES)" note — the real cause was the lib not enabling SO_BROADCAST for global 255.255.255.255; documented the three verified broadcast gotchas + I/O serialization. - schema: add a `reference` page type; new "Dev environment" index section; log. Links lint clean; both new pages well-connected.
This commit is contained in:
+11
@@ -83,3 +83,14 @@ admins. Same-origin via the Vite dev proxy and a new prod nginx config
|
||||
(deploy/nginx.conf). Verified end to end (curl + browser): wrong pass→401,
|
||||
login→cookies set, me→admin, assign without CSRF→403 / with→201, no cookie→401,
|
||||
session persists across reload. Updated [[local-jwt-auth]].
|
||||
|
||||
## [2026-06-15] lint+docs | Dev-environment pages (WSL networking, workflow)
|
||||
Captured hard-won dev knowledge that was only in commit messages: new
|
||||
[[wsl-dev-networking]] (WSL2 NAT blocks UDP broadcast → mirrored mode + the
|
||||
multi-interface / subnet-broadcast / IPv6-localhost gotchas that remained) and
|
||||
[[local-dev-workflow]] (setup, seed:admin, the dev-server-hang from the broken
|
||||
strip-types script → tsx, the 127.0.0.1 proxy fix, .env loading). Corrected the
|
||||
earlier "broadcast permission (EACCES)" note in [[device-discovery]] — the real
|
||||
cause was the lib not enabling SO_BROADCAST for the global 255.255.255.255;
|
||||
documented the three verified broadcast gotchas + serialization. Added a `reference`
|
||||
page type to the schema; new "Dev environment" index section.
|
||||
|
||||
Reference in New Issue
Block a user