Dev Mode · Tagviu Docs

Architecture

How Dev Mode connects

Production Tagviu blocks localhost and private addresses on /api/inspect (SSRF protection). Dev Mode keeps that rule intact: your laptop fetches the page; Tagviu only receives the HTML.

Request flow

Dashboard → create Dev Environment
        │
tagviu login <secret>
        │ (pairs this machine once)
        ▼
CLI stores { secret } locally
        │
tagviu http://localhost:3000
        │ 1. CLI fetches localhost on your machine
        │ 2. CLI submits the HTML to Tagviu
        ▼
Tagviu inspects the HTML
        → ephemeral /local-preview/lp_… (1 hour)

Pairing (not passwords)

Copy the environment secret from Dashboard → Developer → View and run tagviu login <secret>.
One environment binds to one machine until you disconnect it in the dashboard or run tagviu logout.
Credentials file holds only the secret (~/.config/tagviu/credentials.json on Linux).

Logout vs disconnect

tagviu logout: Unbinds the machine on the server, then clears the local credentials file.
Dashboard → Disconnect: Clears the server binding so another machine can pair that environment.

Loopback only in v1: localhost, 127.0.0.1, ::1. Not a LAN proxy. Previews expire after one hour (rate-limited per environment).