Sharing with one person

Name who may open the app with --to. That address gets an invite email when the share starts, and nobody else can get in. The link itself carries no secret.

$ purlview share 3000 --to ana@example.com
✓ Sharing localhost:3000
✓ Invite sent to ana@example.com

https://k7m2p4qx.purlview.link/

The invite

The email says who invited them and has one button, Open app. Pressing it opens a page that says Your link is ready; its Open app button opens your app. The invite works once and lasts as long as the share.

The request page

If they lost the email or are on another device, send them the link itself. It opens a page that says You're invited to try an app and asks for their email. An address you named gets a new email with a link that works once, for 5 minutes; every address sees the same Check your inbox page, so the page reveals nothing about who was named.

Several people

Repeat --to for each person, up to 10. The flag's own words: Let in only this email address; repeat for several. Each address is sent an invite.

✓ Invites sent to ana@example.com and raj@example.com

Access   Only ana@example.com and raj@example.com

If an invite cannot be sent, the share still starts and the terminal says so:

! Invite not sent to raj@example.com — send them the link yourself

Print the link of a running share with purlview link k7m2p4qx; purlview list never shows links, so it is safe on a shared screen.