Getting started
Installation
Install ShareLive, expose localhost to the internet, and keep the dashboard ready for branded subdomains when your app is deployed.
Default installation
Start with the CLI. The fastest path is npx sharelive, but you can also install the command globally if you use it every day.
npx sharelive --port 3000Best for one-off sessions and quick sharing from a fresh machine.
Authentication
Login once to associate tunnels with your account and unlock stable named URLs for recurring demos, QA, and webhook testing.
npx sharelive loginYour token is stored locally so future sessions can request account-linked tunnels.
Tunnel localhost
Use ShareLive when the app is still on your machine but the URL needs to be public. This is the main ShareLive workflow now.
Local previews
Share work-in-progress apps before they are deployed anywhere.
Webhook testing
Point external services at a live endpoint while you keep the server local.
Faster reviews
Give teammates and clients a real URL instead of waiting for another deploy cycle.
Named URLs
Stable names make the tunnel easier to remember and better suited for recurring usage like stakeholder demos or callback endpoints.
npx sharelive --port 3000 --name sprint-demoShareLive will try to reserve the requested public URL for your session.
Debugging
Turn on verbose logging when you want to watch requests flow through the tunnel while debugging integrations or local APIs.
npx sharelive --port 3000 --verboseUseful when tracing incoming webhook requests or checking that the right path reaches your local service.
Subdomains
Subdomains are the second ShareLive workflow. Use them when your app is already deployed and you want a clean branded URL managed from the dashboard.
Free proxy mode
Connect the target URL quickly and start routing traffic without DNS friction.
Direct DNS later
Upgrade when you want a more direct browser-to-host path and platform-level domain ownership.
Dashboard routing
The dashboard remains the home for project routing, analytics, upgrade paths, and managed subdomain setup once the app is deployed.
Recommended split
Start with tunnels when the app is local. Move to subdomains when the app is deployed. ShareLive supports both, but the homepage and docs now lead with the tunnel workflow first.
Command reference
These are the commands most developers use every day with ShareLive.
npx sharelive --port 3000