LAN Dev QR

Local-only helper for opening your laptop’s Vite/dev server on a phone over Wi‑Fi — without typing the LAN IP by hand.

1. Run this app on your laptop
2. It probes common local HTTP ports
3. You pick a server and scan the QR code from your phone

Not a hosted product. It must run on the same machine as your other npm run dev servers so it can probe 127.0.0.1.

Quick start

git clone https://github.com/LiformaLtd/lan-dev-qr.git
cd lan-dev-qr
npm install
npm run dev

Open http://localhost:3999.

Or after a build:

npm run build
npm start

Liforma embeds

If the phone page embeds a Liforma experience, add an allowed origin in the developer portal first, for example:

• Exact: http://192.168.0.20:5173
• LAN /24 wildcard: http://192.168.0.*:5173 (also 10.x.y.* and 172.16–31.x.*)

The Origin header is the host in the phone’s address bar (http://<lan-ip>:<port>), not localhost.

How it works

• Discovers this machine’s LAN IPv4 addresses (os.networkInterfaces)
• Probes common ports (5173–5180, 3000–3012, 4000–4010, 4173, 8080)
• Builds http://<lan-ip>:<port> QR codes for scanning on the same network

Scripts

Command	Description
npm run dev	Dev server on port 3999
npm run build	Production Node build
npm start	Run the built Node server
npm run check	Typecheck

License

MIT